Files
ff14-guide/AGENTS.md
T

67 lines
5.0 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 ポータルページ(`index.html`)の常時最新化
- **新規ページ追加時の必須タスク**:
- 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。
- カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。
- ヘッダーの収録統計(ガイド本数など)を更新してください。
- **既存ページ更新時の同期**:
- ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。
### 1.2 全ページ共通ナビゲーションバーの設置
- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`<body>` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。
- 共通ナビゲーションバーには以下を含めてください:
- ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」)
- 各主要攻略ページへのクイックリンク
- 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト
- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `<head>` 内に含めてください。
### 1.3 HTMLデザイン・クオリティ基準
- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。
- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。
- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。
---
## 2. Gitバージョン管理&自動コミット運用規則
ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。
### 2.1 コミットのタイミング
- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。
- 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。
### 2.2 コミットメッセージの記法
- コミットメッセージは**分かりやすい日本語**で記述してください。
- プレフィックスを付与して変更種別を明示してください:
- `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加
- `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正
- `docs: `: 既存ガイドの解説追記、ポータルの説明文修正
- `style: `: レイアウト調整、CSSデザインの改善
- `refactor: `: HTML/CSS/JSコードのリファクタリング
- `chore: `: 設定ファイルや運用規則の変更
### 2.3 コミットの実行手順
1. 作業完了後、`git status` および `git diff` で変更内容を確認する。
2. 対象ファイルをステージング(`git add <files>`)する。
3. 日本語のコミットメッセージでコミット(`git commit -m "..."`)を実行する。
4. コミットが正常に完了したことを確認する。
---
## 3. ファイル保存スタイル&文字コード規則
- **文字コード**: 必ず **UTF-8(BOMあり / UTF-8 with BOM)** で保存してください。
- **改行コード**: 必ず **CRLF (`\r\n`)** で保存してください。
- **行末空白の完全除去**: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。
- **連続空行の防止**: 空行は最大で「1行」とし、2行以上連続させないでください。