SuperAPI AI 工具集

to-spec

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:to-spec 用于把当前对话上下文与对代码库的理解综合成一份规格文档,明确要求不要访谈用户,只综合已知信息。

主要能力:先确定输出目的地。它会先询问是否发布到问题跟踪器,还是写入操作系统临时目录下的本地 markdown 文件;不会擅自发布到用户未同意的跟踪器。若用户选择发布,则从 AGENTS.md、CLAUDE.md 等项目代理指令及其指向的跟踪器配置中查找具名跟踪器,只有既能命名(如 GitHub、Linear、Jira)又能用现有工具访问时才视为可用,并按项目指令记录的标签约定打标签,未记录则不添加。不可用时明确说明查找位置并回退到本地文件;用户当场指定跟踪器或配置则改用该跟踪器,并可提议记录到项目代理指令中。若用户拒绝或没有可用跟踪器,则写入 <os-temp-dir>/<feature-slug>/spec.md,<os-temp-dir> 从环境解析(macOS 用 $TMPDIR,Linux 用 $TMPDIR 或 /tmp,Windows 用 %TEMP%),需报告绝对路径并提醒临时目录可能被系统清理。

使用方式:先探索仓库了解代码库现状,使用项目领域词汇表,并遵守相关 ADR;勾画测试接缝,优先复用现有接缝并使用尽可能高的接缝,新接缝也应在最高点提出,接缝越少越好,理想为一个;与用户确认接缝符合预期;然后按模板撰写规格并写入已确定的目的地。模板包含问题陈述、解决方案、用户故事(长编号列表,格式为 As an…, I want a…, so that…)、实现决策(模块、接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不写具体文件路径或代码片段,除非原型片段比文字更精确地编码了决策,可内联并注明来自原型)、测试决策(好测试只测外部行为、被测模块、同类测试先例)、范围外内容、进一步说明。

适用场景:需要把已有讨论快速固化为规格并决定发布位置时。

限制:不进行用户访谈;不擅自发布;跟踪器需可命名且可访问;本地回退写入系统临时目录,可能被清理;资料未提供具体价格、平台支持范围或效果保证。