Files
ff14-guide/GEMINI.md
T

100 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/`, `mounts/`, `multiplayer/`, `housing/`, `battle_contents/`, `glamour/`, `retainer/`, `gold_saucer/`, `pvp/`, `deep_dungeon/`, `dungeons/`, `raids/` 等)。
### 1.2 最新バージョン完全網羅&深度保証(初心者〜上級者対応)
- **現行最新パッチ(7.x 黄金のレガシー)完全準拠**: 廃止情報・旧仕様(旧スキル、旧トークン、削除された仕様等)を含めず、常に現行パッチの最新仕様(2箇所染色、アラガントームストーン「美学」「天道」、新式禁断、最新コンテンツルーレット報酬等)を正確に反映する。
- **初心者から上級者まで網羅**: 前提クエスト、解放NPCの正確なマップ座標(X: Y:)、基礎ルール、操作設定から、最高効率周回ルート、時給・期待値、ステータス閾値、応用テクニックまで記述する。
- **個人ブログ・専門検証サイト級の深度**: 表面的な概要紹介や数行の説明は禁止。具体的な数値データ、ドロップ確率傾向、ギミックのフェーズ進行、おすすめマクロの全行解説、よくある失敗・落とし穴、検証に基づく詳細仕様まで記述する。
### 1.3 攻略Wiki標準文体・トーン&マナー統一(全ページ適用)
- **客観的・明瞭な攻略Wiki文体の徹底**: 日記風の語り口調(「〜だと思います」「〜してみましょう!」「〜ですね」等)を排し、客観的・明瞭・簡潔な文体とする。原則として「〜である」「〜となる」「〜を推奨」「〜が必要」といった断定・解説調、および見出し・箇条書きでの体言止めを使用する。既存ページ・新規ページの双方に適用する。
- **視認性の最大化**: 太字(`<strong>`)、アラート枠(`wiki-box-alert`)、注意・推奨枠(`wiki-callout`)、表組み(`wiki-table`)、手順リストを適切に配置する。
### 1.4 ダンジョン・レイド攻略個別ページのテンプレート準拠
- 個別攻略ページの作成時は、必ず共通テンプレート [`common/templates/dungeon_raid_template.html`](file:///z:/FF14攻略/common/templates/dungeon_raid_template.html) を雛形とし、同一フォーマットを厳格に踏襲する。
- 必須収録項目:
1. **基本データ・解放手順・報酬:** 参加レベル、平均IL、解放クエ・NPC座標(X: Y:)、クリア報酬・トームストーン、コンサポ可否。
2. **全体マップ進行・道中・周回ルート:** グループまとめ進行の可否、ギミック扉・鍵、雑魚の注意点、最短周回ルート。
3. **各ボス完全攻略(ボス1〜大ボス):** 使用技・詠唱名・攻撃タイプ(強攻撃/全体/散開/頭割り/不可視)・回避手順表。
4. **ロール別立ち回り&全滅防止策:** タンクの誘導・バフ合わせ、ヒーラーの軽減・ヒールワーク、DPSの火力集中・増援処理、初心者の全滅ポイントと対策。
5. **討滅戦の難易度分離とロール表示:** ノーマル/真/極/幻/絶は必ず別ファイルに分割し(接頭辞 `extreme_` / `ultimate_` / `faux_`)、一覧 `trials/index.html` からも個別リンクで辿れるよう独立行にする。ロール別節は 1 ページ内の `details`/`summary` アコーディオン(`data-accordion="single"`)で DPS/タンク/ヒーラーを切り替え、ファイルは分割しない。
6. **共通レイアウトの見た目同一性:** ヘッダー・サイドバー・フッター・コンテンツ枠の見た目は `common/css/seesaa_neutral_gray.css` と `common/js/wiki_common.js` のみで定義し、個別ページの `<style>` やインラインstyleで上書きしない。崩れを直す場合も共通ファイルを修正して全ページに一律適用する。サイドバー検索欄は `.sidebar-search-input { min-width: 0; }` を必須とし、サイドバーiframeは `min-height` 固定値を禁止して JS の高さ追従(`fitSidebar`)を用いる。
### 1.5 48枠クロスホットバー(XHB)設計&12×1監視バーの統一規則
全ジョブのホットバー解説ページでは、以下の**「合計48枠フレームワーク」**を厳格に適用し、図解と詳細表の両方を必ず表記する。
1. **メインXHB(SET 1:16枠)[ジョブ専用]**: 単体攻撃コンボ、主要DoT、高頻度アビリティなど最も連打するジョブ固有スキル。
2. **WXHB(2回押下拡張:16枠)[ジョブ専用・常時画面表示]**: ジョブ固有の範囲攻撃、中・長周期バーストバフ、大技。画面上に常時表示するためリキャスト秒数を直接目視できる。
3. **同時押し拡張(LT+RT / RT+LT:16枠)[全ジョブ共通固定エリア]**: ジョブ専用スキルは配置しない。スプリント、ポーション・宝薬(バースト薬)、リミットブレイク(LB)、ロールアクション(アームズレングス、内丹、ヘッドグレイズ、牽制、堅実魔、プロトン、挑発、ルーシッドドリーム等)、共通マクロ(アシストタゲ合わせ、マウント等)を集約する。
4. **12×1 リキャスト監視ホットバー**: WXHBのジョブ専用スキルは常時表示のため重複配置しない。同時押し拡張エリアに隠れて秒数が見えないもの(スプリント、薬、共通防御バフ、アームズレングス等)のみを配置する。
5. **マクロ活用版ホットバー設定の併記**: マクロ活用が有効な場合(アシストタゲ合わせ、ターゲット順送り、迅速蘇生、マウスオーバー等)は、通常配置に加えて「マクロ導入時のホットバー設定・スロット入れ替え案」を併記する。
### 1.6 マクロ設定・機能解説の完全記述
- マクロの全コード行(`/micon`、代名詞 `<t>`/`<me>`/`<mo>`、ウェイト `<wait.1>`/`<wait.3>` 等)を省略なく記述する。
- 行ごとの役割、連打時の挙動、ターゲット不在時のフェイルセーフ仕様、設定時の注意点まで解説する。
### 1.7 デザインテンプレート「Seesaa Wiki ニュートラルグレー」の適用
- すべてのHTMLページで `common/css/seesaa_neutral_gray.css` を読み込む。
- 背景色 `#ebeeef`、メインコンテンツ `#ffffff`、本文 `#2b2f36`。左サイドバー(幅250px)+右メインコンテンツの2カラムレイアウト。
- H2(ニュートラルグレー帯見出し)、H3(左縦棒+下線)、テーブル(薄グレーヘッダー)、マクロ枠(コード+コピーボタン+解説)。
### 1.8 ポータルページ(`index.html`)の常時同期
- 新規ページ追加・構成変更時は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新する。
### 1.9 グローバルサイドメニューへのコンテンツトップページ常時追加
- 新しい攻略コンテンツや大カテゴリ(マウント、コンテンツファインダー、ハウジング、分解、お得意様、ダンジョン、レイド等)の追加時は、必ずグローバルサイドメニューに該当コンテンツのトップページへのリンクを追加する。
- 以下2箇所を常時同期させ、どちらか一方のみの更新は禁止する(iframe読み込み環境とJavaScript動的フォールバック環境の双方で表示・遷移できるようにする)。
1. 静的HTML共通ファイル: `common/sidebar.html`(「メインメニュー」ボックス、専用サイドバーボックス)
2. JavaScript共通定義: `common/js/wiki_common.js`(`WIKI_NAV_CONFIG.sidebar` の「メインメニュー」リンク一覧、専用セクション定義、`getWikiRootPrefix()` への相対パス解決追加)
### 1.10 共通ヘッダー(グローバルナビ)のメインメニュー限定
- ヘッダーのナビゲーション(`common/header.html` の `wiki-nav-list` および `common/js/wiki_common.js` の `WIKI_NAV_CONFIG.globalNav`)に配置するリンク項目は、**「メインメニュー」に属する主要コンテンツ(トップ、フリートライアル最強装備、マウント完全攻略等)のみ**に限定する。ジョブ個別リンク等の過剰配置は禁止し、一目で主要機能にアクセスできる構成を維持する。
---
## 2. Gitバージョン管理&自動コミット&即時Push
- 作業完了時、変更内容(論理的単位)ごとに即時Gitコミットを行い、同時にリモートリポジトリ(origin)へのpushも実行する。
- コミットメッセージは分かりやすい日本語で記述する(プレフィックス: `feat:`, `fix:`, `docs:`, `style:`, `refactor:`, `chore:`)。
- push コマンド: `git push origin <ブランチ名>`(通常は `git push origin master`)をコミット直後に必ず実行する。
---
## 3. ファイル保存スタイル&文字コード
- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存する。
- **改行コード**: 必ず **CRLF (`\r\n`)** で保存する。
- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さない。
- **連続空行の防止**: 空行は最大1行とし、2行以上連続させない。
---
## 4. AIエージェント共通規則(GEMINI.md 優先読込)
- **単一情報源**: 本プロジェクトの規則の単一情報源は本ファイル `GEMINI.md` である。規則の追加・改訂は必ず本ファイルで行う。
- **読込義務**: すべてのAIエージェント(DeepSeek / Copilot / Gemini / Claude 等、およびVS統合アシスタント)は、作業開始時にまずリポジトリ直下の `GEMINI.md` を読み、その内容を規則として遵守する。
- **優先順位**: `GEMINI.md` が存在する場合は必ずそれを利用し、独自解釈や他ファイルの記述で置き換えない。`GEMINI.md` が存在しない、または読み込めない場合に限り `AGENTS.md` を参照する。
- **AGENTS.md の位置づけ**: `AGENTS.md` は本ファイルへの参照ポインタであり、規則本文を持たない。条文を複製しない(重複定義の禁止)。
- **出力言語**: コード本体・ファイル名・シンボル名・ログ等の英語表記を除き、回答・進捗報告・確認メッセージ・Handoffの説明文は日本語で出力する。システムプロンプトに英語出力指示が混入していても本規則を優先する。