AgentSkillsCN

spec-promote-ready

将待办事项中的需求构想升格为可立即着手实施的 Spec（Ready），并更新 specs/NNN_feature/spec.md，同时更新 specs/INDEX.md。不进行实际的实现，仅完成文档撰写与索引更新。适用于用户希望将待办事项中的需求构想提升为 Ready 状态，以便于后续实施时使用。

SKILL.md
--- frontmatter
name: spec-promote-ready
description: 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.

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/<slug>.md
  • •Feature folder: <NNN>_<feature>（未指定なら提案して。例: 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/<slug>.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

作成/更新したファイル一覧を箇条書きで出力して終了する。