发布日期:2026-05-13
标签:#AIAgent #ClaudeCode #TDD #TypeScript #MattPocock #工程化
一、 引言
很多开发者在使用 Claude Code 或 Cursor 时,常感叹 AI“会写代码,但不懂工程”。它可能写出精妙的函数,却在复杂项目重构、需求拆解和测试驱动开发(TDD)上显得杂乱无章。这种纯靠感觉的开发被称为“Vibe Coding”。
为了终结这种混乱,TypeScript 教育专家 Matt Pocock 开源了skills库。这不仅仅是一个提示词集合,更是一套生产级工程指令集。它将资深工程师几十年的经验固化为 AI 可执行的标准化工作流,让 AI Agent 像真正的技术负责人(Tech Lead)一样思考和行动。
二、 项目框架设计
skills项目采用了“工作流约束”架构。它不只是告诉 AI“去做什么”,而是通过一套严密的阶段准入机制(Phase Gate)约束 AI“怎么做”:
| 类别 | 代表性 Skill | 核心工程价值 |
| 规划与设计 | /to-prd,/to-issues | 前置思考:杜绝盲目编码,将模糊需求转化为标准 PRD 与垂直切片的 Issue。 |
| 开发与重构 | /tdd,/improve-architecture | 规范落地:强推“红-绿-重构”循环,确保每一行代码都经过验证。 |
| 工程与安全 | /git-guardrails,/qa | 环境管控:拦截危险 Git 操作(如force push),对接真实质检流程。 |
| 协作与沉淀 | /handoff,/write-a-skill | 持续迭代:自动生成上下文交接文档,甚至让 AI 学习编写新的 Skill。 |
三、 关键功能解析
1. 核心杀手锏:TDD 垂直切片 (The /tdd Skill)
这是该项目流传最广的功能。它强制 AI 遵循“红-绿-重构”节奏:
红:先写一个报错的测试,定义预期行为。
绿:编写实现测试通过的最少代码。
重构:在测试保护下优化架构。
这种模式杜绝了 AI 一次性生成千行代码却无法运行的尴尬。
2. 需求拆解专家:垂直切片 Issue (Vertical Slicing)
使用/to-issues,AI 会将复杂的 PRD 拆解为“tracer bullet(追踪弹)”式的 Issue。每个 Issue 都是一个贯穿 UI、API 和数据库的垂直功能切片,而不是传统的水平分层,这极大提升了 AI 任务的交付频率和质量。
3. 确定性防护:Git Guardrails
通过钩子(Hooks)拦截危险操作。它不是在“建议”AI 不要误删分支,而是在 Shell 层级直接屏蔽reset --hard等指令,为给 Agent 开启终端权限提供了安全底线。
四、 使用教程:如何让你的 AI 满血进化
1. 环境准备
该项目原生适配Claude Code,但也支持通过 npx 安装到任何 AI 工作流中。
# 推荐安装方式 npx @mattpocock/skills install2. 配置你的工程规范
安装后运行设置命令,定义项目的 Issue 追踪器、文档路径及 Triage 标签:
/setup-matt-pocock-skills3. 实战演示:从需求到代码
聊透需求:输入
/grill-me,让 AI 对你的想法进行深度访谈,直到补全所有决策分支。生成 PRD:输入
/to-prd,自动汇总当前对话生成标准文档。驱动开发:针对具体任务输入
/tdd。你会看到 AI 乖乖地先写测试,再写逻辑,整个过程极度丝滑。
五、 总结
mattpocock/skills的火爆,标志着 AI 编程从“魔法时代”迈向了“工业时代”。它告诉我们:AI 的上限不仅取决于模型参数,更取决于我们为其设定的工程约束。如果你希望 AI 能够处理真实、复杂的商业代码库,这套 Skill 库就是你的必修课。
🔥 互动话题:
在 AI 编程中,你认为最难让 AI 遵守的规范是什么?是“写测试”还是“不乱动无关代码”?欢迎在评论区分享你的观点!