Files
ff14-guide/AGENTS.md
T

66 lines
5.9 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/`, `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) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。
---
## 2. Gitバージョン管理&自動コミット運用規則
- 作業が完了した際、**変更内容(論理的単位)ごとに即時Gitコミット**を行ってください。
- コミットメッセージは分かりやすい日本語で記述してください(プレフィックス: `feat:`, `fix:`, `docs:`, `style:`, `refactor:`, `chore:`)。
---
## 3. ファイル保存スタイル&文字コード規則
- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存してください。
- **改行コード**: 必ず **CRLF (`\r\n`)** で保存してください。
- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。
- **連続空行の防止**: 空行は最大で「1行」とし、2行以上連続させないでください。