kata-help

<objective> 完全な Kata スキルリファレンスをバージョン情報とともに表示します。

まず、インストールされているバージョンを読み込みます：

if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then
  cat "$CLAUDE_PLUGIN_ROOT/VERSION" 2>/dev/null
else
  echo "unknown"
fi

その後、以下のリファレンス内容を出力し、トップにバージョンを挿入します。以下は追加しないでください：

プロジェクト固有の分析
Git ステータスまたはファイルコンテキスト
次のステップの提案
リファレンス以外のいかなるコメント </objective>

<reference> # Kata スキルリファレンス

バージョン: {上記の bash からのバージョン}

Kata は Claude Code 用の仕様駆動開発フレームワークです。エージェント開発に最適化された階層的プロジェクト計画を作成します。

クイックスタート

/kata-new-project - プロジェクトを初期化（調査、要件、ロードマップを含む）
/kata-plan-phase 1 - 最初のフェーズの詳細計画を作成
/kata-execute-phase 1 - フェーズを実行

コアワークフロー

/kata-new-project → /kata-plan-phase → /kata-execute-phase → 繰り返す

プロジェクト初期化

/kata-new-project 統一されたフローを通じて新規プロジェクトを初期化します。

1 つのスキルで、アイデアから計画準備完了まで対応します：

何を構築しているのかを理解するための深い質問
オプションのドメイン調査（4 つの並列リサーチャーエージェントを起動）
v1/v2/スコープ外スコーピングの要件定義
フェーズ分解と成功基準を含むロードマップ作成

すべての .planning/ 成果物を作成します：

PROJECT.md — ビジョンと要件
config.json — ワークフローモード（対話型/YOLO）
research/ — ドメイン調査（選択した場合）
REQUIREMENTS.md — スコープ付き要件と REQ-ID
ROADMAP.md — 要件にマッピングされたフェーズ
STATE.md — プロジェクトメモリ

使用方法：/kata-new-project

/kata-map-codebase 既存コードベースをブラウンフィールドプロジェクト用にマッピングします。

並列 Explore エージェントでコードベースを分析
7 つの焦点を絞ったドキュメントで .planning/codebase/ を作成
スタック、アーキテクチャ、構造、規約、テスト、統合、懸念事項をカバー
既存コードベースで /kata-new-project の前に使用

使用方法：/kata-map-codebase

フェーズ計画

/kata-discuss-phase <number> 計画前にフェーズのビジョンを具体化するのに役立ちます。

このフェーズがどのように機能するかの想像をキャプチャ
ビジョン、本質、境界を含む CONTEXT.md を作成
何かの外観/雰囲気についてアイデアがある場合に使用

使用方法：/kata-discuss-phase 2

/kata-research-phase <number> ニッチな複雑なドメインの包括的なエコシステム調査。

標準スタック、アーキテクチャパターン、落とし穴を発見
「専門家がこれをどう構築するか」の知識を含む RESEARCH.md を作成
3D、ゲーム、オーディオ、シェーダー、ML その他専門ドメインに使用
「どのライブラリを使うか」を超えたエコシステム知識に対応

使用方法：/kata-research-phase 3

/kata-listing-phase-assumptions <number> Claude が開始する前に計画していることを確認します。

フェーズの Claude の意図したアプローチを表示
Claude がビジョンを誤解した場合、軌道修正可能
ファイルは作成されません。会話形式の出力のみ

使用方法：/kata-listing-phase-assumptions 3

/kata-plan-phase <number> 特定のフェーズの詳細実行計画を作成します。

.planning/phases/pending/XX-phase-name/XX-YY-PLAN.md を生成
フェーズを具体的で実行可能なタスクに分割
検証基準と成功測定を含む
フェーズごとに複数計画をサポート（XX-01、XX-02 等）

使用方法：/kata-plan-phase 1 結果：.planning/phases/pending/01-foundation/01-01-PLAN.md を作成

実行

/kata-execute-phase <phase-number> フェーズ内のすべての計画を実行します。

フェーズを pending/ → active/ → completed/ に移動
フロントマターからウェーブごとに計画をグループ化し、ウェーブを順序付けで実行
各ウェーブ内の計画は Task ツール経由で並列実行
すべての計画完了後、フェーズゴールを検証
REQUIREMENTS.md、ROADMAP.md、STATE.md を更新

使用方法：/kata-execute-phase 5

クイックモード

