此技能获取当前对话上下文和代码库理解,并生成一份技术规格说明书。不要与用户进行访谈;仅综合您已经知道的内容。
问题追踪器和分类标签词汇表应已提供给您。如果没有,请告诉用户运行 /setup-matt-pocock-skills。
流程
-
如果尚未探索仓库,请先探索仓库以了解代码库的当前状态。在整个规格说明中,请使用项目的领域术语词汇表,并尊重您所涉及区域的任何 ADR。
-
勾勒出您将用于测试该特性的各个接缝(seams)。应优先使用现有的接缝,而非新建接缝。尽可能使用最高层次的接缝。如果需要新的接缝,请在尽可能高的层次上提出。跨代码库的接缝越少越好——理想数量是 1 个。
与用户确认这些接缝是否符合他们的期望。
- 使用以下模板编写规格说明,然后将其发布到项目问题追踪器。应用
ready-for-agent分类标签——无需额外的分类。
问题陈述
从用户视角出发,用户所面临的问题。
解决方案
从用户视角出发,问题的解决方案。
用户故事
一个 长 的、编号的用户故事列表。每个用户故事应采用以下格式:
- 作为 <角色>,我想要 <功能>,以便 <收益>
这个用户故事列表应该极其详尽,覆盖该特性的所有方面。
实现决策
一系列已做出的实现决策。可以包括:
- 将要构建/修改的模块
- 将要修改的模块的接口
- 来自开发者的技术澄清
- 架构决策
- 方案变更
- API 契约
- 特定交互
不要包含具体的文件路径或代码片段。它们可能很快就会过时。
例外:如果原型产生的代码片段比自然语言更能精确编码决策(例如状态机、reducer、方案、类型形状),则在相关决策中内联该代码片段,并简要说明它来自原型。仅保留富含决策的部分,而非一个可运行的演示,只需重要部分即可。
测试决策
一系列已做出的测试决策。包括:
- 描述什么构成了一个好测试(只测试外部行为,不测试实现细节)
- 哪些模块将被测试
- 测试的先前范例(即代码库中类似类型的测试)
不在范围内
描述此规格说明中不在范围内的内容。
进一步说明
任何关于该特性的进一步说明。