Matt Pocock Skills：修复"凭感觉写代码"的AI工程技能集

> 来源: https://github.com/ninehills/mattpocock-skills/tree/main | 研究时间: 2026-05-12

一句话版本

Matt Pocock（知名TypeScript专家）把自己每天用的25个AI工程技能开源了，这些技能能帮你把"凭感觉写代码"的AI变成真正的工程师——先拷问清楚需求再动笔、用测试驱动、维护共享术语、定期重构架构，让AI写出来的代码既对又好改。

核心内容

1. 背景：为什么需要这些技能？

Matt Pocock发现大家在用Claude Code、Codex等coding agent时经常遇到四个问题：

1. Agent没有做我想做的事 - 沟通不对齐，AI理解偏差

2. Agent太啰嗦了 - 缺乏共享语言，反复解释术语

3. 代码不工作 - 缺乏反馈循环，写完才发现跑不起来

4. 我们构建了一个泥球 - 代码设计质量差，越改越乱

他的解决方法不是"换更好的模型"，而是改变工作流程——用一套小巧、可组合的技能强制执行工程纪律。

2. 关键技能（25个开源技能）

工程核心（每天必用）

/diagnose - 严谨诊断循环：复现→最小化→假设→检测→修复→回归测试，专治"奇怪bug"
/grill-with-docs - 拷问环节：对照现有领域模型（CONTEXT.md）检验你的计划，精炼术语，避免自说自话
/triage - 分类状态机：通过标准标签对issue进行分类（bug/feature/refactor/question...）
/improve-codebase-architecture - 架构深化：每几天运行一次，发现代码库中"可以变深"的模块
/tdd - 红-绿-重构：强制执行测试驱动开发，一次一个垂直切片

对齐与沟通

/grill-me - 非代码场景拷问：在开始任何项目前，让Agent对你进行"灵魂拷问"
/to-prd - PRD生成器：把对话转换成正式产品需求文档，推送到GitHub issue
/to-issues - 工作拆分：把大需求拆分成可独立交付的小切片

配置与防护

/setup-matt-pocock-skills - 仓库配置脚手架：设置issue tracker、分类标签词汇、领域文档布局
/git-guardrails - Git防护栏：阻止git push --force等危险操作

3. 四大核心理念

1️⃣ 共享语言（Shared Language）

问题：AI和开发者术语不一致，导致来回解释、代码命名混乱
解法：用CONTEXT.md定义领域术语，所有技能都引用这个"术语表"
效果：变量/函数/文件名一致，代码库更容易导航，AI思考用更少token

2️⃣ 反馈循环（Feedback Loops）

原则："在投入大量时间之前先验证假设"
实践：

- /tdd：先写失败测试，再写最少代码通过

- 静态类型：TypeScript/Go等强类型语言

- 浏览器访问：让AI能打开localhost验证界面

效果：避免"写了一堆代码发现跑不起来"

3️⃣ 对齐拷问（Alignment Grilling）

原则："没有人确切知道自己想要什么"
实践：在动手前，让AI对你计划构建的东西进行详细提问
效果：提前暴露理解偏差，减少返工

4️⃣ 代码设计（Code Design）

问题：AI加速编码，也加速软件熵（代码变复杂的速度前所未有）
解法：关心模块深度——"最好的模块是深层的，通过简单接口暴露大量功能"
实践：

- /zoom-out：让AI在整个系统上下文中解释代码

- /improve-codebase-architecture：定期发现深化机会

4. 技术实现特点

小巧可组合：每个技能只做一件事，可以组合使用
模型无关：适用于Claude、GPT、Gemini等任何AI模型
零依赖：纯Markdown文件，没有外部API调用
易于定制：鼓励开发者"hack around with them, make them your own"

5. 安装使用


# 通过skills.sh安装
npx skills@latest add mattpocock/skills

# 在AI agent中运行配置
/setup-matt-pocock-skills

配置步骤：

1. 选择issue tracker（GitHub、Linear或本地文件）

2. 设置分类标签词汇

3. 指定文档保存位置

分析与见解

为什么值得关注？

1. 作者可信度：Matt Pocock是TypeScript教育领域公认专家（Total TypeScript），有60,000+ newsletter订阅者

