SuperAPI AI 工具集

to-spec

编程与开发

查看项目

更新于 10-28 16:12

技能介绍

用途:该技能用于将当前对话上下文与代码库理解综合成一份需求规格,并发布到项目 issue 跟踪器。它明确要求不对用户进行访谈,只总结已经讨论过的内容。

主要能力:

  • 探索仓库以了解代码库现状;在规格中沿用项目领域词汇表,并遵循相关 ADR。
  • 在规格编写阶段调用 /principles,将已接受的设计与编码约束带入现有实现和测试决策;未解决的冲突保留为阻塞项,而不是自行发明决定或再发起访谈。
  • 规划测试接缝(seams):优先复用现有接缝,尽量选择最高层级的接缝,并尽量减少接缝数量;如需要新接缝,应提出尽可能高层的方案,并与用户确认是否符合预期。
  • 按固定模板撰写规格,包含:问题陈述(从用户视角描述问题)、解决方案(从用户视角描述)、用户故事(较长的编号列表,格式为“作为……,我想要……,以便……”)、实现决策(模块、接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不写具体文件路径或代码片段,例外是原型中能更精确表达决策的片段)、测试决策(好测试的标准、被测模块、类似测试的先例)、范围外内容、补充说明。
  • 在现有操作授权范围内将规格发布到项目 issue 跟踪器;当没有未解决的设计或验收阻塞时,打上 ready-for-agent 分类标签,否则报告阻塞并保持规格未就绪。
  • 完成后重新对照 /principles 检查,确认覆盖已接受行为、适用的原则决策和测试证据要求,链接规范的项目产物,报告保存或发布的真实位置与未解决的阻塞。

使用方式:通过 /to-spec 调用。调用前,issue 跟踪器和分类标签词汇应已提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。涉及领域建模时调用 /domain-modeling 读取项目配置的产物;涉及委派工作时使用 /swarm,并采用实际宿主 schema、隔离写入者及披露的降级方案。

适用场景:已有较充分讨论、需要快速沉淀为规格并登记到 issue 跟踪器的开发任务。

限制:不进行用户访谈;不编造尚未确定的设计决策;无法获取跟踪器配置时无法完成发布。