/kata-execute-quick-task Kata の保証を備えながら、オプションエージェントをスキップして小さなアドホックタスクを実行します。

クイックモードは短いパスで同じシステムを使用します：

プランナー + エグゼキューター（リサーチャー、チェッカー、ベリファイアーはスキップ）を起動
クイックタスクは計画済みフェーズとは別に .planning/quick/ に保存
STATE.md トラッキングを更新（ROADMAP.md ではなく）

正確に何をすべきかわかっており、タスクが小さすぎて調査や検証の必要がない場合に使用します。

使用方法：/kata-execute-quick-task 結果：.planning/quick/NNN-slug/PLAN.md、.planning/quick/NNN-slug/SUMMARY.md を作成

ロードマップ管理

/kata-add-phase <description> 現在のマイルストーンの最後に新しいフェーズを追加します。

ROADMAP.md に追加
次の連続番号を使用
pending/ にフェーズディレクトリを作成

使用方法：/kata-add-phase "Add admin dashboard"

/kata-insert-phase <after> <description> 既存フェーズ間の緊急な作業を小数フェーズとして挿入します。

中間フェーズを作成（例：7 と 8 の間に 7.1）
マイルストーン中に発生する必要がある検出された作業に便利
フェーズの順序を保持

使用方法：/kata-insert-phase 7 "Fix critical auth bug" 結果：フェーズ 7.1 を作成

/kata-remove-phase <number> 将来のフェーズを削除し、後続フェーズを再番号付けします。

フェーズディレクトリとすべての参照を削除
ギャップを閉じるすべての後続フェーズを再番号付け
未開始の将来フェーズでのみ機能
Git コミットは履歴を保持

使用方法：/kata-remove-phase 17 結果：フェーズ 17 を削除、フェーズ 18-20 が 17-19 に変わる

/kata-move-phase <phase> <operation> フェーズをマイルストーン間で移動するか、マイルストーン内で並び替えます。

クロスマイルストーン：ターゲットマイルストーンにフェーズを移動、両方を再番号付け
並び替え：マイルストーン内でフェーズ位置を変更、すべてを再番号付け
保留中のフェーズのみ移動可能

使用方法：/kata-move-phase 3 to v1.6.0（クロスマイルストーン）使用方法：/kata-move-phase 3 before 1（マイルストーン内で並び替え）

マイルストーン管理

/kata-add-milestone <name> 統一されたフローを通じて新しいマイルストーンを開始します。

次に何を構築するかを理解するための深い質問
オプションのドメイン調査（4 つの並列リサーチャーエージェントを起動）
スコーピングを含む要件定義
フェーズ分解を含むロードマップ作成

ブラウンフィールドプロジェクト（既存の PROJECT.md）の /kata-new-project フローをミラー化。

使用方法：/kata-add-milestone "v2.0 Features"

/kata-complete-milestone <version> 完了したマイルストーンをアーカイブし、次バージョンを準備します。

統計情報を含む MILESTONES.md エントリを作成
完全な詳細を milestones/ ディレクトリにアーカイブ
リリース用 git タグを作成
次バージョン向けにワークスペースを準備

使用方法：/kata-complete-milestone 1.0.0

進捗トラッキング

/kata-track-progress プロジェクトステータスを確認し、次のアクションに知的にルーティングします。

ビジュアル進捗バーと完了率を表示
SUMMARY ファイルから最近の作業をまとめます
現在位置と次のステップを表示
主要な決定と未解決の問題をリスト表示
次の計画を実行するか、欠落している場合は作成するよう提供
100% マイルストーン完了を検出

使用方法：/kata-track-progress

セッション管理

/kata-resume-work 前のセッションから完全なコンテキスト復元で作業を再開します。

STATE.md からプロジェクトコンテキストを読み込み
現在位置と最近の進捗を表示
プロジェクト状態に基づく次のアクションを提供

使用方法：/kata-resume-work

/kata-pause-work フェーズの途中で作業を一時停止するときのコンテキストハンドオフを作成します。

現在の状態を含む .continue-here ファイルを作成
STATE.md セッション連続性セクションを更新
進行中の作業コンテキストをキャプチャ

使用方法：/kata-pause-work

デバッグ

/kata-debug [issue description] コンテキストリセット全体の永続状態を持つ体系的なデバッグ。

