| name | spec-format |
| description | 仕様書の新規作成・更新を所定のテンプレートと記述規約に沿って行うスキル。USE WHEN: ユーザが「仕様書を書いて」「スペックを作って」「spec を書いて」「仕様をまとめて」「設計書を作成」「実装仕様を起こして」「機能仕様を定義して」「FEATURE_NAME.md を作って」など、仕様書・設計書の作成や更新を依頼したとき。spec/agent/ 配下のファイルを扱うときも必ず参照すること。 |
仕様書構成様式スキル
仕様書を spec/agent/ 配下に統一フォーマットで作成・管理するためのスキル。
ファイル配置ルール
| 状態 | 配置先 |
|---|
| 新規執筆・着手中 | spec/agent/wip/local_{連番}/FEATURE_NAME.md |
| 完了済み | spec/agent/complete/local_{連番}/FEATURE_NAME.md |
- ファイル名は大文字スネークケース (
FEATURE_NAME.md)
- 連番は既存ディレクトリを確認し、次の番号を採番する
- 実装完了後は
wip → complete にディレクトリごと移動する
テンプレートの使い方
仕様書を作成する際は references/template.md を読み込み、テンプレートに沿ってセクションを埋める。
read references/template.md from this skill directory
テンプレートの各セクションにあるガイドコメント (<!-- ... -->) は出力に含めない。
記述規約
- 用語定義: 表形式で統一する
- コード例: 実装言語のコードブロック (
typescript, rust など) で記載する
- 性能要件・期待効果: 表形式で定量的に記載する (曖昧な「高速化」ではなく、具体的な数値目標を書く)
- チェックリスト: タスク完了後に
[x] で更新する
- 事実と仮説の区別: 検証済みの事実と未検証の仮説を明確に書き分ける
ワークフロー
- ユーザの要件を把握し、機能名を決定する
spec/agent/wip/ 配下の既存ディレクトリを確認し、次の local_{連番} を決める
- テンプレートを読み込み、各セクションを埋める
- 対象ファイルの変更種別 (新規 / 修正 / 削除) を明記する
- チェックリストに実装タスクを列挙する
- ユーザにレビューを依頼する