Matt Pocock 技能集
第一次使用 Matt Pocock Skills：澄清、规格、测试与审查
先建立仓库约定，再选择明确的小流程，并分清固定版本 TDD 正文与 README 概述之间的差别。
你将学会
- 先建立项目自己的约定
- 把首次任务缩小到能判断对错
- 明确触发方式，也明确完成证据
开始前需要
- 理解基础仓库、工单系统与测试概念
- 能够区分指令内容和执行权限
选择采用方式，并追踪相关文件、权限边界和验证证据。
先看结论
- setup 先检查并确认，再记录项目约定。
- 固定版本将 TDD 实现循环与审查阶段重构分开。
- 流程指令不等于执行记录。
先建立项目自己的约定
setup 技能是引导式对话，不是确定性执行的配置程序。它检查现有项目指令、工单约定和领域文档，然后展示拟议修改并请求确认。具体产物包括 docs/agents 下的工单与领域说明；只有安装了 triage 时，才需要生成分流标签文档。
源码支持 GitHub、GitLab 和本地 Markdown 约定，其他工单系统则根据用户描述记录工作方式。它会选择已有项目指令文件，而不是盲目再创建一个竞争入口。学习时可以选择本地工单和一次性仓库，避免试用流程时向真实团队发布任务。
把首次任务缩小到能判断对错
一个合适的试验是修改订单总价逻辑，明确舍入规则和一个公开接口。请求实现之前，先说明空订单与折扣商品应该怎样处理，再让规格与测试使用相同术语。这是本文设计的教学例子，不是该技能仓库自带的订单应用。
固定版本的 TDD 文件要求先约定公开测试边界，再通过行为断言验证结果；每次只写一个失败测试和足够使它通过的实现。它把重构放在审查阶段，与 README 较宽泛的红—绿—重构说法并不完全相同。阅读时应识别版本中的真实差异，不要把两种描述拼成一条声称精确的流程。
明确触发方式，也明确完成证据
implement 被标记为用户触发技能。其文档要求经常运行局部测试和类型检查，在结束前运行完整测试集，进行审查并提交。这些是预期工作流程，不证明当前宿主已经具备执行每一步所需的工具、凭据或授权。在共享分支上使用前，应先确认允许产生哪些结果。
首次练习成功的标志，是验收条件明确且观察证据与之匹配。未执行的浏览器检查、不可用的工单系统或尚未运行的集成测试，需要单独记录；安装了技能不会让这些缺口自动变成通过。本文演练也不是向其他项目安装或执行技能的授权。
实施步骤
- 1
使用一次性仓库与本地工单文档。
- 2
主动运行文档中的 setup，并检查拟议差异。
- 3
约定一个行为及其公开测试边界。
- 4
请求选定流程，再核对测试和审查证据。
可复制示例
{
"exercise": "order total",
"publicBoundary": "quoteOrder(items)",
"acceptance": "an empty order has a zero total",
"tracker": "local markdown",
"remoteIssueCreationApproved": false,
"exerciseExecutedByThisReview": false
}常见问题
setup 会自动配置所有仓库吗？
不会。它是针对当前仓库进行探索、提出修改并请求确认的引导过程。
为什么特意区分 README 和 TDD 文件？
这个版本对重构阶段的描述存在差异，文章明确指出，而不是把混合后的流程冒充精确源码行为。
资料来源
- README.md来源核查 2026-09-08
- skills/engineering/setup-matt-pocock-skills/SKILL.md来源核查 2026-09-08
- skills/engineering/tdd/SKILL.md来源核查 2026-09-08
- skills/engineering/implement/SKILL.md来源核查 2026-09-08