用途:把当前对话上下文与对代码库的理解综合成一份规格(spec),并发布到项目问题跟踪器。该技能不做用户访谈,只归纳已经讨论过的内容,适用于对话已准备好写成规格的场景。触发词:to-spec、to-prd、write this up as a spec。
主要能力:探索代码库以了解现状;使用项目领域词汇表;遵守相关区域的 ADR;规划测试接缝(seam),优先复用现有接缝并使用最高层级的接缝,新接缝也应尽量在最高点提出,越少越好,理想为一个;与用户确认接缝是否符合预期;按模板撰写规格并发布,应用 ready-for-agent 归类标签,无需额外汇总。
规格模板包含:问题陈述(从用户视角描述用户面临的问题)、解决方案(从用户视角)、用户故事(较长的编号列表,格式为 As an / I want a / so that,覆盖功能各方面)、实现决策(将要构建或修改的模块及其接口、开发者的技术澄清、架构决策、模式变更、API 契约、具体交互;不要写具体文件路径或代码片段,例外是原型中比文字更精确地编码决策的片段,如状态机、reducer、模式、类型形状,需注明来自原型并只保留决策密集部分)、测试决策(好测试的标准,仅测试外部行为而非实现细节;被测模块;代码库中类似测试的先例)、范围外内容、进一步说明。
使用方式:问题跟踪器与归类标签词汇应已提供,若未提供,需让用户运行 /setup-matt-pocock-skills。当某步需要仓库或环境中的事实时,应主动查找而非询问用户。建议先在一个窄范围内应用,确认输出符合上述形态后再扩大到完整任务。
限制:该技能从 mattpocock/skills(MIT)导入,上游由用户调用。需保持上游流程完整,如有偏离应明确记录而非默默即兴发挥。在每个被标记为用户决策的点应停下并交还控制权。偏好小而可回退的改动,明示假设而非隐藏。参考:上游技能 mattpocock/skills skills/engineering/to-spec/SKILL.md(commit 3cca18b, MIT);项目标准 .agent-skills/skill-standardization/SKILL.md;验证脚本 .agent-skills/skill-standardization/scripts/validate_skill.sh。除上述资料外,收费、价格、平台等未提供。