Files
ff14-guide/GEMINI.md
T

5.0 KiB
Raw Blame History

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行以上連続させないでください。