Menu
新機能の仕様書を docs/spec/ 配下に作成する。実装詳細を含めない純粋な仕様（目的・振る舞い・ルール・境界）に絞ってマークダウン化する。「仕様書作って」「spec 書いて」「〜の仕様まとめて」などで起動。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
docs/spec/ の仕様書を元に、docs/work/YYYYMMDD_<feature>.md として実装計画書を作成する。Phase 分解・影響範囲・テスト戦略・リスクを構造化し、実装前にユーザー承認を取る。「実装計画立てて」「work 書いて」「どう進めるか計画して」などで起動。
差分や指定コードを構造化されたレビュー観点（正確性・設計・テスト・可読性・セキュリティ）で読み、優先度付きで指摘する。修正は提案するが勝手に書き換えない。「レビューして」「コードレビュー」「セカンドオピニオン」などで起動。
未知のコードベースを最短で把握するための構造化探索を行う。言語・ビルドツール・アーキテクチャ・テスト方針・主要なエントリポイントを短時間でレポート化する。「このプロジェクト教えて」「コードベース調べて」「初見で入ったから概要ほしい」などで起動。
未コミットの変更を依存関係と関心事に基づいて適切な粒度のコミットに分割する。自動生成物・手動実装・テスト・ドキュメントを分離し、レビューしやすい履歴を作る。「コミット分けて」「良い粒度でコミット」「この変更コミットにして」などで起動。
バグ調査を場当たり的でなく体系的に進める。再現→仮説→検証→修正→回帰テストの順序を守り、仮説と事実を分けて記録する。「バグ調査して」「なぜか動かない」「デバッグ手伝って」などで起動。
汎用的な開発オーケストレーター。docs/spec/ の仕様と docs/work/ の実装計画書を軸に、Phase 分解と PDCA サイクルで実装を進める。自分は実装せず、各 Phase を Task で専門 agent / Explore / Plan に委託する。「開発進めて」「実装オーケストレートして」「機能実装して」などで起動。
| name | backend-spec-creator |
| description | 新機能の仕様書を docs/spec/ 配下に作成する。実装詳細を含めない純粋な仕様（目的・振る舞い・ルール・境界）に絞ってマークダウン化する。「仕様書作って」「spec 書いて」「〜の仕様まとめて」などで起動。 |
新機能の仕様書を docs/spec/ 配下に作成する汎用スキル。
仕様書は「何を作るか」を書く場所。「どう作るか」は書かない。
仕様書は実装言語を変えても有効である、というのが指標。
ユーザーに以下を順番に確認（不明なら質問。自明なら省略）:
docs/spec/
├── <feature-name>-spec.md シンプルな機能
└── <domain>/ 大きな領域は配下にまとめる
├── <sub-feature>-spec.md
└── overview.md
命名規則:
<name>-spec.md既存の docs/spec/ 構成を確認して、慣習に合わせる。
# <機能名> 仕様
## 1. 概要
### 目的
<なぜこの機能が必要か。ユーザー / ビジネス価値。>
### スコープ
- 含む: <箇条書き>
- 含まない: <箇条書き>
## 2. 用語定義
| 用語 | 定義 |
| --- | --- |
| <term> | <意味> |
## 3. 主要な振る舞い
### 3.1 <ユースケース名>
- **トリガー**: <いつ起きるか>
- **入力**: <必要な情報>
- **処理の流れ**:
1. ...
2. ...
- **結果**: <成功時の状態変化 / 出力>
- **関連ルール**: [4. ビジネスルール](#4-ビジネスルール) の R-XX
### 3.2 ...
## 4. ビジネスルール
- **R-01**: <ルール本文>
- **R-02**: <ルール本文>
各ルールには一意な ID を振る（後から実装・テストで参照できるように）。
## 5. 状態・ライフサイクル
<該当する場合のみ。Mermaid stateDiagram 推奨>
```mermaid
stateDiagram-v2
[*] --> Draft
Draft --> Active
Active --> Archived
| 条件 | 振る舞い |
|---|---|
| <条件> | <期待される振る舞い> |
<該当する場合のみ: パフォーマンス、セキュリティ、可用性>
### 4. 書くときの注意
- **ルール ID を必ず振る**。後続の実装・テスト・レビューで参照する
- **例を入れる**。抽象的な説明だけだと誤解される
- **「こうあるべき」ではなく「こうである」で書く**。仕様は決定事項
- **未決定は明示的に「未決定」と書く**。埋めるために推測しない
- **実装者への指示を書かない**（「～を実装すること」という文体は避ける）
### 5. 生成後の確認
- ユーザーに内容を提示して承認を得る
- 特に「オープン課題」セクションの扱い（空にすべきか、明示的に列挙すべきか）を確認
- 承認後に `docs/spec/` に書き込む
## いつ使わないか
- 既存仕様の軽微な修正 → `backend-spec-updater` を使う
- 実装計画書を書きたい → `backend-work-planner` を使う
- デバッグや調査 → 別スキル
## 関連
- [backend-spec-updater](../backend-spec-updater/SKILL.md) — 既存仕様の更新
- [backend-work-planner](../backend-work-planner/SKILL.md) — 仕様を元に実装計画書を作成