0%

MattPocock Skills 工具集完整指南

Posted on Edited on In ,
Symbols count in article: 3k Reading time ≈ 3 mins.

MattPocock Skills 工具集完整指南

官方仓库: mattpocock/skills

📝 前言

MattPocock Skills 是一个专注于 TypeScript/React 开发 的 AI 技能集，包含 4 大类共 16 个技能，涵盖从需求设计到代码实现的完整开发流程。无论你是想创建 PRD、进行 TDD 开发，还是设置 Git 护栏，都能找到对应的技能来提升效率。

二、技能总览

MattPocock Skills 包含 4 大类共 16 个技能：

分类 技能数量 主要用途
规划与设计 6 PRD创建、计划生成、接口设计
开发 5 TDD、重构、问题分类
工具与设置 2 Git 护栏、预提交钩子
写作与知识 4 技能创建、文章编辑、知识管理

三、规划与设计

write-a-prd | 创建 PRD

用途: 通过交互式访谈、代码库探索和模块设计，创建完整的产品需求文档。

特点: - 交互式需求访谈 - 代码库现状探索 - 模块化设计方案 - 直接提交为 GitHub Issue

使用场景: 项目启动、需求不明确、团队协作

prd-to-plan | PRD 转计划

用途: 将 PRD 转换为多阶段实施计划。

特点: - 垂直切片追踪 - 阶段性里程碑 - 可执行的实施步骤

使用场景: PRD 创建后、需要明确开发步骤

prd-to-issues | PRD 转 Issues

用途: 将 PRD 分解为可独立领取的 GitHub Issues。

特点: - 自动拆分任务 - 独立可执行 - 便于团队分配

使用场景: 多人协作、任务分配

grill-me | 深入追问

用途: 对计划或设计进行深入追问，直到决策树的每个分支都被解决。

特点: - Socratic 追问法 - 决策树穷举 - 风险提前识别

使用场景: 设计评审、计划审查、风险评估

design-an-interface | 接口设计

用途: 使用并行子代理生成多个完全不同的接口设计方案。

特点: - 多方案并行生成 - 不同设计思路 - 便于对比选择

使用场景: 新功能设计、API 设计、组件设计

request-refactor-plan | 重构计划

用途: 通过用户访谈创建详细的重构计划。

特点: - 需求收集 - 影响分析 - 分阶段实施

使用场景: 大型重构、遗留代码改造

四、开发

tdd | 测试驱动开发

用途: 红-绿-重构循环，一次构建一个垂直切片的功能或修复 bug。

特点: - RED: 先写测试 - GREEN: 通过测试 - REFACTOR: 重构优化 - 垂直切片开发

使用场景: 新功能开发、Bug 修复、代码改进

triage-issue | 问题分类

用途: 探索代码库调查 bug，确定根本原因，并提交基于 TDD 的修复计划。

特点: - 代码库探索 - 根因分析 - TDD 修复方案

使用场景: Bug 调试、问题调查

improve-codebase-architecture | 改进架构

用途: 探索代码库的架构改进机会，专注于深化浅层模块和改进可测试性。

特点: - 架构分析 - 模块化建议 - 可测试性提升

使用场景: 代码重构、架构优化

migrate-to-shoehorn | 类型迁移

用途: 将测试文件从 as 类型断言迁移到 @total-typescript/shoehorn。

特点: - 类型断言规范化 - 类型安全提升 - 自动化迁移

使用场景: TypeScript 类型优化

scaffold-exercises | 脚手架练习

用途: 创建包含 sections、problems、solutions 和 explainers 的练习目录结构。

特点: - 标准练习结构 - 问题-解决方案 - 解释说明

使用场景: 教学材料、练习题创建

五、工具与设置

setup-pre-commit | 预提交钩子

用途: 设置 Husky 预提交钩子，包含 lint-staged、Prettier、类型检查和测试。

特点: - Husky 集成 - lint-staged - Prettier 格式化 - 类型检查 - 测试运行

