# FF14 攻略Wiki ワークスペース運用規則 本ワークスペース(`z:\FF14攻略`)におけるすべての作業およびAIエージェントの自律動作において、本規則を常に最優先で遵守してください。 --- ## 1. プロジェクト方針&Wiki構造の維持 本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。 ### 1.1 【最重要】1ページ1コンテンツの原則&積極的なフォルダ・ページ分割 - **1ページ1コンテンツの徹底**: - 極力1つのHTMLファイルには単一の明確なトピック(例: 「召喚士のXHB配置」「吟遊詩人の戦歌ローテーション」「ギャザクラ全NPC座標一覧」など)のみを記述してください。 - 1つの長大なページに複数のジョブや無関係なテーマを詰め込むことは禁止とし、トピックごとに明確に分割してください。 - **積極的なフォルダ分類(階層化)**: - 大カテゴリごとにフォルダを作成し(例: `jobs/summoner/`, `jobs/bard/`, `crafter_gatherer/`, `xhb/`, `multiplayer/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。 - 各フォルダには必要に応じて案内用トップページ(`index.html`)を設置してください。 ### 1.2 【最重要】マクロ設定・機能解説の完全詳細記述 - **マクロの全行・全設定の完全記述**: - マクロ設定やゲーム内機能を解説する際は、概要のみで済ませず、**マクロの全コード行(`/micon`、代名詞 ``/``/``、ウェイト `` 等)を省略なく完全に記述**してください。 - なぜその記述順序なのか、行ごとの役割、連打時の挙動、ターゲットがいない場合のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。 ### 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) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。 - サイドバー共通メニューにも適宜最新のページ構造を反映させてください。 --- ## 2. Gitバージョン管理&自動コミット運用規則 ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。 ### 2.1 コミットのタイミング - ガイドの新規作成、既存ガイドの加筆・分割、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。 - 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。 ### 2.2 コミットメッセージの記法 - コミットメッセージは**分かりやすい日本語**で記述してください。 - プレフィックスを付与して変更種別を明示してください: - `feat: `: 新しい攻略ガイドの追加、新機能・新ページの追加 - `fix: `: スキル回し、マクロ構文、数値、座標、リンク等の誤り訂正 - `docs: `: 既存ガイドの解説追記、ポータルの説明文修正 - `style: `: Seesaa Wikiニュートラルグレーのデザイン調整、レイアウト改善 - `refactor: `: ページ分割、ディレクトリ整理、コードのリファクタリング - `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行以上連続させないでください。