適応的な質問を通じて症状を収集
.planning/debug/[slug].md を作成して調査を追跡
科学的方法を使用して調査（証拠 → 仮説 → テスト）
/clear を生き残ります — /kata-debug を引数なしで実行してアクティブセッションを再開
解決された問題を .planning/debug/resolved/ にアーカイブ

使用方法：/kata-debug "login button doesn't work" 使用方法：/kata-debug（アクティブセッションを再開）

問題管理

/kata-add-issue [description] 現在の会話から問題またはタスクをキャプチャして記録します。

会話からコンテキストを抽出（または提供された説明を使用）
.planning/issues/open/ に構造化された問題ファイルを作成
グループ化するためにファイルパスから領域を推測
作成前に重複をチェック
STATE.md 問題数を更新

使用方法：/kata-add-issue（会話から推測）使用方法：/kata-add-issue Add auth token refresh

/kata-check-issues [area] 保留中の問題をリストし、1 つを選択して作業します。

タイトル、領域、経過時間を含むすべての保留中の問題をリスト表示
オプションの領域フィルター（例：/kata-check-issues api）
選択した問題の完全なコンテキストを読み込み
適切なアクション（今すぐ作業、フェーズに追加、ブレーンストーミング）にルーティング
作業が始まると問題を done/ に移動

使用方法：/kata-check-issues 使用方法：/kata-check-issues api

ユーザーアクセプタンステスト

/kata-verify-work [phase] 会話形式 UAT を通じて構築された機能を検証します。

SUMMARY.md ファイルからテスト可能な成果物を抽出
テストを 1 つずつ提示（はい/いいえ応答）
失敗を自動的に診断し、修正計画を作成
問題が見つかった場合、再実行準備完了

使用方法：/kata-verify-work 3

マイルストーン監査

/kata-audit-milestone [version] 元のインテントに対してマイルストーン完了を監査します。

すべてのフェーズ VERIFICATION.md ファイルを読み込み
要件カバレッジをチェック
クロスフェーズ配線用の統合チェッカーを起動
ギャップとテック負債を含む MILESTONE-AUDIT.md を作成

使用方法：/kata-audit-milestone

/kata-plan-milestone-gaps 監査で特定されたギャップを閉じるフェーズを作成します。

MILESTONE-AUDIT.md を読み込み、ギャップをフェーズにグループ化
要件優先度別に優先付け（必須/推奨/良い）
ROADMAP.md にギャップ解決フェーズを追加
新しいフェーズで /kata-plan-phase の準備完了

使用方法：/kata-plan-milestone-gaps

設定

/kata-customize Kata 出力形式をカスタマイズするため、テンプレートオーバーライドを管理します。

カスタマイズ可能なすべてのテンプレートをオーバーライド状態を含めてリスト表示
ローカル編集用のデフォルトテンプレートをコピー
オーバーライドを会話形式の変更で編集
必須スキーマに対してオーバーライドを検証

使用方法：/kata-customize 使用方法：/kata-customize list 使用方法：/kata-customize copy summary-template.md 使用方法：/kata-customize validate

/kata-configure-settings ワークフロートグルとモデルプロファイルを対話的に設定します。

リサーチャー、プランチェッカー、ベリファイアーエージェントをトグル
モデルプロファイルを選択（品質/バランス/予算）
.planning/config.json を更新

使用方法：/kata-configure-settings

/kata-set-profile <profile> Kata エージェント用のモデルプロファイルを素早く切り替えます。

quality — 検証以外すべてで Opus
balanced — 計画は Opus、実行は Sonnet（デフォルト）
budget — 作成は Sonnet、調査/検証は Haiku

使用方法：/kata-set-profile budget

ユーティリティスキル

/kata-help このスキルリファレンスを表示します。

/kata-whats-new インストール済みバージョン以降の変更内容を確認します。

インストール済みバージョンと最新バージョンの比較を表示
見逃したバージョンのチェンジログエントリを表示
破壊的な変更をハイライト表示
遅れた場合、更新手順を提供

使用方法：/kata-whats-new

ファイル & 構造

