SuperAPI AI 工具集

to-spec

通用与其它

查看项目

更新于 10-16 06:22

技能介绍

用途:to-spec 读取当前对话上下文与对代码库的理解,直接综合生成一份 spec,并发布到项目的 issue tracker。它明确要求不要访谈用户,只做已有信息的综合。使用前,issue tracker 与 triage 标签词汇需已提供,否则需先运行 /setup-leandrocfe-skills。

主要能力与流程:先探索仓库以了解代码库现状;全程使用项目领域词汇表,并遵守相关 ADR。随后草拟用于测试该功能的 seam,优先复用已有 seam,尽量选最高层的 seam,新 seam 越少越好,理想为一个,并与用户确认这些 seam 是否符合预期。最后按模板撰写 spec 并发布到 issue tracker,打上 ready-for-agent 标签,无需额外 triage。

spec 模板包含:Problem Statement(从用户视角描述问题)、Solution(从用户视角描述解决方案)、User Stories(尽量长的编号列表,格式为“作为…,我想要…,以便…”)、Implementation Decisions(模块、接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不写具体文件路径与代码片段,除非原型片段比文字更精确地表达决策,可截取决策密集部分并注明来自原型)、Testing Decisions(好测试的定义、被测模块、可参考的既有测试)、Out of Scope、Further Notes。

适用场景:已有充分对话与代码库上下文、需要快速产出并归档 spec 的团队工作流。限制:不进行用户访谈;依赖已配置的 issue tracker 与 triage 标签词汇;具体安装与配置细节资料未提供。