Community编程与开发github.com

Wanbicoi/agent-config

将当前对话转化为技术规格说明书,并自动发布到项目问题追踪器:无需额外访谈,直接综合您已讨论的内容。

agent-config 是什么?

该技能的核心能力是将当前对话上下文与代码库理解自动综合生成一份技术规格说明书(spec)。它能够自动探索仓库以获取代码库最新状态,并利用项目领域术语和已定义的架构决策记录(ADR)来确保规格说明的准确性。该技能支持在开发者的工作流中作为“无需访谈、直接综合”的代理工具,自动将规格说明发布到项目的问题追踪系统(如 GitHub Issues),并应用“ready-for-agent”的 triage 标签。它通过明确的“用户故事”、实现决策、测试决策等模板结构,帮助团队快速将口语化讨论转化为结构化的开发规范,非常适合与 AI 编码助手(如 Claude Code、Coder 等)配合使用,以加速从讨论到代码实现的过程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Wanbicoi/agent-config/tree/HEAD/skills/to-spec

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

此技能获取当前对话上下文和代码库理解,并生成一份技术规格说明书。不要与用户进行访谈;仅综合您已经知道的内容。

问题追踪器和分类标签词汇表应已提供给您。如果没有,请告诉用户运行 /setup-matt-pocock-skills。

流程

  1. 如果尚未探索仓库,请先探索仓库以了解代码库的当前状态。在整个规格说明中,请使用项目的领域术语词汇表,并尊重您所涉及区域的任何 ADR。

  2. 勾勒出您将用于测试该特性的各个接缝(seams)。应优先使用现有的接缝,而非新建接缝。尽可能使用最高层次的接缝。如果需要新的接缝,请在尽可能高的层次上提出。跨代码库的接缝越少越好——理想数量是 1 个。

与用户确认这些接缝是否符合他们的期望。

  1. 使用以下模板编写规格说明,然后将其发布到项目问题追踪器。应用 ready-for-agent 分类标签——无需额外的分类。

问题陈述

从用户视角出发,用户所面临的问题。

解决方案

从用户视角出发,问题的解决方案。

用户故事

一个 长 的、编号的用户故事列表。每个用户故事应采用以下格式:

  1. 作为 <角色>,我想要 <功能>,以便 <收益>

这个用户故事列表应该极其详尽,覆盖该特性的所有方面。

实现决策

一系列已做出的实现决策。可以包括:

  • 将要构建/修改的模块
  • 将要修改的模块的接口
  • 来自开发者的技术澄清
  • 架构决策
  • 方案变更
  • API 契约
  • 特定交互

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

例外:如果原型产生的代码片段比自然语言更能精确编码决策(例如状态机、reducer、方案、类型形状),则在相关决策中内联该代码片段,并简要说明它来自原型。仅保留富含决策的部分,而非一个可运行的演示,只需重要部分即可。

测试决策

一系列已做出的测试决策。包括:

  • 描述什么构成了一个好测试(只测试外部行为,不测试实现细节)
  • 哪些模块将被测试
  • 测试的先前范例(即代码库中类似类型的测试)

不在范围内

描述此规格说明中不在范围内的内容。

进一步说明

任何关于该特性的进一步说明。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能