bro-give-me-spec について
何をなぜ変更するか、完了をどう確認できるかを定め、実装方法は指定しない仕様を作成するスキルです。不明点をユーザーと解消し、利用可能なツールに応じてワークフローを選びます。
主な機能
- 01目標と観察可能な受け入れ基準の定義
- 02目標と実装方法の分離
- 03ユーザーとの製品上の曖昧さの解消
- 04利用可能なツールに応じたワークフロー選択
活用シーン
- 01実装前の機能仕様の作成
- 02変更範囲と期待する結果の明確化
- 03変更の受け入れ基準の定義
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ irpsv/ ai-bro --skill bro-give-me-specインストール後、Claude Code で/bro-give-me-specを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/trigger-evals.jsonreferences/dialog-rules.mdspec-review.mdspec-template.mdsubagent-model-tiers.mdreferences/workflows/create-plan.mdfile-spec.mdsubagents/closer-prompt.md詳細
Bro Give Me Spec
あなたのタスクは、結果の仕様を作成することです。何を、なぜ変更するのか、また結果が完成したと判断できる観察可能な条件を明確にし、実装方法は定めないでください。 コードを書かないでください。実装手順も作成しないでください。
一般ルール
- 対話ルールを必ず守ってください!
- 作業手順を必ず守り、違反しないでください!
- 仕様はバリエーションや未解決の質問がなく、一意に定まるものでなければなりません。プロダクト上の曖昧さは、人間と相談して解決する必要があります。
- 受け入れ基準は、目標とする結果を観察可能な記述で網羅しなければなりません。検証方法(自動テスト、手動確認、ビルドなど)を基準に記載してはいけません。
- 仕様は、テストや実装の作成順序を定めず、TDD も要求しません。
制約/STOP
- 仕様に、手順、段階、実行者のタスク、選択したソリューションのアーキテクチャ、コード、diff、パッチ、擬似コード、作成または変更するファイルの指示を追加することは禁止です。既存のパス、型、メソッドは、現在の状態を示す根拠として「タスクとコンテキスト」および「目標とする結果」に記載できますが、修正方法として記載してはいけません。
- テンプレートの構成を超えるセクションの追加は禁止です。
採用した決定事項セクションを追加できるのは、合意事項が記録されている場合のみです。 - 事実や基準を創作することは禁止です。結果、範囲、受け入れに関する曖昧さは、仕様が完成する前に解消しなければなりません。
- 人間がパスを明確に指定するまで、仕様ファイルを書き込むことは禁止です。現在のリクエストで指定されたパスは、すでに回答として扱います。再度尋ねないでください。指定されたパスにファイルがすでに存在する場合、更新への明示的な承認なしに更新することは禁止です。
CreatePlan(または同等のツール)が利用可能な場合、保存先のパスを尋ねたり、ツールを呼び出さずに自分で仕様ファイルを書いたりすることは禁止です。- 実装計画や、仕様の次のステップとして
/bro-give-me-planを提案することは禁止です。 - 仕様が作成され、レビューに合格したら、次のステップをちょうど1つだけ案内してください:
/bro-do-it。次のステップの一覧を提示しないでください。
作業手順
- コードとコンテキストから、現在の状態、目標とする結果、範囲、検証を明確に記述するために必要な情報を収集してください。
- 不足している情報を人間に尋ねてください。対話ルールを必ず守ってください。必要に応じて、合意済みの分岐を
採用した決定事項セクション用にまとめてください。 - 目標とする結果に含まれる変更対象のシナリオがすべて受け入れ基準で網羅されていること、また各基準が検証方法を記述せずに観察可能であることを確認してください。
- ワークフローの決定ルールに従って、使用するワークフローを決定してください。
- 選択したワークフローの手順ファイルを読み込んでください。選択したワークフローのすべての指示に従ってください。
ワークフローの決定ルール
以下に、使用するワークフローの決定ルールを示します。 ワークフローを選択する前に、手順ファイルを読まないでください。 基準に基づいてワークフローを選択してください。
create-plan
次の場合に使用してください:
- 現在のセッションで
CreatePlan(または計画作成用の同等の harness ツール)が利用可能
このワークフローを選択した場合、保存先のパスを尋ねないでください。
手順ファイル:create-plan
file-spec
次の場合に使用してください:
CreatePlan(または同等のツール)が利用できない
手順ファイル:[file-spec](./references/workflows/file-spec.md]
コメント
Markdown 対応