spec-promote-ready
BacklogのIdeaを、実装着手可能なSpec(Ready)として specs/NNN_feature/spec.md に昇格し、specs/INDEX.md を更新する。実装は行わず、ドキュメント作成と索引更新のみを行う。Use when the user wants to promote a backlog idea to Ready status for implementation.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Spec: Promote Idea -> Ready
BacklogのIdeaを、実装着手可能なSpec(Ready)として specs/NNN_feature/spec.md に昇格し、specs/INDEX.md を更新する。実装はしない。
Goal
実装前に、要件・仕様(WHAT/WHY)と受け入れ条件を明確化し、エージェントが参照できる形にする。
Inputs (ユーザーが埋める)
- Source Idea: specs/000_backlog/.md
- Feature folder: <NNN>_(未指定なら提案して。例: 012_csv_export)
- 追加で確定させたい仕様: <あれば>
- 受け入れ条件として必ず入れたい観点: <あれば>
Rules
- 実装はしない(ドキュメント作成と索引更新のみ)
- HOW(実装計画、設計、影響範囲、技術選定、コード)は spec.md に書かない
- Requirements は FR-001 形式で番号を振り、MUST/SHOULDで曖昧さを減らす
Steps
1. Choose next feature number
-
specs/配下のNNN_をスキャンし、次の番号を提案する(欠番は埋めない)
2. Create feature folder + spec
-
specs/<NNN>_<feature>/spec.mdを作成する - 先頭にメタ情報(Markdown)を必ず入れる:
- Title: <Title>
- Status: Ready
- Created: <YYYY-MM-DD>
- Last updated: <YYYY-MM-DD>
- Source: ../000_backlog/.md
Body template (HOW禁止)
- Goal(1〜2文)
- Non-goals
- User Scenarios & Testing(Given/When/Then を最低3つ、可能なら5つ)
- Edge Cases
- Requirements
- Functional Requirements(FR-001, FR-002...)
- Non-functional Requirements(必要なら)
- Open Questions(任意)
3. Update INDEX
-
specs/INDEX.mdの Ready セクションの先頭にspecs/<NNN>_<feature>/spec.mdを追加する - 行をReadyへ移動し、Idea側は削除する
4. Output
作成/更新したファイル一覧を箇条書きで出力して終了する。
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!