to-spec

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

本 skill 取当前对话上下文和对代码库的理解，产出一份 spec。不要访谈用户——只综合你已经知道的。

Issue tracker 和分诊标签词汇本应已提供给你——若没有，运行 `/setup-matt-pocock-skills`。

## 流程

1. 若尚未探索，先探索仓库以了解代码库当前状态。Spec 通篇使用项目领域词汇表中的用语，并尊重你所触及区域的任何 ADRs。

2. 草拟你将用来测试该功能的 seams。已有 seams 优先于新 seams。用尽可能高的 seam。若需要新 seams，在你能提出的最高点提出。代码库里 seams 越少越好——理想数量是一个。

与用户确认这些 seams 符合他们的预期。

3. 用下面的模板写 spec，然后发布到项目的 issue tracker。打上 `ready-for-agent` 分诊标签——无需额外分诊。

<spec-template>

## Problem Statement

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

## Solution

对该问题的解决方案，从用户视角描述。

## User Stories

一份长的、编号的用户故事列表。每条用户故事应采用如下格式：

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>

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

## Implementation Decisions

已做出的实现决策列表。可以包括：

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

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

例外：若某个原型产出的片段比散文更能精确编码一项决策（状态机、reducer、schema、类型形态），把它内联到相关决策中，并简短注明来自原型。裁到决策含量高的部分——不是可运行的 demo，只是重要片段。

## Testing Decisions

已做出的测试决策列表。包括：

- 对什么是好测试的描述（只测外部行为，不测实现细节）
- 将测试哪些模块
- 测试的先例（即代码库里类似类型的测试）

## Out of Scope

对本 spec 而言超出范围的事项描述。

## Further Notes

关于该功能的任何进一步说明。

</spec-template>

From shenjunjian/matt-skill-cn, MIT.

More from shenjunjian/matt-skill-cn