5.0 KiB
5.0 KiB
FF14 攻略Wiki ワークスペース運用規則
本ワークスペース(z:\FF14攻略)におけるすべての作業およびAIエージェントの自律動作において、本規則を常に最優先で遵守してください。
1. プロジェクト方針&Wiki構造の維持
本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。
1.1 ポータルページ(index.html)の常時最新化
- 新規ページ追加時の必須タスク:
- 新しい攻略HTMLファイルを作成した際は、必ずポータルページ
index.htmlに該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。 - カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、
data-categoryおよびdata-keywordsを適切に設定してください。 - ヘッダーの収録統計(ガイド本数など)を更新してください。
- 新しい攻略HTMLファイルを作成した際は、必ずポータルページ
- 既存ページ更新時の同期:
- ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、
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 コミットの実行手順
- 作業完了後、
git statusおよびgit diffで変更内容を確認する。 - 対象ファイルをステージング(
git add <files>)する。 - 日本語のコミットメッセージでコミット(
git commit -m "...")を実行する。 - コミットが正常に完了したことを確認する。
3. ファイル保存スタイル&文字コード規則
- 文字コード: 必ず UTF-8(BOMあり / UTF-8 with BOM) で保存してください。
- 改行コード: 必ず CRLF (
\r\n) で保存してください。 - 行末空白の完全除去: コード行、コメント行、空行の末尾に半角・全角スペースを残さないでください。
- 連続空行の防止: 空行は最大で「1行」とし、2行以上連続させないでください。