write-spec

korallis 的头像作者 korallis

根据需求编写详细的功能规范。在成型后使用,创建spec.md,包含目标、用户故事、需求和技术方法。

📖 中文导读:根据需求编写详细的功能规范。在成型后使用,创建spec.md,包含目标、用户故事、需求和技术方法。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: write-spec description: Write a detailed feature specification from requirements. Use after shaping to create spec.md with goals, user stories, requirements, and technical approach.

Write Spec

Create a comprehensive specification document from gathered requirements.

When to Use

  • Requirements are gathered in planning/requirements.md
  • Ready to document the technical specification
  • Need a clear spec before task breakdown

Workflow

  1. Analyze Inputs

    • Read amp-os/specs/[feature]/planning/requirements.md
    • Review any visuals in planning/visuals/
    • Load relevant standards skills
  2. Search for Reusable Code

    • Use finder to locate similar implementations
    • Document patterns to reuse
    • Note existing components to leverage
  3. Write Specification

    • Follow template exactly from spec-template.md
    • Save to amp-os/specs/[feature]/spec.md
  4. Generate Architecture Diagram

    • Load amp-os-architecture-diagrams skill
    • Create system/component diagram with mermaid
  5. Verify Spec Quality

    • Load amp-os-spec-verifier skill
    • Ensure completeness and feasibility

Important Constraints

  • Do NOT write actual code in spec.md
  • Keep sections concise and skimmable
  • Reference visual assets when available
  • Follow template structure exactly

Resources

Amp Tools to Use

  • finder - Find similar implementations
  • mermaid - Architecture diagrams
  • oracle - Review spec for completeness