To Spec

作者 vinvcnbf98e53f9208无许可证4.6K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

把当前对话转成 spec 并发布到项目 issue tracker:不做访谈,只综合已经讨论的内容。

AI 生成的概览

把当前对话整理成 spec 并发布到项目 issue tracker。

功能
该 skill 把当前对话中已经讨论过的内容,结合对代码库的理解,综合成一份结构化规格说明。它按固定模板起草 spec,涵盖问题陈述、解决方案、用户故事、实现决策、测试决策、范围外事项和补充说明,然后以 ready-for-agent 分类标签发布到项目 issue tracker。它还会提出测试该功能的接缝(seams)并与用户确认。它不访谈用户,只整合已有上下文。
适用场景
当某个功能已经在对话中讨论过,而你希望把讨论转成书面 spec 而不是重新收集需求时使用。适合已经配置好 issue tracker 和分类标签词汇的团队。
运行要求
需要向 agent 提供 issue tracker 和分类标签词汇;若没有,会提示用户运行单独的 setup 命令。需要访问代码仓库以探索代码库。不附带脚本,仅为指令。

这个 skill 使用当前 conversation context 和 codebase understanding 产出 spec。不要访谈用户,只综合你已经知道的内容。

Issue tracker 和 triage label vocabulary 应该已经提供给你;如果没有,请让用户运行 /setup-matt-pocock-skills。

流程

  1. 如果还没有探索 repo,先探索它以理解 codebase 当前状态。在 spec 中始终使用项目 domain glossary vocabulary,并遵守相关 ADRs。

  2. 草拟你准备在哪些 seams 上测试这个 feature。优先使用现有 seams,而不是新增 seams。使用尽可能高层的 seam。如果确实需要新增 seams,尽可能在最高层提出。

Seams 越少越好,理想数量是一个。与用户确认这些 seams 是否符合预期。

  1. 使用下面模板写 spec,并发布到项目 issue tracker。应用 ready-for-agent triage label;不需要额外 triage。

<spec-template>

Problem Statement

用户正在面对的问题,从用户视角描述。

Solution

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

User Stories

一份很长的编号 user stories 列表。每条 user story 使用以下格式:

  1. As an <actor>, I want a <feature>, so that <benefit>

<user-story-example>

  1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending

</user-story-example>

这份 user stories 列表应该非常完整,覆盖 feature 的所有方面。

Implementation Decisions

已作出的 implementation decisions 列表。可以包括:

  • 将 build/modify 的 modules
  • 将 modify 的 module interfaces
  • 来自 developer 的技术澄清
  • Architectural decisions
  • Schema changes
  • API contracts
  • Specific interactions

不要包含具体 file paths 或 code snippets。它们可能很快过时。

例外:如果 prototype 产出的 snippet 比 prose 更精确地编码了某个决策(state machine、reducer、schema、type shape),可以内联到相关 decision 中,并简短说明它来自 prototype。只保留决策密集部分,不要放完整 working demo。

Testing Decisions

已作出的 testing decisions 列表。包括:

  • 什么是好测试的描述(只测试 external behavior,不测试 implementation details)
  • 哪些 modules 会被测试
  • 测试的 prior art(即 codebase 中类似类型的 tests)

Out of Scope

本 spec 范围外事项的描述。

Further Notes

关于 feature 的其他 notes。

</spec-template>

来源与署名

来源:vinvcn/mattpocock-skills-zh-cn位于skills/engineering/to-spec提交bf98e53

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架