用途:为不需要完整 GDD 的小改动提供轻量设计规格路径。适用于约一周实现工作量以内的工作,包括调参、少量行为调整、对现有系统的小补充,或小到不值得写完整文档的独立功能。若改动引入带大量跨系统依赖的新系统、超过一周工作量或根本改变现有系统核心规则,应改用 /design-system。
主要能力:先对改动分类(Tuning、Tweak、Addition、New Small System),做上下文扫描(读取 design/gdd/ 中最相关的 GDD、design/gdd/systems-index.md、design/quick-specs/ 中先前的规格,Tuning 还检查 assets/data/ 中的数据文件),然后按分类使用对应格式起草规格,最后经用户批准写入 design/quick-specs/[name]-[date].md。
使用方式:触发后可用参数描述改动,否则会提示用户以纯文本描述。通过 AskUserQuestion 确认分类;呈现草稿后询问批准、修改还是重定向到 /design-system;批准后询问是否写入指定路径文件。如需更新 GDD,会单独询问并先展示新旧文本,未经明确批准不改动 GDD。完成后输出文件路径、类型、系统及 GDD 更新状态。
适用场景:调参、微调、对现有系统的小补充、独立小系统。
限制:Quick Design Spec 按设计绕过 /design-review 和 /review-all-gdds。若改动新增应进入 systems index 的系统、显著改变跨系统行为或系统契约、引入影响 MDA 美学平衡的新玩家机制,或实现可能超过一周,应重定向到完整流程。文件名用当天日期与 kebab-case 标题。多数调参为小时级,一周上限针对 New Small System。调用 AskUserQuestion 时遵循 .claude/docs/automation-modes.md。