quick-spec

轻量级变更规范,适用于小型变更、配置调优、微调,产出精简的变更说明。

SKILL.md

GitHub

quick-spec — 轻量级变更规范

技能目的

为小型变更、配置调优、微调等不需要完整 SRS 流程的场景,产出精简的变更说明文档,确保变更可追溯但不增加不必要的文档负担。

参数说明

本技能无参数。通过交互式问答收集变更信息。

分阶段工作流

阶段 1:评估变更范围

  • 输入:用户交互
  • 处理:
    1. 通过 AskUserQuestion 询问变更目标与影响范围
    2. 评估是否确实属于轻量级变更(单模块、无架构影响、无数据迁移)
    3. 若超出轻量级范围,建议改用 /requirement-spec
  • 输出:变更范围评估结果

阶段 2:收集变更细节

  • 输入:变更范围
  • 处理:
    1. 询问变更原因、预期效果、涉及文件
    2. 使用 Grep 搜索可能受影响的现有代码或配置
  • 输出:变更细节清单

阶段 3:生成变更说明

  • 输入:变更细节清单
  • 处理:使用 Write 生成 docs/changes/{变更名}.md,包含:变更摘要、原因、影响范围、验收标准、回滚方案
  • 输出:变更说明文件

协作协议引用

  • 遵循 .claude/docs/templates/collaborative-protocols/design-agent-protocol.md 轻量级变更规范

推荐下一步

直接进入开发阶段实现变更,或使用 /create-stories 将变更分解为用户故事。