Search

PythonReactSEOPDF
GitHub Skill

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.

shibasab☆ 0 Repository stars0 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill 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禁止)
  1. Goal(1〜2文)
  2. Non-goals
  3. User Scenarios & Testing(Given/When/Then を最低3つ、可能なら5つ)
  4. Edge Cases
  5. Requirements
    • Functional Requirements(FR-001, FR-002...)
    • Non-functional Requirements(必要なら)
  6. 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)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!