2. 实际问题导向：解决的是真实开发者日常痛点，不是理论概念

3. MIT许可证开源：25K+ GitHub stars，社区认可度高

4. 哲学根基：引用《程序员的修炼之道》、《代码整洁之道》、《软件设计哲学》等经典

成功案例模式

1. 从个人痛点出发 → Matt自己每天用这些技能

2. 开源社区反馈 → 2026年4月底发布，迅速获得关注

3. 生态系统集成 → 能与skills.sh平台无缝集成

4. 教育培训延续 → 符合他"教人写更好代码"的个人品牌

潜在局限

1. 英语中心：技能提示词为英文，需要本地化

2. 特定开发背景：主要针对TypeScript/JavaScript生态，其他语言需要适配

3. AI模型依赖：虽然模型无关，但效果受限于AI的理解能力

4. 学习曲线：需要改变现有工作习惯，初期可能有阻力

与Jay项目的关联

1. OpenClaw集成潜力

高相关性：这些技能可以直接移植到OpenClaw的Skill系统：

技术兼容性：纯Markdown格式，OpenClaw完全支持
工作流增强：能为Jay的coding agent添加强制工程纪律
配置共享：CONTEXT.md概念与OpenClaw的MEMORY.md有相似目标

集成路径：

1. 将关键技能（/diagnose、/tdd、/triage）翻译为中文，创建OpenClaw Skill

2. 建立CONTEXT.md与MEMORY.md的映射关系

3. 在AGENTS.md中添加"工程纪律"章节

2. Deep Research Agent的改进机会

当前痛点匹配：

Jay问"Agent不理解我" → /grill-me技能可解决
Jay问"代码质量差" → /improve-codebase-architecture可定期运行
Jay问"如何管理技术债" → /triage + /diagnose组合

具体建议：

1. 为researcher agent添加/engineering-review技能，整合Matt Pocock的核心方法论

2. 在知识库报告中加入"代码质量评分"字段，对标/improve-codebase-architecture

3. 定期（每周）运行架构检查，防止知识库变成"文档泥球"

3. 与现有生态协同

与follow-builders skill互补：一个管"输入"（追踪行业动向），一个管"输出"（保证工程质量）
与claude-code-skills协同：都是AI工程技能，可合并为"工程工具箱"
与lossless-claw内存管理协同：CONTEXT.md可作为长期记忆的"术语锚点"

4. 产品化机会

潜在商业价值：

1. "AI工程纪律检查"服务：为企业和团队提供定期架构审查

2. 技能模板市场：基于Matt Pocock模式创建垂直领域技能（前端/后端/数据科学...）

3. 中文适配版：为中国开发者本地化的工程技能集

评分表

维度	评分 (1-10)	说明
创新性	8	不是技术创新，而是工作流创新，系统性解决实际问题
实用性	9	源自个人实践，解决真实痛点，有完整使用场景
社区活跃度	7	刚发布但增长快，25K+ stars，关注度高
技术成熟度	8	纯文档格式零依赖，易于部署和维护
可扩展性	9	小巧可组合，支持定制和垂直领域适配
中文友好度	5	英文提示词，需要本地化翻译
与Jay项目契合度	8	高度相关，可直接集成到OpenClaw ecosystem
综合推荐度	8.5	强烈建议集成，特别是`/diagnose`和`/grill-with-docs`技能

下一步行动建议

短期（1周内）

1. 翻译关键技能：挑选/diagnose、/tdd、/grill-me翻译为中文

2. 创建OpenClaw Skill：在~/.openclaw/extensions/下建立mattpocock-skills目录

3. 测试集成：在coding agent中试用/diagnose处理复杂bug

中期（1个月内）

1. 建立CONTEXT.md规范：为Jay所有项目创建和维护领域术语表

2. 开发"工程纪律检查"cron：每周自动运行/improve-codebase-architecture于知识库

3. 技能市场探索：研究skills.sh商业模式，考虑中文技能平台

长期

1. AI工程方法论输出：基于Matt Pocock模式+Jay中国实践，产出"中文AI工程最佳实践"

2. 教育培训产品：将工程技能打包为课程或工作坊

3. 开源贡献：向原项目贡献中文翻译和本地化改进