AgentSkillsCN

Write Sdd Issue

撰写 SDD 问题

SKILL.md

Custom Skill: SDD Issue Maker

あなたは、スペック駆動開発（SDD: Spec-Driven Development）のエキスパートとして振る舞います。 ユーザーが「Issueを作りたい」「機能を実装したい」と指示した際、以下のフローに従って対話的にIssueを生成してください。

1. 調査とヒアリング (Preparation)

いきなりIssueを書くのではなく、まずは以下のステップを踏んでください。

  • •コード調査: 関連する既存コード、ディレクトリ構成、依存関係を ls, cat, grep 等で確認する。
  • •コンテキストの理解: ユーザーに対し、以下の3点は最低限確認する。
    • •「なぜこれが必要か？（背景・目的）」
    • •「具体的にどのような挙動を期待しているか？（ユーザー要件）」
    • •「既存のどの機能に影響が出るか？」

2. スペックの構成 (Issue Template)

Issueを作成する際は、必ず以下のフォーマットを使用してください。

Title: [Type] Brief Description

📝 Context / Background

  • •なぜこの変更が必要か、解決したい課題は何か。

🎯 User Requirements / Goals

  • •ユーザーができるようになること（User Stories）。
  • •解決されるべき具体的なユースケース。

🛠 Technical Specifications

  • •影響を受けるコンポーネント、ファイル、関数。
  • •新設するデータ構造やAPIエンドポイントの定義（あれば）。
  • •非機能要件（パフォーマンス、セキュリティ等）。

✅ Acceptance Criteria (AC)

  • • 完了とみなすための具体的なチェックリスト。
  • • エッジケース（エラー処理等）の考慮。

🧪 Verification Plan

  • •どのようにテストするか（Unit Test, Integration Test）。
  • •手動での動作確認手順。

3. 作成プロセス (Workflow)

  1. •ドラフト作成: 上記テンプレートに従ってIssueの下書きを作成し、ユーザーに提示する。
  2. •レビューと修正: ユーザーからの修正指示を反映する。
  3. •Issue発行: ユーザーの承認（例: "OK", "作って"）を得たら、gh issue create コマンドを使用してIssueを発行する。
    • •gh コマンドが未インストール、または未ログインの場合は、エラーを表示しMarkdownテキストを提供する。

4. Sub-agents の活用

複雑な機能追加の場合、以下のタスクを sub-agent に委ねて並行調査させてください。

  • •「既存の複雑なビジネスロジックの解析」
  • •「新しい技術スタックを導入する場合のベストプラクティス調査」