SuperAPI AI 工具集

to-spec

通用与其它

查看项目

更新于 10-16 01:38

技能介绍

用途:将当前对话上下文与对代码库的理解综合成一份规格说明(spec),并发布到项目的 issue tracker,不进行用户访谈。若对话尚未达成共识,应先做 grill-me 会话而非写规格。

主要能力与流程:先探索仓库了解代码库现状,使用项目领域词汇并遵守相关 ADR;勾画测试接缝,优先复用现有接缝并选最高层,接缝越少越好;与用户确认接缝是否符合预期;按模板撰写规格并发布到 tracker,按 TRACKER.md 指定的标签为 agent-ready 工作打标。

规格模板包含:问题陈述、解决方案、用户故事(长编号列表,格式 As an <...>, I want a <...>, so that <...>)、实现决策(涉及的模块与接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不写具体文件路径或代码片段,原型可内联编码决策的关键片段)、测试决策(好测试的标准、被测试模块、同类测试先例)、范围外、补充说明。

tracker 解析:读取仓库 engineer 技能旁的 TRACKER.md,其中列出 tracker、命令及含义到本仓库标签字符串的映射;若没有,则从用户提供的信息、git remote 及已安装并认证的 CLI 中确定,均无法确定时默认使用本地 markdown 文件目录。engineer 技能目录因 harness 而异,可用以下命令查找: ls /skills/-engineer/TRACKER.md ./skills/-engineer/TRACKER.md 2>/dev/null

限制:本技能不做访谈,仅综合已知信息;未提供 TRACKER.md 且无法解析 tracker 时退回本地 markdown;标签仅在 TRACKER.md 命名时应用,否则跳过并说明。改编自 mattpocock/skills,MIT © 2026 Matt Pocock。