SuperAPI AI 工具集

to-spec

写作与研究

查看项目

更新于 10-17 09:49

技能介绍

用途 该技能把当前对话上下文与对代码库的理解综合成一份功能规格,并发布到项目的问题跟踪器。它明确要求不要访谈用户,只综合已有信息。

主要能力

  • 综合对话与代码库理解生成规格,无需额外访谈用户。
  • 使用项目领域词汇表撰写规格,并遵守所涉及区域的 ADR。
  • 规划测试接缝(seams),优先使用现有接缝,并尽可能使用最高层接缝;若需新接缝,在尽可能高的位置提出,接缝越少越好,理想数量为一。
  • 与用户确认接缝是否符合预期。
  • 按模板撰写规格:问题陈述(从用户视角描述用户面临的问题)、解决方案(从用户视角描述解决方案)、长篇编号用户故事列表(格式为“作为……,我希望……,以便……”)、实施决策(包括将构建/修改的模块、模块接口变更、开发者的技术澄清、架构决策、模式变更、API 契约、特定交互;不包含具体文件路径或代码片段,例外是原型中能更精确表达决策的片段可内联并注明来自原型)、测试决策(包括好测试的定义、将测试的模块、代码库中类似测试的先例)、范围外内容、补充说明。
  • 发布到项目问题跟踪器,并打上 ready-for-agent 标签,无需额外分诊。

使用方式 问题跟踪器与分诊标签词汇应已提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。随后探索仓库了解代码库现状,规划并确认测试接缝,再按模板撰写规格并发布。

适用场景 适合已有充分对话讨论、需要把讨论结果快速整理为规格并进入开发流程的场合。

限制 该技能依赖预先提供的问题跟踪器与分诊标签词汇;规格实施决策中不包含具体文件路径或代码片段(原型决策片段除外);品牌、收费、价格、平台、效果等事实暂未提供。