Files
ff14-guide/GEMINI.md
T

80 lines
8.1 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/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。
### 1.2 【最重要】48枠クロスホットバー(XHB)設計&12×1監視バーの厳格統一規則
全ジョブのホットバー解説ページにおいては、以下の**「合計48枠フレームワーク」**を厳格に適用し、図解と詳細表の両方を必ず表記してください。
1. **メインXHB(SET 1:16枠)[ジョブ専用]**:
- 単体攻撃コンボ、主要DoT、高頻度アビリティなど、最も連打するジョブ固有スキルを配置。
2. **2回押下時の拡張(WXHB:16枠)[ジョブ専用・常時画面表示]**:
- ジョブ固有の範囲攻撃、中・長周期バーストバフ、大技などを配置。
- **画面上に常時表示(WXHB常時表示設定)**するため、プレイヤーが直接リキャスト秒数を目視できる。
3. **同時押し拡張(ホールド操作拡張 LT+RT / RT+LT:16枠)[全ジョブ共通エリア]**:
- **【厳格適用】この16枠は全ジョブ共通の完全固定エリアとする。**
- ジョブ専用スキルはここには配置せず、全ジョブ共通のスキル・機能を集約する:
- **スプリント**、**ポーション・宝薬(バースト薬)**、**リミットブレイク(LB)**
- **ロールアクション**(アームズレングス、内丹、ヘッドグレイズ、牽制、堅実魔、プロトン、挑発、ルーシッドドリーム等)
- 共通マクロ(アシストタゲ合わせ、マウント等)
4. **12×1 リキャスト監視ホットバーの連動配置規則**:
- **【厳格適用】WXHBにあるジョブ専用スキルは、画面上に常時表示されているため12×1ホットバーには重複配置しない。**
- 12×1ホットバーには、**「同時押し拡張エリアに隠れているため普段秒数が見えない、リキャスト確認が必要なもの(スプリント、薬、共通防御バフ、アームズレングス等)」**を出力・配置すること。
5. **マクロ活用版ホットバー設定の併記**:
- マクロを活用したスキル使用が有効な場合(アシストタゲ合わせ、ターゲット順送り、迅速蘇生、マウスオーバー等)は、通常配置に加えて「マクロ導入時のホットバー設定・スロット入れ替え案」を必ず併記すること。
### 1.3 【最重要】マクロ設定・機能解説の完全詳細記述
- マクロ設定を解説する際は、**マクロの全コード行(`/micon`、代名詞 `<t>`/`<me>`/`<mo>`、ウェイト `<wait.1>`/`<wait.3>` 等)を省略なく完全に記述**してください。
- 行ごとの役割、連打時の挙動、ターゲット不在時のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。
### 1.4 【最重要】デザインテンプレート「Seesaa Wiki ニュートラルグレー」の厳格適用
- すべてのHTMLページは `common/css/seesaa_neutral_gray.css` をリンクして読み込んでください。
- 背景色: `#ebeeef`、メインコンテンツ: `#ffffff`、本文: `#2b2f36`。
- 左サイドバー(幅250px)+右メインコンテンツの2カラムレイアウト。
- H2(ニュートラルグレー帯見出し)、H3(左縦棒+下線)、テーブル(薄グレーヘッダー)、マクロ枠(コード+コピーボタン+解説)。
### 1.5 ポータルページ(`index.html`)の常時同期
- 新規ページ追加・構成変更時は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。
### 1.6 【最重要】グローバルサイドメニューへのコンテンツトップページ常時追加規則
- **コンテンツ追加時のサイドメニュー必須更新**:
- 今後、新しい攻略コンテンツや大カテゴリ(例: マウント、コンテンツファインダー、ハウジング、分解、お得意様等)が追加された際は、**必ずグローバルサイドメニュー(`common/sidebar.html` および `common/js/wiki_common.js`)に該当コンテンツのトップページへのリンクを追加**してください。
- **二重定義の常時同期徹底**:
1. 静的HTML共通ファイル: `common/sidebar.html`(「メインメニュー」ボックス、および専用サイドバーボックスの作成)
2. JavaScript共通定義: `common/js/wiki_common.js`(`WIKI_NAV_CONFIG.sidebar` の「メインメニュー」リンク一覧、専用セクション定義、および `getWikiRootPrefix()` への相対パス解決追加)
- どちらか一方のみの更新は禁止とし、iframe読み込み環境およびJavaScript動的フォールバック環境の双方向で完全に表示・遷移できるよう同期を義務付けます。
### 1.7 【最重要】共通ヘッダー(グローバルナビ)のメインメニュー限定規則
- ヘッダーのナビゲーション(`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:`)。
- リモートへのプッシュコマンド: `git push origin <ブランチ名>`(通常は `git push origin master`)をコミット直後に必ず実行すること。
---
## 3. ファイル保存スタイル&文字コード規則
- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存してください。
- **改行コード**: 必ず **CRLF (`\r\n`)** で保存してください。
- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。
- **連続空行の防止**: 空行は最大で「1行」とし、2行以上連続させないでください。