spec-kit-analyse について
spec-kit-analyse は、タスクリスト作成後に変更成果物を読み取り専用で整合性分析するスキルです。仕様・計画・タスク・コード・プロジェクト規則を照合し、網羅性や矛盾、曖昧さ、未解決のリスクを重大度別に報告します。
主な機能
- 01変更成果物を編集せずに分析
- 02要件とストーリーの網羅性を確認
- 03順序の問題・曖昧さ・用語のずれを検出
- 04計画の主張を既存コードと照合
- 05重大度別の構造化された指摘を報告
活用シーン
- 01実装前に全要件がタスクに含まれるか確認
- 02計画・コード・プロジェクト規則間の矛盾を発見
- 03変更成果物のリスクと未解決の判断を評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ aircury/ ai-framework --skill spec-kit-analyseインストール後、Claude Code で/spec-kit-analyseを入力して読み込まれたか確認します。
詳細
翻訳後に原文が更新されています。最新の内容は原文をご確認ください。
タスクリストの生成後に、読み取り専用の整合性分析を実施します。
入力:必要に応じて変更名を指定します。省略した場合は、文脈から推測するか、確認します。
このスキルはファイルを変更しません。
手順
-
成果物を読み込む
specs/changes/<name>/にある変更成果物を読み込みます。spec.md(必須)plan.md(必須)tasks.md(必須)
tasks.mdが存在しない場合は、先にspec-kit-tasksスキルを使用するよう促します。また、準拠すべき原則の基準として FRAMEWORK.md も読み込みます。
-
整合性を確認する
次の観点に沿って分析します。
観点 確認内容 網羅性 spec.md のすべてのユーザーストーリーに、tasks.md の対応するタスクがあるか 整合性 計画のアーキテクチャが、仕様の目標や制約に合致しているか FRAMEWORK.md への準拠 依存関係のルール違反がないか、貧血ドメインモデルになっていないか、外部依存に対するポートが存在するか 重複 要件やタスクが重複していないか 曖昧さ 測定可能な基準のない曖昧な用語がないか 用語の不一致 同じ概念が成果物ごとに異なる名称で呼ばれていないか 孤立項目 対応する要件のないタスクや、対応するタスクのない要件がないか -
指摘事項を提示する
構造化された指摘事項の表を出力します。
## Analysis: <change-name> ### Findings | ID | Severity | Dimension | Description | Location | |----|----------|-----------|-------------|----------| ### Coverage Summary | Requirement | Task IDs | |-------------|----------| ### FRAMEWORK.md Violations <List any violations. CRITICAL severity — must be fixed before proceeding.> ### Metrics - Total findings: N - Critical: N | High: N | Medium: N | Low: N ### Recommended Next Actions <Ordered list of what to fix.>重大度:CRITICAL(FRAMEWORK.md 違反)> HIGH > MEDIUM > LOW
出力
分析後:
- CRITICAL の指摘事項がある場合:「次に進む前に FRAMEWORK.md 違反を修正してください。解決するまで
spec-kit-implementスキルは使用しないでください。」 - CRITICAL の指摘事項がない場合:「検証済みのタスクリストを実行するには、
spec-kit-implementスキルを使用してください。」
ガードレール
- 読み取り専用です。ファイルは決して変更しません。
- FRAMEWORK.md 違反は常に CRITICAL とし、重大度を下げたり、無視したりしてはいけません。
- 決定論的であること:同じ成果物を再実行して分析した場合、同じ指摘事項が生成されます。
コメント
Markdown 対応