使用场景: 项目初始化、团队规范化

git-guardrails-claude-code | Git 护栏

用途: 设置 Claude Code 钩子，在危险 git 命令执行前进行阻止。

保护命令: - git push --force - git reset --hard - git clean -f - 其他危险操作

使用场景: 防止误操作、保护代码安全

六、写作与知识

write-a-skill | 编写技能

用途: 使用正确的结构、渐进式披露和捆绑资源创建新技能。

特点: - 标准技能结构 - 渐进式内容 - 资源打包

使用场景: 创建自定义技能、技能库扩展

edit-article | 编辑文章

用途: 重构章节、提高清晰度和精简文章来改进文章。

特点: - 章节重构 - 清晰度提升 - 内容精简

使用场景: 文章优化、技术文档改进

ubiquitous-language | 通用语言

用途: 从当前对话中提取 DDD 风格的通用语言词汇表。

特点: - DDD 术语提取 - 词汇表生成 - 团队对齐

使用场景: DDD 设计、团队术语统一

obsidian-vault | Obsidian 知识库

用途: 在 Obsidian 知识库中搜索、创建和管理笔记。

特点: - wikilinks 支持 - 索引笔记 - 双向链接

使用场景: 知识管理、第二大脑

七、安装方法

安装单个技能

1
2
3
4
5
6
7
8
# 安装 TDD 技能
npx skills@latest add mattpocock/skills/tdd

# 安装 PRD 创建技能
npx skills@latest add mattpocock/skills/write-a-prd

# 安装 Git 护栏
npx skills@latest add mattpocock/skills/git-guardrails-claude-code

完整安装

1
2
# 安装所有技能
npx skills@latest add mattpocock/skills

八、使用示例

TDD 开发流程

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
用户: 用 TDD 开发一个用户认证模块

Claude: [激活 tdd 技能]
🔄 开始 TDD 循环...

RED 阶段:
  - 编写用户注册测试
  - 编写登录测试
  - 编写会话管理测试

GREEN 阶段:
  - 实现最小代码通过测试

REFACTOR 阶段:
  - 优化代码结构
  - 提升可读性

✅ 垂直切片完成

PRD 创建流程

1
2
3
4
5
6
7
8
9
10
11
12
用户: 帮我写一个 PRD

Claude: [激活 write-a-prd 技能]
📋 开始需求访谈...

访谈问题:
  1. 这个功能的目的是什么？
  2. 目标用户是谁？
  3. 核心功能有哪些？
  ...

✅ PRD 创建完成

九、技能对比矩阵

技能 TypeScript React Git 文档 团队协作
write-a-prd ⚪ ⚪ ✅ ✅ ✅
prd-to-plan ⚪ ⚪ ✅ ✅ ✅
tdd ✅ ✅ ⚪ ⚪ ⚪
triage-issue ✅ ✅ ⚪ ⚪ ⚪
setup-pre-commit ✅ ✅ ✅ ⚪ ✅
write-a-skill ⚪ ⚪ ⚪ ✅ ⚪

图例: ✅ 强相关 | ⚪ 不直接相关

十、推荐技能组合

TypeScript 开发者必装

技能 原因
tdd 提升代码质量
migrate-to-shoehorn 类型安全
setup-pre-commit 开发规范化

团队协作

技能 原因
write-a-prd 需求清晰
grill-me 风险识别
ubiquitous-language 术语统一

知识管理

技能 原因
write-a-skill 沉淀经验
obsidian-vault 知识积累
edit-article 内容优化

十一、结语

MattPocock Skills 为 TypeScript/React 开发者提供了一套完整的技能工具集，从需求设计到代码实现，覆盖了软件开发的全流程。通过灵活组合这些技能，可以显著提升开发效率和代码质量。

小贴士: 建议从 tdd 和 setup-pre-commit 开始，这两个技能可以立即提升代码质量。

Happy TypeScript Coding! 🚀

-------------This blog is over! Thanks for your reading-------------