AGENT SKILL

to-spec

将当前对话转化为规格并发布到项目问题跟踪器——不进行访谈,只综合已经讨论过的内容。

License 许可
MIT
最近更新
2026-07-23
Stars
★ 1
Forks
0

01 前言 Front Matter

name
to-spec
description
将当前对话转化为规格并发布到项目问题跟踪器——不进行访谈,只综合已经讨论过的内容。
disable-model-invocation
true

02 资源文件 1

03 SKILL.md 正文

本技能利用当前对话上下文和对代码库的理解产出规格(你也可能将这类文档称为 PRD)。不得访谈用户——只需综合你已经知道的内容。

问题跟踪器和分诊标签词汇应当已经提供给你——如果没有,请运行 /setup-matt-pocock-skills。

流程

  1. 如果尚未探索仓库,请进行探索以了解代码库当前状态。整份规格都使用项目领域术语表中的词汇,并遵守所涉及区域的所有 ADR。

  2. 勾勒出将用于测试该功能的接缝。应当优先选择现有接缝,而不是创建新接缝。尽可能使用最高层级的接缝。如果需要新接缝,请在尽可能高的位置提出。整个代码库中的接缝越少越好——理想数量是一个。

向用户确认这些接缝是否符合预期。

  1. 使用下方模板编写规格,然后发布到项目问题跟踪器。应用 ready-for-agent 分诊标签——无需进一步分诊。

<spec-template>

问题陈述

从用户角度描述用户面临的问题。

解决方案

从用户角度描述问题的解决方案。

用户故事

一份很长的用户故事编号列表。每个用户故事都应使用以下格式:

  1. 作为 <actor>,我希望 <feature>,从而 <benefit>

<user-story-example>

  1. 作为移动银行客户,我希望查看账户余额,从而能够对消费作出信息更充分的决策 </user-story-example>

这份用户故事列表应当极其详尽,并覆盖功能的所有方面。

实现决策

列出已经作出的实现决策。可以包括:

  • 将构建/修改的模块
  • 将修改的这些模块的接口
  • 开发者给出的技术澄清
  • 架构决策
  • Schema 变更
  • API 契约
  • 具体交互

不得包含具体文件路径或代码片段。它们可能很快过时。

例外:如果原型产出的片段能比文字更精确地编码某项决策(状态机、reducer、schema、类型形态),则将其内联到相关决策中,并简短注明它来自原型。只保留决策信息丰富的部分——不是可运行演示,只是重要片段。

测试决策

列出已经作出的测试决策。包括:

  • 描述什么是好测试(仅测试外部行为,而不是实现细节)
  • 将测试哪些模块
  • 测试的既有范例(即代码库中的类似测试类型)

超出范围

描述本规格范围之外的内容。

补充说明

有关该功能的任何补充说明。

</spec-template>

04 同仓库更多 Skills