Skill: Requirement Expert
Overview
このスキルは、ユーザーとの対話を通じて「何を作りたいか」を詳細に定義し、GitHub Issue を唯一の真実のソース(SSOT)として更新します。IDD(Issue-Driven Development)プロセスの最初期段階において、実装の前提となる要件を確定させる責務を持ちます。
重要: このスキルは GitHub Issue の本文(Body)のみを成果物とします。ローカルリポジトリ内のいかなるファイル(requirements.md、ログファイル等)も作成・更新してはなりません。
Capabilities
- •Existing Issue Deep Dive: 既存のIssueの内容を分析し、不足している情報をインタビューで補完して GitHub Issue を更新します。
- •New Issue Definition: 新しい機能や修正の要望をゼロからインタビューし、GitHub Issue を新規作成します。
Usage Guidelines
1. 引数(Issue ID)がある場合
- •
gh issue view [ID]でIssueの詳細を取得します。 - •背景、利用シーン、期待される要件、完了定義の4つの観点で不足している情報を特定します。
- •ユーザーに1つずつ質問を行い、回答を深掘りします。
- •全ての情報を統合し、
gh issue edit [ID] --body "..."を用いてGitHub Issueの本文を最新の要件で更新します。 - •注意: ローカルファイル(
docs/issues/下のファイル等)への書き出しは一切行わないでください。
2. 引数がない場合
- •「どのような機能や改善を検討されていますか?」という問いかけからスタートします。
- •以下の項目を対話形式で埋めていきます。
- •Background: なぜそれが必要か。
- •User Story: 誰が、いつ、どのように使うか。
- •Success Criteria: どのような状態になれば「完了」か。
- •情報を整理し、ユーザーの承認を得た後、
gh issue create --title "..." --body "..."でGitHub Issueを新規作成します。 - •作成されたIssueのURLを提示します。
Interview Rules
- •一度に全ての質問を投げず、チャットの特性を活かして1つずつ丁寧に深掘りしてください。
- •ユーザーが「おまかせ」と言った場合でも、プロジェクトの
AGENTS.mdや既存アーキテクチャに基づいた「最適な提案」を行い、承認を得る形で進めてください。 - •インタビューの過程や結果をローカルのログファイルに記録してはいけません。