Files
ff14-guide/AGENTS.md
T

97 lines
11 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/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。
### 1.2 【最重要】最新バージョン完全網羅&個人ブログ級の深度保証規則(初心者〜上級者対応)
- **現行最新パッチ(7.x 黄金のレガシー)完全準拠**:
- 古い廃止情報・旧仕様(旧スキル、旧トークン、削除された仕様等)は一切含めず、常に現行パッチの最新情報に完全に合わせた内容を記述してください。
- パッチ変更に伴う最新仕様(例: 2箇所染色システム、最新アラガントームストーン「美学」「天道」、新式禁断仕様、最新コンテンツルーレット報酬等)を正確に反映すること。
- **初心者から上級者までの全方位網羅**:
- 初心者がつまずきやすい前提クエスト、解放NPCの正確なマップ座標(X: Y:)、基礎ルール、操作設定から、上級者が求める最高効率周回ルート、時給・期待値、ステータス閾値、応用テクニックまで完全に網羅してください。
- **個人ブログ・専門検証サイト級の圧倒的深度・情報量**:
- 単なる表面的な概要紹介や数行の説明は厳禁とします。
- 具体的な数値データ、ドロップ確率傾向、ギミックのフェーズ進行、おすすめマクロの全行解説、よくある失敗・落とし穴(注意点)、検証に基づく詳細仕様まで余すところなく詳細に記述してください。
### 1.3 【最重要】攻略Wiki標準文体・トーン&マナー統一規則(全ページ適用)
- **客観的・明瞭・信頼性の高い攻略Wiki文体の徹底**:
- 親しみやすさを過剰に狙った個人日記風の語り口調(「〜だと思います」「〜してみましょう!」「〜ですね」等の冗長なブログ調)を排し、一般的な大手ゲーム攻略Wikiに準拠した客観的・明瞭・簡潔な文体を徹底してください。
- 原則として「〜である」「〜となる」「〜を推奨」「〜が必要」といった客観的な断定・解説調(または引き締まった丁寧調)、および見出し・箇条書きでの体言止めを使用してください。
- 作成済みの既存ページおよび新規作成する全ページに本規則を適用し、サイト全体の文体トーンを攻略Wikiとして統一してください。
- **視認性と要点把握の最大化**:
- 読者が瞬時に要点と数値を把握できるよう、太字(`<strong>`)、アラート枠(`wiki-box-alert`)、注意・推奨枠(`wiki-callout`)、表組み(`wiki-table`)、手順リストを適切に配置してレイアウトしてください。
### 1.4 【最重要】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.5 【最重要】マクロ設定・機能解説の完全詳細記述
- マクロ設定を解説する際は、**マクロの全コード行(`/micon`、代名詞 `<t>`/`<me>`/`<mo>`、ウェイト `<wait.1>`/`<wait.3>` 等)を省略なく完全に記述**してください。
- 行ごとの役割、連打時の挙動、ターゲット不在時のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。
### 1.6 【最重要】デザインテンプレート「Seesaa Wiki ニュートラルグレー」の厳格適用
- すべてのHTMLページは `common/css/seesaa_neutral_gray.css` をリンクして読み込んでください。
- 背景色: `#ebeeef`、メインコンテンツ: `#ffffff`、本文: `#2b2f36`。
- 左サイドバー(幅250px)+右メインコンテンツの2カラムレイアウト。
- H2(ニュートラルグレー帯見出し)、H3(左縦棒+下線)、テーブル(薄グレーヘッダー)、マクロ枠(コード+コピーボタン+解説)。
### 1.7 ポータルページ(`index.html`)の常時同期
- 新規ページ追加・構成変更時は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。
### 1.8 【最重要】グローバルサイドメニューへのコンテンツトップページ常時追加規則
- **コンテンツ追加時のサイドメニュー必須更新**:
- 今後、新しい攻略コンテンツや大カテゴリ(例: マウント、コンテンツファインダー、ハウジング、分解、お得意様等)が追加された際は、**必ずグローバルサイドメニュー(`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.9 【最重要】共通ヘッダー(グローバルナビ)のメインメニュー限定規則
- ヘッダーのナビゲーション(`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行以上連続させないでください。