From a5a796b13cba0654930f1733b66545b611b8b40d Mon Sep 17 00:00:00 2001 From: uduki Date: Wed, 28 Oct 2026 11:11:37 +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=81=AE=E6=9B=B4=E6=96=B0=EF=BC=881=E3=83=9A=E3=83=BC?= =?UTF-8?q?=E3=82=B81=E3=82=B3=E3=83=B3=E3=83=86=E3=83=B3=E3=83=84?= =?UTF-8?q?=E3=80=81=E3=83=9E=E3=82=AF=E3=83=AD=E8=A9=B3=E7=B4=B0=E5=8C=96?= =?UTF-8?q?=E3=80=81=E5=88=86=E5=89=B2=E6=8E=A8=E9=80=B2=E3=80=81Seesaa=20?= =?UTF-8?q?Wiki=E3=83=8B=E3=83=A5=E3=83=BC=E3=83=88=E3=83=A9=E3=83=AB?= =?UTF-8?q?=E3=82=B0=E3=83=AC=E3=83=BC=E6=BA=96=E6=8B=A0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 59 +++++++++++++++++++++++++++++++++---------------------- GEMINI.md | 59 +++++++++++++++++++++++++++++++++---------------------- 2 files changed, 72 insertions(+), 46 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 4e0fb7e..31196e9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,26 +8,39 @@ 本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。 -### 1.1 ポータルページ(`index.html`)の常時最新化 -- **新規ページ追加時の必須タスク**: - - 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。 - - カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。 - - ヘッダーの収録統計(ガイド本数など)を更新してください。 -- **既存ページ更新時の同期**: - - ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。 +### 1.1 【最重要】1ページ1コンテンツの原則&積極的なフォルダ・ページ分割 +- **1ページ1コンテンツの徹底**: + - 極力1つのHTMLファイルには単一の明確なトピック(例: 「召喚士のXHB配置」「吟遊詩人の戦歌ローテーション」「ギャザクラ全NPC座標一覧」など)のみを記述してください。 + - 1つの長大なページに複数のジョブや無関係なテーマを詰め込むことは禁止とし、トピックごとに明確に分割してください。 +- **積極的なフォルダ分類(階層化)**: + - 大カテゴリごとにフォルダを作成し(例: `jobs/summoner/`, `jobs/bard/`, `crafter_gatherer/`, `xhb/`, `multiplayer/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。 + - 各フォルダには必要に応じて案内用トップページ(`index.html`)を設置してください。 -### 1.2 全ページ共通ナビゲーションバーの設置 -- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。 -- 共通ナビゲーションバーには以下を含めてください: - - ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」) - - 各主要攻略ページへのクイックリンク - - 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト -- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `` 内に含めてください。 +### 1.2 【最重要】マクロ設定・機能解説の完全詳細記述 +- **マクロの全行・全設定の完全記述**: + - マクロ設定やゲーム内機能を解説する際は、概要のみで済ませず、**マクロの全コード行(`/micon`、代名詞 ``/``/``、ウェイト `` 等)を省略なく完全に記述**してください。 + - なぜその記述順序なのか、行ごとの役割、連打時の挙動、ターゲットがいない場合のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。 -### 1.3 HTMLデザイン・クオリティ基準 -- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。 -- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。 -- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。 +### 1.3 【最重要】デザインテンプレート「Seesaa Wiki ニュートラルグレー」の厳格適用 +- 全ページのUIデザインは、日本の定番ゲームWikiスタイルである**「Seesaa Wiki ニュートラルグレー」**を踏襲してください。 +- **共通CSSの適用**: + - すべてのHTMLページは `common/css/seesaa_neutral_gray.css` をリンクして読み込んでください。 +- **デザイン規範**: + - **背景色**: 落ち着いたニュートラルグレー系(`#f0f0f2` 〜 `#e6e6e9`) + - **メインコンテンツ**: 白色(`#ffffff`)、視認性の高いダークグレー本文(`#2b2b2b`) + - **2カラムレイアウト**: + - **左サイドバー**: メニュー(カテゴリー一覧、主要ページリンク、サイト内検索、最近の更新) + - **右メインコンテンツ**: パンくずリスト、ページタイトル、最終更新日、本文、ページネーション + - **見出しスタイル**: + - H2(大見出し): ニュートラルグレーの帯見出し(`#646c7a` または `#e8e9ec` に左太線アクセント) + - H3(中見出し): 下線ボーダー+左縦線アクセント + - **テーブル・マクロ表示**: + - テーブルヘッダー: 薄いグレー(`#ececf0`) + - マクロ枠(コードブロック): 背景 `#f7f7f9`、罫線 `#d8d8de`、等幅フォント、コピー機能や詳細注釈を併記 + +### 1.4 ポータルページ(`index.html`)の常時同期 +- 新規ページを追加、または構成を変更した際は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。 +- サイドバー共通メニューにも適宜最新のページ構造を反映させてください。 --- @@ -36,17 +49,17 @@ ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。 ### 2.1 コミットのタイミング -- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 +- ガイドの新規作成、既存ガイドの加筆・分割、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 - 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。 ### 2.2 コミットメッセージの記法 - コミットメッセージは**分かりやすい日本語**で記述してください。 - プレフィックスを付与して変更種別を明示してください: - - `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加 - - `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正 + - `feat: `: 新しい攻略ガイドの追加、新機能・新ページの追加 + - `fix: `: スキル回し、マクロ構文、数値、座標、リンク等の誤り訂正 - `docs: `: 既存ガイドの解説追記、ポータルの説明文修正 - - `style: `: レイアウト調整、CSSデザインの改善 - - `refactor: `: HTML/CSS/JSコードのリファクタリング + - `style: `: Seesaa Wikiニュートラルグレーのデザイン調整、レイアウト改善 + - `refactor: `: ページ分割、ディレクトリ整理、コードのリファクタリング - `chore: `: 設定ファイルや運用規則の変更 ### 2.3 コミットの実行手順 diff --git a/GEMINI.md b/GEMINI.md index 4e0fb7e..31196e9 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -8,26 +8,39 @@ 本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。 -### 1.1 ポータルページ(`index.html`)の常時最新化 -- **新規ページ追加時の必須タスク**: - - 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。 - - カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。 - - ヘッダーの収録統計(ガイド本数など)を更新してください。 -- **既存ページ更新時の同期**: - - ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。 +### 1.1 【最重要】1ページ1コンテンツの原則&積極的なフォルダ・ページ分割 +- **1ページ1コンテンツの徹底**: + - 極力1つのHTMLファイルには単一の明確なトピック(例: 「召喚士のXHB配置」「吟遊詩人の戦歌ローテーション」「ギャザクラ全NPC座標一覧」など)のみを記述してください。 + - 1つの長大なページに複数のジョブや無関係なテーマを詰め込むことは禁止とし、トピックごとに明確に分割してください。 +- **積極的なフォルダ分類(階層化)**: + - 大カテゴリごとにフォルダを作成し(例: `jobs/summoner/`, `jobs/bard/`, `crafter_gatherer/`, `xhb/`, `multiplayer/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。 + - 各フォルダには必要に応じて案内用トップページ(`index.html`)を設置してください。 -### 1.2 全ページ共通ナビゲーションバーの設置 -- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。 -- 共通ナビゲーションバーには以下を含めてください: - - ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」) - - 各主要攻略ページへのクイックリンク - - 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト -- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `` 内に含めてください。 +### 1.2 【最重要】マクロ設定・機能解説の完全詳細記述 +- **マクロの全行・全設定の完全記述**: + - マクロ設定やゲーム内機能を解説する際は、概要のみで済ませず、**マクロの全コード行(`/micon`、代名詞 ``/``/``、ウェイト `` 等)を省略なく完全に記述**してください。 + - なぜその記述順序なのか、行ごとの役割、連打時の挙動、ターゲットがいない場合のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。 -### 1.3 HTMLデザイン・クオリティ基準 -- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。 -- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。 -- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。 +### 1.3 【最重要】デザインテンプレート「Seesaa Wiki ニュートラルグレー」の厳格適用 +- 全ページのUIデザインは、日本の定番ゲームWikiスタイルである**「Seesaa Wiki ニュートラルグレー」**を踏襲してください。 +- **共通CSSの適用**: + - すべてのHTMLページは `common/css/seesaa_neutral_gray.css` をリンクして読み込んでください。 +- **デザイン規範**: + - **背景色**: 落ち着いたニュートラルグレー系(`#f0f0f2` 〜 `#e6e6e9`) + - **メインコンテンツ**: 白色(`#ffffff`)、視認性の高いダークグレー本文(`#2b2b2b`) + - **2カラムレイアウト**: + - **左サイドバー**: メニュー(カテゴリー一覧、主要ページリンク、サイト内検索、最近の更新) + - **右メインコンテンツ**: パンくずリスト、ページタイトル、最終更新日、本文、ページネーション + - **見出しスタイル**: + - H2(大見出し): ニュートラルグレーの帯見出し(`#646c7a` または `#e8e9ec` に左太線アクセント) + - H3(中見出し): 下線ボーダー+左縦線アクセント + - **テーブル・マクロ表示**: + - テーブルヘッダー: 薄いグレー(`#ececf0`) + - マクロ枠(コードブロック): 背景 `#f7f7f9`、罫線 `#d8d8de`、等幅フォント、コピー機能や詳細注釈を併記 + +### 1.4 ポータルページ(`index.html`)の常時同期 +- 新規ページを追加、または構成を変更した際は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。 +- サイドバー共通メニューにも適宜最新のページ構造を反映させてください。 --- @@ -36,17 +49,17 @@ ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。 ### 2.1 コミットのタイミング -- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 +- ガイドの新規作成、既存ガイドの加筆・分割、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 - 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。 ### 2.2 コミットメッセージの記法 - コミットメッセージは**分かりやすい日本語**で記述してください。 - プレフィックスを付与して変更種別を明示してください: - - `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加 - - `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正 + - `feat: `: 新しい攻略ガイドの追加、新機能・新ページの追加 + - `fix: `: スキル回し、マクロ構文、数値、座標、リンク等の誤り訂正 - `docs: `: 既存ガイドの解説追記、ポータルの説明文修正 - - `style: `: レイアウト調整、CSSデザインの改善 - - `refactor: `: HTML/CSS/JSコードのリファクタリング + - `style: `: Seesaa Wikiニュートラルグレーのデザイン調整、レイアウト改善 + - `refactor: `: ページ分割、ディレクトリ整理、コードのリファクタリング - `chore: `: 設定ファイルや運用規則の変更 ### 2.3 コミットの実行手順