Matt Pocock Skills v1.0

Matt Pocock Skills v1.0 快速入门

一句话卖点：TypeScript 大师 Matt Pocock 的「工程纪律注入器」——让 AI 写 TypeScript 时自动遵守 TDD、Code Review、渐进式类型规范。

这是什么？适合谁？

Matt Pocock Skills 是由 TypeScript 教育者、Total TypeScript 创始人 Matt Pocock 发布的 Agent Skills 集合，GitHub 135K+ Stars。这套 Skill 不是教 AI 怎么写 TypeScript 语法，而是把工程纪律固化进 AI 的默认行为——让 AI 帮你写代码时，自动走 TDD 流程、遵守 TypeScript 严格模式、输出符合 Code Review 标准的代码。
核心创新：渐进式披露（Progressive Disclosure）——Skill 文件按需分层加载，AI 只在需要时才读取详细规则，将每个请求的 token 消耗降低 63%。相比传统「一次性加载所有规则」的 Skill，这是一种更聪明的设计。
包含的核心 Skill：

• TDD Workflow：强制红-绿-重构流程；
  
• Strict TypeScript：noUncheckedIndexedAccess、exactOptionalPropertyTypes 等严格配置；
  
• Code Review Checklist：提交前自动走 Review 清单；
  
• Pattern Library：常见 TypeScript 设计模式指南。
  适合谁？TypeScript 开发者、全栈团队、对 AI 代码质量有要求的项目负责人。特别适合已经用 TypeScript strict 模式的团队。
  不适合纯 JavaScript 项目或不需要工程纪律约束的场景——这些 Skill 默认开启严格模式。
  

准备工作

1. 一个 AI 编程助手（Claude Code / Cursor / Windsurf）；
   
2. Node.js 环境（Skill 本身不需要，但 TypeScript 项目需要）；
   
3. 项目已配置 TypeScript strict 模式（推荐）。
   

3 步快速上手

第 1 步：安装

# Clone 仓库<br>
git clone https://github.com/mattpocock/skills.git<br>
# 将 Skill 目录软链到 Claude Code<br>
ln -s $(pwd)/skills/skills/* ~/.claude/skills/<br>
# 或者复制到 Cursor Rules 目录<br>
cp skills/skills/* ~/.cursor/rules/<br>
```<br>
### 第 2 步：配置<br>
在 AI 助手配置中启用渐进式披露模式。以 Claude Code 为例：<br>
```bash<br>
# 在项目根目录创建 .claude/settings.json<br>
echo '{<br>
"skills": {<br>
"progressiveDisclosure": true,<br>
"enabledSkills": ["tdd-workflow", "strict-typescript", "code-review"]<br>
}<br>
}' > .claude/settings.json<br>
```<br>
渐进式披露模式下，AI 只在执行相关任务时才加载对应的 Skill 细节（比如写代码时加载 `strict-typescript`，提交时加载 `code-review`）。<br>
### 第 3 步：首次使用<br>
在 AI 助手中输入：
> "请帮我实现一个 `deepMerge` 工具函数，合并两个对象，按 TDD 流程来。"

如果 AI 的输出是：

1. 先写测试用例（使用 `expectType` 等类型测试工具）；

2. 再写实现代码（带完整类型签名、泛型约束）；

3. 最后问你是否需要重构；

说明 Skill 加载成功，且渐进式披露机制正常工作。

## 常见踩坑

1. **渐进式披露不生效**：检查 `.claude/settings.json` 中 `progressiveDisclosure: true` 是否配置正确；部分 AI 助手版本可能不支持此特性。

2. **Strict TypeScript 规则太严格**：如果你的项目是 JS 或宽松 TypeScript，`strict-typescript` Skill 会让 AI 频繁报类型错误。建议仅在 TS strict 项目中使用。

3. **TDD 流程耗时增加**：强制 TDD 会让每次功能开发多 30-50% 时间（写测试 + 重构）。评估投入产出比。

4. **Code Review Skill 仅在特定平台生效**：Review 类 Skill 依赖 AI 平台的支持，Cursor 和 Claude Code 的行为可能不同。

## 初级用法

- **单 Skill 使用**：只启用 `tdd-workflow`，让 AI 养成先写测试的习惯；

- **组合使用**：`tdd-workflow` + `strict-typescript` + `code-review` 三件套，适合正式项目；

- **按项目配置**：每个项目可以有不同的 `.claude/settings.json`，灵活控制 Skill 开关。

## 高级玩法

- **自定义渐进式披露层级**：修改 Skill 文件结构，添加更多层级（如"触发词→核心规则→完整规范"三层）；

- **和 CI 联动**：把 `code-review` Skill 的输出格式化成 CI Review 评论，自动贴到 PR；

- **编写自定义 Skill**：参考 Matt Pocock 的 Skill 格式，写团队专属的 TypeScript 规范 Skill。

## 小技巧

1. **逐 Skill 测试**：先装一个 Skill 验证效果，确认没问题再加第二个；

2. **监控 Token 消耗**：启用渐进式披露前后对比 token 消耗，验证是否真的节省 63%；

3. **结合 TypeScript 官方文档**：Skill 规则 + 官方文档，AI 写出的代码质量更高；

4. **在 Code Review 前跑一遍**：提交 PR 前让 AI 按 `code-review` Skill 自查一遍。

## 常见问题 FAQ

**Q1: Matt Pocock Skills 和 Anthropic 官方 Skills 有什么区别？**

A: Anthropic 官方 Skills 侧重具体功能（文档处理、前端设计等），Matt Pocock Skills 侧重**工程方法论**（TDD、代码审查、类型安全）。两者不冲突，可以同时使用。

**Q2: 渐进式披露机制是什么原理？**

A: 传统 Skill 把所有规则一次性加载到 prompt 里，无论当前任务是否需要。渐进式披露把规则分层：触发层（简短的触发词匹配）→ 核心层（关键规则）→ 完整层（全部细节）。AI 按需逐层加载，减少无关内容的 token 消耗。

**Q3: 必须用 TypeScript 吗？**

A: TDD Workflow 和 Code Review 两个 Skill 与语言无关，JavaScript 项目也能用。Strict TypeScript Skill 仅适合 TypeScript 项目。

**Q4: 支持 Cursor 吗？**

A: 支持。将 Skill 文件放到 `.cursor/rules/` 目录，Cursor 会自动加载。渐进式披露特性在 Cursor 上的效果取决于 Cursor 的 rules 加载机制。

**Q5: 能和 superpowers 等其他 Skill 套件一起用吗？**

A: 可以。但注意 `tdd-workflow` 和 Obra superpowers 的 `tdd` Skill 功能重叠——同时加载可能导致规则冲突或 token 浪费。建议二选一。

## 参考链接

- Matt Pocock Skills 仓库：<https://github.com/mattpocock/skills>

- Matt Pocock（Total TypeScript）：<https://www.totaltypescript.com>

- Claude Code Skills 文档：<https://docs.anthropic.com/en/docs/claude-code/skills>

- TypeScript strict 模式文档：<https://www.typescriptlang.org/tsconfig#strict>