.planning/
├── PROJECT.md            # プロジェクトビジョン
├── REQUIREMENTS.md       # REQ-ID 付きスコープ付き要件
├── ROADMAP.md            # 現在のフェーズ分解
├── STATE.md              # プロジェクトメモリ & コンテキスト
├── MILESTONES.md         # 完了したマイルストーン履歴
├── config.json           # ワークフローモード & ゲート
├── templates/            # テンプレートオーバーライド（カスタマイズ出力形式）
├── research/             # ドメイン調査（プロジェクト初期化から）
├── issues/               # キャプチャされたアイデアとタスク
│   ├── open/             # 作業待ちの問題
│   └── done/             # 完了した問題
├── debug/                # アクティブなデバッグセッション
│   └── resolved/         # アーカイブされた解決済み問題
├── codebase/             # コードベースマップ（ブラウンフィールドプロジェクト）
│   ├── STACK.md          # 言語、フレームワーク、依存関係
│   ├── ARCHITECTURE.md   # パターン、レイヤー、データフロー
│   ├── STRUCTURE.md      # ディレクトリレイアウト、主要ファイル
│   ├── CONVENTIONS.md    # コーディング標準、命名
│   ├── TESTING.md        # テスト設定、パターン
│   ├── INTEGRATIONS.md   # 外部サービス、API
│   └── CONCERNS.md       # テック負債、既知の問題
├── milestones/           # アーカイブされたマイルストーン詳細
├── quick/                # クイックタスク計画とまとめ
│   └── NNN-slug/
│       ├── PLAN.md
│       └── SUMMARY.md
└── phases/
    ├── pending/          # 未開始のフェーズ
    │   └── 03-next-phase/
    │       └── 03-01-PLAN.md
    ├── active/           # 現在実行中のフェーズ
    │   └── 02-in-progress/
    │       ├── 02-01-PLAN.md
    │       └── 02-01-SUMMARY.md
    └── completed/        # 完了したフェーズ
        └── 01-foundation/
            ├── 01-01-PLAN.md
            └── 01-01-SUMMARY.md

ワークフローモード

/kata-new-project 中に設定：

対話型モード

各主要な決定を確認
承認のためにチェックポイントで一時停止
全体を通じてより多くのガイダンス

YOLO モード

ほとんどの決定を自動承認
確認なしで計画を実行
重大なチェックポイントでのみ停止

.planning/config.json を編集していつでも変更可能

計画設定

計画成果物が .planning/config.json でどのように管理されるかを設定：

planning.commit_docs（デフォルト：true）

true：計画成果物を git にコミット（標準ワークフロー）
false：計画成果物をローカルのみに保持、コミットしない

commit_docs: false 時：

.planning/ を .gitignore に追加
OSS 貢献、クライアントプロジェクト、または計画をプライベートに保つのに便利
すべての計画ファイルは通常通り機能し、単に git で追跡されない

planning.search_gitignored（デフォルト：false）

true：広幅 ripgrep 検索に --no-ignore を追加
.planning/ が gitignored で、プロジェクト全体の検索にそれを含める場合のみ必要

設定例：

{
  "planning": {
    "commit_docs": false,
    "search_gitignored": true
  }
}

一般的なワークフロー

新しいプロジェクトを開始：

/kata-new-project        # 統一フロー：質問 → 調査 → 要件 → ロードマップ
/clear
/kata-plan-phase 1       # 最初のフェーズの計画を作成
/clear
/kata-execute-phase 1    # フェーズ内のすべての計画を実行

休止後に作業を再開：

/kata-track-progress  # 中断したところを確認して続行

緊急なマイルストーン中盤作業を追加：

/kata-insert-phase 5 "Critical security fix"
/kata-plan-phase 5.1
/kata-execute-phase 5.1

マイルストーンを完了：

/kata-complete-milestone 1.0.0
/clear
/kata-add-milestone  # 次のマイルストーンを開始（質問 → 調査 → 要件 → ロードマップ）

作業中にアイデアをキャプチャ：

/kata-add-issue                    # 会話コンテキストからキャプチャ
/kata-add-issue Fix modal z-index  # 明示的な説明でキャプチャ
/kata-check-issues                 # 問題を確認して作業
/kata-check-issues api             # 領域でフィルター

問題をデバッグ：

/kata-debug "form submission fails silently"  # デバッグセッションを開始
# ... 調査が行われ、コンテキストが満たされます ...
/clear
/kata-debug                                    # 中断したところから再開

ヘルプを入手

プロジェクトビジョンについては .planning/PROJECT.md を読む
現在のコンテキストについては .planning/STATE.md を読む
フェーズステータスについては .planning/ROADMAP.md を確認
現在位置を確認するには /kata-track-progress を実行 </reference>

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

SKILL.md 本文