用途:to-spec 用于将当前对话上下文与代码库理解综合为一份功能规格说明,并发布到项目的问题跟踪系统。其定位是“不采访用户,只综合已知信息”,因此适用于讨论已较充分、无需再澄清需求的场合。
主要能力与产出结构:该技能要求先探索代码库以了解现状(若尚未了解),在规格中沿用项目领域词汇表,并遵守相关架构决策记录(ADR)。规格需先勾勒测试接缝(seam),优先复用现有接缝、选择尽可能高的接缝,新接缝也应在尽可能高的位置提出,接缝数量越少越好,理想为一处;随后与用户确认这些接缝是否符合预期。规格模板包含:问题陈述(从用户视角描述所面临的问题)、解决方案(从用户视角描述解决方式)、用户故事(长篇编号列表,格式为“作为……我想要……以便……”)、实现决策(包括将构建或修改的模块及其接口、技术澄清、架构决策、模式变更、API 契约、具体交互等,不包含具体文件路径或代码片段;例外是原型中能更精确表达决策的片段可内联并注明来源)、测试决策(好测试的标准即只测外部行为不测实现细节、待测模块、代码库中类似测试的先例)、范围外内容、补充说明。写完后发布到问题跟踪系统,并应用 ready-for-agent 分类标签,无需额外分类。
使用方式:问题跟踪系统与分类标签词汇应已提前提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。流程为:探索代码库、沿用领域词汇与 ADR、草拟测试接缝并与用户确认、按模板撰写规格、发布至问题跟踪系统并打标签。
适用场景:需求讨论结束后快速沉淀为可追踪工单;需要保持规格与现有领域术语和架构决策一致的项目;希望以最少测试接缝覆盖功能的团队。
限制:不进行用户访谈,因此不适合需求尚未澄清的情况;依赖已配置的问题跟踪系统与分类标签;规格中不写具体文件路径与代码片段,避免快速过时。