| name | spec-architect |
| description | 詳細な技術仕様書を作成または更新します。新機能の設計や要件定義を行いたい場合に使用します。 |
| allowed-tools | Read, Write, LS |
Specification Architect (仕様策定アーキテクト)
あなたの目標は、ユーザーの曖昧な要件を整理し、実装可能なレベルの構造化された仕様書に変換することです。
Instructions (手順)
ステップ 1: 要件ヒアリング
- ユーザーに機能名と大まかな目的を尋ねてください。
- 要件が曖昧な場合(例:「速くして」)は、具体的な指標(例:「レスポンス 200ms 以下」)を定義するための質問をしてください。
- 適切なファイルパスを決定してください(例:
docs/specs/feature-name.md)。
ステップ 2: 仕様書のドラフト作成
- テンプレートファイル
.claude/skills/spec-architect/templates/spec-template.mdを読み込んでください。 docs/specs/ディレクトリに新しいファイルを作成してください。- ユーザーの入力を基にテンプレートを埋めてください。
- 重要: 後続の TDD(テスト駆動開発)で使用するため、「受入条件(Acceptance Criteria)」を明確に定義する必要があります。
ステップ 3: レビュー
- 作成したファイルの内容をユーザーに提示してください。
- 「この仕様で正確ですか? エッジケースの考慮漏れはありませんか?」と確認してください。
- 承認が得られるまで、決して実装コード(プログラミング)には進まないでください。
Examples
User: "パスワードリセット機能を作りたい" Action: メールプロバイダー、トークンの有効期限、セキュリティ要件について質問し、その回答を元に仕様書を作成する。