AgentSkillsCN

skill-requirement-expert

将用户的抽象性需求具体化,制定可落地实施的需求文档(requirements.md)。

SKILL.md
--- frontmatter
name: skill-requirement-expert
description: ユーザーの抽象的な要望を具体化し、実装可能な要件定義(requirements.md)を作成する。

Skill: Requirement Expert

Overview

このスキルは、ユーザーとの対話を通じて「何を作りたいか」を詳細に定義し、GitHub Issue を唯一の真実のソース(SSOT)として更新します。IDD(Issue-Driven Development)プロセスの最初期段階において、実装の前提となる要件を確定させる責務を持ちます。

重要: このスキルは GitHub Issue の本文(Body)のみを成果物とします。ローカルリポジトリ内のいかなるファイル(requirements.md、ログファイル等)も作成・更新してはなりません。

Capabilities

  1. Existing Issue Deep Dive: 既存のIssueの内容を分析し、不足している情報をインタビューで補完して GitHub Issue を更新します。
  2. New Issue Definition: 新しい機能や修正の要望をゼロからインタビューし、GitHub Issue を新規作成します。

Usage Guidelines

1. 引数(Issue ID)がある場合

  1. gh issue view [ID] でIssueの詳細を取得します。
  2. 背景、利用シーン、期待される要件、完了定義の4つの観点で不足している情報を特定します。
  3. ユーザーに1つずつ質問を行い、回答を深掘りします。
  4. 全ての情報を統合し、gh issue edit [ID] --body "..." を用いてGitHub Issueの本文を最新の要件で更新します。
  5. 注意: ローカルファイル(docs/issues/ 下のファイル等)への書き出しは一切行わないでください。

2. 引数がない場合

  1. 「どのような機能や改善を検討されていますか?」という問いかけからスタートします。
  2. 以下の項目を対話形式で埋めていきます。
    • Background: なぜそれが必要か。
    • User Story: 誰が、いつ、どのように使うか。
    • Success Criteria: どのような状態になれば「完了」か。
  3. 情報を整理し、ユーザーの承認を得た後、gh issue create --title "..." --body "..." でGitHub Issueを新規作成します。
  4. 作成されたIssueのURLを提示します。

Interview Rules

  • 一度に全ての質問を投げず、チャットの特性を活かして1つずつ丁寧に深掘りしてください。
  • ユーザーが「おまかせ」と言った場合でも、プロジェクトの AGENTS.md や既存アーキテクチャに基づいた「最適な提案」を行い、承認を得る形で進めてください。
  • インタビューの過程や結果をローカルのログファイルに記録してはいけません。