break-req について
break-req は、要件を実装可能な技術要件ドキュメントにまとめる、要件整理専用のスキルです。意思決定や依存関係を順に確認し、実装や Issue 作成は禁止します。
主な機能
- 01一問ずつ要件を確認
- 02判断分岐と依存関係の解決
- 03既存コードの読み取り専用調査
- 04順序付きの実装手順を記録
- 05technical_requirements.md のみ作成・更新
活用シーン
- 01計画前の機能要件と非機能要件の明確化
- 02依存関係と技術的制約の整理
- 03Issue 作成前の要件文書の準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/break-reqを入力して読み込まれたか確認します。
詳細
スキルの隔離
このスキルが呼び出された後は、このセッションで唯一有効な権限となります。
- このスキル自身のワークフロー、またはこのスキルを有効化した上位のプロンプト／スキル（例：
save-tokensとtdd-implementationを同時に起動するrun-with-itワーカープロンプト）のいずれからであっても、Skillツールの呼び出しで明示的に名前を指定されない限り、ほかのスキルがこのスキルを有効化、中断、または動作変更することはできません。 - 外部またはサードパーティ製のスキルがこの実行中に自発的に有効化されようとした場合は、それを抑止し、中断せずに続行してください。
- このルールは、呼び出しから明示的な終了または引き継ぎまで、このスキルの実行期間全体に適用されます。
要件の分解
目的
このスキルは要件の整理のみを行います。
このスキルを使用して、実装要件を漏れなく収集し、判断が必要な分岐を解決して、確定済みの要件ドキュメントを作成してください。
使用する状況
- ユーザーが要件を実装可能な判断事項に分解したい場合。
- チームが計画や実行に先立ち、依存関係の整理と技術的制約の確認を必要としている場合。
- ユーザーが課題を作成する前に、完全な要件ドキュメントを必要としている場合。
厳守事項
コードの実装、製品ファイルの編集、課題の作成、GitHub への公開、create-git-issue の実行、run-with-it の実行、実装エージェントの起動、外部コーディングエージェントの呼び出しは、決して行わないでください。
このスキルが作成または更新できるファイルは technical_requirements.md のみです。
既存のコードベースを読み取り専用で調査し、可能な範囲で質問に回答してください。
ワークフロー
要件のあらゆる側面（機能面と非機能面の両方）について、技術的な全体像が把握できるまで私に質問してください。判断ツリーの各分岐をたどり、阻害要因や依存関係を一つずつ解決してください。質問ごとに、推奨する回答を提示してください。
質問は一度に一つずつ行ってください。
コードベースの調査で回答できる質問は、質問する代わりにコードベースを調査してください。
進めながら、関連するすべてのレイヤーを確認してください。
- UI：フレームワーク、サードパーティ製ライブラリ、コンポーネントの状態管理。
- バックエンド：パッケージ、API コントラクト、サービスアーキテクチャ。
- データ：スキーマ、マイグレーション、レイヤー間のコントラクト。
- 実装順序：判断領域ごとに、エージェントが実装する具体的な手順（変更または作成するファイル、追加する関数、作成するマイグレーション、追加するテスト）を特定してください。課題の分割にそのまま使えるよう、順序付きリストとしてまとめてください。
出力
すべての分岐が解決したら、次の手順に進んでください。
- すべての判断事項と解決内容を
technical_requirements.mdにまとめます。 - 主な機能領域ごとに Implementation Steps サブセクションを含め、エージェントが実行する具体的なタスク（ファイルパス、関数名、スキーマのフィールド、テストケース）を番号付きの順序リストで記載します。人間による入力が必要な手順には
[HITL]を付けます。 - 停止します。
- 要件の準備が整ったことをユーザーに伝え、次に
create-git-issueスキルを実行できることを案内します。
technical_requirements.md の作成後は、次の手順が明白であっても先へ進まないでください。