SuperAPI AI 工具集

to-spec

编程与开发

查看项目

更新于 10-16 09:45

技能介绍

用途:该 skill 利用当前对话上下文与对代码库的理解生成 spec,不做访谈,只综合已有信息。issue tracker 和 triage 标签词汇应已提供,否则需用户运行 /setup-matt-pocock-skills。

流程:若尚未探索 repo,先探索以了解代码库现状。spec 中始终使用项目领域词汇表术语并遵守相关 ADR。草拟将要测试该 feature 的 seams(接缝),优先复用现有 seams,使用尽可能高层的 seam;若需新增,尽量在最高层提出。seams 越少越好,理想为一个。需与用户确认 seams 是否符合预期。随后按模板撰写 spec 并发布到项目 issue tracker,应用 ready-for-agent triage 标签,无需额外 triage。

模板结构包含:Problem Statement(从用户视角描述问题)、Solution(从用户视角描述解决方案)、User Stories(编号列表,格式为 As an , I want a , so that )、Implementation Decisions(已做出的实现决策,可含将 build/modify 的模块、模块接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不含具体文件路径或代码片段,但若原型 snippet 比文字更精确地编码某决策,可内联并注明来自原型,仅保留决策密集部分)、Testing Decisions(好测试定义:只测外部行为不测实现细节;哪些模块被测试;代码库中类似测试的 prior art)、Out of Scope(范围外事项)、Further Notes(其他说明)。

适用场景:已通过对话讨论清楚需求后,需快速产出并发布 spec 时。限制:不进行需求访谈;依赖 issue tracker 与 triage 标签配置;seams 需与用户确认。