SuperAPI AI 工具集

to-spec

办公与效率

查看项目

更新于 10-16 01:24

技能介绍

用途:把当前对话中已讨论的内容与代码库理解综合成一份 spec,并发布到项目 issue tracker;不做用户访谈,只做综合。若未被告知 issue tracker 和 triage 标签词汇,提示用户运行 /setup-matt-pocock-skills。

主要能力与流程:探索 repo 了解代码库现状;全程使用项目领域词汇表,遵守相关 ADR;勾画测试接缝(seam),优先复用既有接缝、使用尽可能高的层级,新接缝尽可能高且默认每个 spec 只用一个;与用户确认接缝符合预期;按模板撰写并发布 spec,打上 ready-for-agent 标签,无需额外分诊。

模板段落:Problem Statement(从用户视角描述问题)、Solution(从用户视角描述方案)、User Stories(大量编号列表,格式 As an , I want a , so that )、Implementation Decisions(模块、接口、技术澄清、架构决策、schema 变更、API 契约、交互;不写具体文件路径或代码片段,原型中编码决策的片段可内联并标注)、Testing Decisions(好测试的标准、被测模块、既有类似测试)、Out of Scope、Further Notes。

发布后选择执行路线:若完整 spec 适配单一实现上下文且当前对话足够连贯可 fork,标记 fork → /spec-executor;若需要多个 tracer-bullet 切片、并行、跨 agent 转移或上下文压缩,标记 /to-tickets,不得把大 spec 伪装成可 fork。若产品决策或测试接缝未解决,输出 SPEC NOT READY 并说明缺失决策,不启动实现。

就绪结果以紧凑启动块结尾:SPEC READY、Status、Source、Repository、Baseline、Test seam、Non-goals、External authority(默认未授予)、Next route(fork + /spec-executor | /to-tickets)。该块是已批准 spec 的索引,不替代 spec 本身。限制:依赖外部技能提供的跟踪器与标签配置;不提供具体文件路径与代码片段;未提供定价、平台等信息。