SuperAPI AI 工具集

to-spec

编程与开发

查看项目

更新于 10-16 03:49

技能介绍

用途:将当前对话上下文与对代码库的理解整理为规格说明(spec),并发布到项目 issue 跟踪器。官方说明明确要求不要访谈用户,只综合已有信息。

主要能力与流程:先探索仓库以了解代码库现状;全篇使用项目领域词汇表,并遵守相关 ADR。随后勾勒测试接缝:优先复用既有接缝,尽量使用最高层接缝;如需新建接缝,应在尽可能高的位置提出,接缝越少越好,理想数量为一。与用户确认这些接缝符合预期后,按给定模板撰写规格并发布到项目 issue 跟踪器,打上 ready-for-agent 分诊标签,无需额外分诊。

规格结构:问题陈述(从用户视角描述所面临的问题);解决方案(从用户视角描述);用户故事(长编号列表,格式为“As an , I want a , so that ”);实现决策(包括将构建/修改的模块、其接口变更、技术澄清、架构决策、schema 变更、API 契约、具体交互;不要包含具体文件路径或代码片段;例外是原型中能更精确编码决策的片段,如状态机、reducer、schema、类型形状,可内联并注明来自原型,仅保留决策密集部分);测试决策(好测试的标准,只测外部行为不测实现细节、被测模块、同类测试先例);范围之外;进一步说明。

使用方式:需已向使用者提供 issue 跟踪器与分诊标签词表;若未提供,应让用户运行 /setup-matt-pocock-skills。

适用场景:已有充分对话上下文、需要把讨论快速沉淀为可发布规格并进入智能体可执行队列的开发流程。

限制:技能本身不进行用户访谈;不提供具体文件路径与代码片段;分类、URL 等资料未提供更多平台或收费信息。