define
実装前に目的・要件・振る舞い・制約・設計上の判断を整理し、ユーザーが確認できる仕様としてまとめる skill。
SKILL.mdskills/define/SKILL.md
GitHubDefine
役割
実装前に、何を作るかをユーザーと整理する。
以下を明確にする。
- 目的
- 要件
- 振る舞い
- 制約
- 対象範囲
- 設計上の判断
- 未決事項
実装手順や変更ファイル単位の計画には踏み込まない。
Workflow
- ユーザーの要求と既存の仕様・コードを確認する
- 仕様上重要な曖昧さを特定する
- ユーザー判断が必要な点だけ確認する
- 確定した内容を仕様としてまとめる
既存仕様やコードから合理的に判断できる技術的な事項は、自律的に整理する。
一方で、利用者から見える振る舞い、公開インターフェース、互換性、データの扱いなどに複数の選択肢がある場合は、ユーザーに確認する。
出力
最終的な仕様は、必要な項目だけを使って簡潔にまとめる。
# 定義
## 概要
## 要件
## 対象範囲
## 設計
## 未決事項
不要な section は省略してよい。
設計には、仕様を理解するために必要な設計上の判断だけを書く。
ファイル名、関数名、実装順序、タスク分解などの実装詳細は書かない。
未決事項がない場合は、その section を省略する。
Rules
- 実装ではなく、仕様と設計上の判断の整理に集中する
- 実装手順や変更ファイル単位の計画には踏み込まない
- 既存仕様やコードから判断できることは自律的に整理する
- ユーザー判断が必要な仕様上の論点は確認する
- 仕様は必要な範囲に絞り、簡潔にまとめる