SuperAPI AI 工具集

to-spec

通用与其它

查看项目

更新于 10-15 20:09

技能介绍

用途:把明确需求整理为 cooking spec,仅由用户显式调用 to-spec 或 rush 编排触发。不拆任务、不改业务代码;explore 不是前置,没有 goal.md 也可写 spec。若需求尚不能写成可判定验收标准,应停止并建议先 explore。

主要能力与用法:按 common.md 的「前置检查」与标识命中规则执行。命中标识时写该单位,标识后文本作为需求描述;未命中且参数非空时,纯 kebab-case 视为新标识,否则整段作为需求生成新 slug;参数为空时按已有 cooking 数量决定新开或询问。输入优先级为本次需求描述 > 已确认 goal.md > 对话中已说清的需求。按 spec-template.md 写 spec.md,不增删标题;验收标准必须可判定,禁止「体验好」「尽量完善」等表述。「影响文件」按 impact-files.md 写仓库相对路径或 glob,每行一条并用反引号包裹,至少一条新增或修改,无删除则省略删除行,不写模块名。写完运行 node .agents/scripts/spec-files.mjs parse .agents/cooking/<feature>/spec.md,失败需改到通过。「架构影响」在此判定,代码类逐条查看新增路径首层目录是否在 CODE-MAP.md 模块表下,区分新模块与架构级变更,非代码写无。

限制:定到某单位后若总览「下一步」为 explore 则停止;该单位已有 tasks/ 时提醒重新 to-tasks,不在本技能删 tasks;「架构影响」非无时先跑 sync-docs 再 to-tasks,否则请用户显式调用 to-tasks。均不自动继续。费用、价格、平台等信息暂未提供。