From aaedf2a02074632ee93df387c93e328b14e256fd Mon Sep 17 00:00:00 2001 From: uduki Date: Wed, 28 Oct 2026 10:37:09 +0900 Subject: [PATCH] =?UTF-8?q?chore:=20=E3=83=AF=E3=83=BC=E3=82=AF=E3=82=B9?= =?UTF-8?q?=E3=83=9A=E3=83=BC=E3=82=B9=E9=81=8B=E7=94=A8=E8=A6=8F=E5=89=87?= =?UTF-8?q?=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB=EF=BC=88GEMINI.md=20/=20AG?= =?UTF-8?q?ENTS.md=EF=BC=89=E3=82=92=E7=AD=96=E5=AE=9A=E3=83=BB=E9=85=8D?= =?UTF-8?q?=E5=82=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ GEMINI.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 132 insertions(+) create mode 100644 AGENTS.md create mode 100644 GEMINI.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..4e0fb7e --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,66 @@ +# FF14 攻略Wiki ワークスペース運用規則 + +本ワークスペース(`z:\FF14攻略`)におけるすべての作業およびAIエージェントの自律動作において、本規則を常に最優先で遵守してください。 + +--- + +## 1. プロジェクト方針&Wiki構造の維持 + +本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。 + +### 1.1 ポータルページ(`index.html`)の常時最新化 +- **新規ページ追加時の必須タスク**: + - 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。 + - カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。 + - ヘッダーの収録統計(ガイド本数など)を更新してください。 +- **既存ページ更新時の同期**: + - ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。 + +### 1.2 全ページ共通ナビゲーションバーの設置 +- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。 +- 共通ナビゲーションバーには以下を含めてください: + - ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」) + - 各主要攻略ページへのクイックリンク + - 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト +- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `` 内に含めてください。 + +### 1.3 HTMLデザイン・クオリティ基準 +- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。 +- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。 +- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。 + +--- + +## 2. Gitバージョン管理&自動コミット運用規則 + +ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。 + +### 2.1 コミットのタイミング +- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 +- 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。 + +### 2.2 コミットメッセージの記法 +- コミットメッセージは**分かりやすい日本語**で記述してください。 +- プレフィックスを付与して変更種別を明示してください: + - `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加 + - `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正 + - `docs: `: 既存ガイドの解説追記、ポータルの説明文修正 + - `style: `: レイアウト調整、CSSデザインの改善 + - `refactor: `: HTML/CSS/JSコードのリファクタリング + - `chore: `: 設定ファイルや運用規則の変更 + +### 2.3 コミットの実行手順 +1. 作業完了後、`git status` および `git diff` で変更内容を確認する。 +2. 対象ファイルをステージング(`git add `)する。 +3. 日本語のコミットメッセージでコミット(`git commit -m "..."`)を実行する。 +4. コミットが正常に完了したことを確認する。 + +--- + +## 3. ファイル保存スタイル&文字コード規則 + +- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存してください。 +- **改行コード**: 必ず **CRLF (`\r\n`)** で保存してください。 +- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。 +- **連続空行の防止**: 空行は最大で「1行」とし、2行以上連続させないでください。 + diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..4e0fb7e --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,66 @@ +# FF14 攻略Wiki ワークスペース運用規則 + +本ワークスペース(`z:\FF14攻略`)におけるすべての作業およびAIエージェントの自律動作において、本規則を常に最優先で遵守してください。 + +--- + +## 1. プロジェクト方針&Wiki構造の維持 + +本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。 + +### 1.1 ポータルページ(`index.html`)の常時最新化 +- **新規ページ追加時の必須タスク**: + - 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。 + - カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。 + - ヘッダーの収録統計(ガイド本数など)を更新してください。 +- **既存ページ更新時の同期**: + - ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。 + +### 1.2 全ページ共通ナビゲーションバーの設置 +- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。 +- 共通ナビゲーションバーには以下を含めてください: + - ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」) + - 各主要攻略ページへのクイックリンク + - 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト +- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `` 内に含めてください。 + +### 1.3 HTMLデザイン・クオリティ基準 +- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。 +- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。 +- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。 + +--- + +## 2. Gitバージョン管理&自動コミット運用規則 + +ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。 + +### 2.1 コミットのタイミング +- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 +- 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。 + +### 2.2 コミットメッセージの記法 +- コミットメッセージは**分かりやすい日本語**で記述してください。 +- プレフィックスを付与して変更種別を明示してください: + - `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加 + - `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正 + - `docs: `: 既存ガイドの解説追記、ポータルの説明文修正 + - `style: `: レイアウト調整、CSSデザインの改善 + - `refactor: `: HTML/CSS/JSコードのリファクタリング + - `chore: `: 設定ファイルや運用規則の変更 + +### 2.3 コミットの実行手順 +1. 作業完了後、`git status` および `git diff` で変更内容を確認する。 +2. 対象ファイルをステージング(`git add `)する。 +3. 日本語のコミットメッセージでコミット(`git commit -m "..."`)を実行する。 +4. コミットが正常に完了したことを確認する。 + +--- + +## 3. ファイル保存スタイル&文字コード規則 + +- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存してください。 +- **改行コード**: 必ず **CRLF (`\r\n`)** で保存してください。 +- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。 +- **連続空行の防止**: 空行は最大で「1行」とし、2行以上連続させないでください。 +