其他
需要把当前对话沉淀为规格并发布到项目 issue…
将当前对话与代码库理解综合为一份 spec 并发布到项目 issue tracker,无需再访谈用户。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 39/100 ×0.15
适用场景
需要把当前对话沉淀为规格并发布到项目 i特定
解决思路
- 不要访谈用户;直接综合当前对话上下文和已有代码库理解来生成 spec。
- 若尚未提供 issue tracker 和 triage 标签词汇,提示用户运行 `/setup-matt-pocock-skills`。
- 如果还没做过,先探索仓库,理解代码库当前状态。
- 在整个 spec 中使用项目领域词汇表(domain glossary)的术语,并遵守所触及区域的 ADR。
- 勾勒将要测试该功能的接缝(seams);优先使用已有接缝而不是新建接缝。
- 使用尽可能高的接缝;如果需要新接缝,在尽可能高的位置提出。
- 代码库中的接缝越少越好,理想数量是 1 个。
- 与用户确认这些接缝是否符合其预期。
- 按给定的 spec 模板撰写 spec。
- 将 spec 发布到项目 issue tracker。
- 应用 `ready-for-agent` triage 标签;无需再做额外 triage。
- 在 Problem Statement 中:从用户视角描述用户正面临的问题。
- 在 Solution 中:从用户视角描述该问题的解决方案。
- 在 User Stories 中:写一个很长的编号列表,每条格式为 `As an <actor>, I want a <feature>, so that <benefit>`;列表要极其详尽,覆盖功能的所有方面。
- 在 Implementation Decisions 中:列出已做出的实现决策,可包括将构建/修改的模块、这些模块将被修改的接口、来自开发者的技术澄清、架构决策、schema 变更、API 契约、具体交互。
- 在 Implementation Decisions 中不要包含具体文件路径或代码片段,因为它们可能很快过时。
- 例外:如果原型产生的片段比文字更精确地编码了某个决策(如状态机、reducer、schema、类型形状),就把它内联在相关决策中,并简要注明它来自原型;只保留决策丰富的部分,不要放可运行 demo,只放重要部分。
- 在 Testing Decisions 中:列出已做出的测试决策,包括好的测试的标准(只测外部行为,不测实现细节)、将测试哪些模块、代码库中类似测试的 prior art。
- 在 Out of Scope 中:描述该 spec 范围之外的内容。
- 在 Further Notes 中:记录关于该功能的任何进一步说明。
适用边界 · 注意事项
- 尚未配置项目 issue tracker 或 triage 标签词汇时不要直接使用;先运行 `/setup-matt-pocock-skills`。
- 不要把它当作需求访谈或澄清工具;该技能明确不访谈用户,只综合已有讨论。
- 不要在 Implementation Decisions 中写具体文件路径或代码片段(除非原型片段更精确地编码决策且已注明来源)。