Matt Pocock（Total TypeScript 作者）出品的 Agent Skill 集，面向真实工程场景，反对”vibe coding”。119.5k stars，Shell，MIT 协议。
“My agent skills that I use every day to do real engineering - not vibe coding.”
强调小巧、可组合、易改造，直接从多年工程经验中提炼，解决 Claude Code 等 Agent 的四大真实失效场景。
安装
npx skills@latest add mattpocock/skills
# 安装后运行（首次配置）
/setup-matt-pocock-skills/setup-matt-pocock-skills 会引导配置：Issue Tracker（GitHub/Linear/本地文件）、Triage 标签体系、文档存储路径。
四大核心问题与对应 Skill
问题 1：Agent 没做我想要的（对齐失败）
/grill-me— 通用需求深度追问（非代码场景）/grill-with-docs— 带文档的追问：在提问的同时更新CONTEXT.md（共享语言文档）和 ADR（架构决策记录）
核心思想：对齐优先于实现。每次改动前都用这两个 Skill。
问题 2：Agent 表述太冗余（缺乏共享语言）
/grill-with-docs帮助建立项目 Domain 语言（CONTEXT.md），让 Agent 用 1 个词表达原来需要 20 个词的概念，同时提升变量/函数命名一致性，减少 Agent 思考 token 消耗。
问题 3：代码跑不起来（缺乏反馈闭环）
/tdd— TDD：红-绿-重构循环，先写失败测试再实现，提供一致的代码质量反馈/diagnose— 严格调试循环：复现→最小化→假设→插桩→修复→回归测试
问题 4：代码变成大泥球（架构熵增）
/to-prd— 从当前对话生成 PRD 并提交为 GitHub Issue/zoom-out— 要求 Agent 在整体系统上下文中解释代码（而非局部）/improve-codebase-architecture— 扫描代码库，结合CONTEXT.md和 ADR 找到可深化的模块边界（建议每几天运行一次）
完整 Skill 列表
Engineering（工程，每日使用）
| Skill | 说明 |
|---|---|
diagnose | 严格调试循环：复现→最小化→假设→插桩→修复→回归测试 |
grill-with-docs | 带文档的需求追问，更新 CONTEXT.md 和 ADR |
triage | 通过状态机角色流程处理 Issue |
improve-codebase-architecture | 基于领域语言和 ADR 发现架构深化机会 |
setup-matt-pocock-skills | 首次配置（Issue Tracker/标签/文档路径） |
tdd | TDD 红-绿-重构循环，垂直切片一次一个特性 |
to-issues | 将计划/规格/PRD 拆解为独立可认领的 GitHub Issues |
to-prd | 从当前对话直接合成 PRD 提交为 Issue |
zoom-out | 要求 Agent 给出代码的整体系统视角 |
prototype | 构建一次性原型（终端 App 或多种 UI 变体）验证设计 |
Productivity（生产力，通用工作流）
| Skill | 说明 |
|---|---|
grill-me | 深度追问计划/设计，直到每个决策分支都明确 |
caveman | 极简压缩通信模式，减少约 75% token，保持技术准确性 |
handoff | 将当前对话压缩为交接文档，供另一个 Agent 续接 |
write-a-skill | 创建新 Skill（含结构规范和渐进式披露） |
Misc（工具类）
| Skill | 说明 |
|---|---|
git-guardrails-claude-code | 设置 Claude Code Hook 阻断危险 git 命令（push/reset —hard/clean 等） |
setup-pre-commit | 配置 Husky pre-commit：lint-staged/Prettier/类型检查/测试 |
scaffold-exercises | 创建课程练习目录结构 |
migrate-to-shoehorn | 迁移测试文件中的 as 类型断言 |
设计哲学
与 GSD、BMAD、Spec-Kit 等”拥有整个流程”的方案不同，这套 Skill 强调：
- 小且可组合：每个 Skill 专注一件事，自由搭配
- 保留控制权：不接管流程，只增强特定环节
- 软件工程基本功优先：TDD、DDD 共享语言、架构思考——这些在 AI 时代比以往更重要，而非更不重要
关联页面
- skills-cli — npx skills CLI，本项目通过此工具安装
- agent-skill-self-update — Skill 自更新机制
- superpowers — 同类工程方法论 Skill 集，风格更重量级
- wezzard-skills — 类似的计划驱动开发 Skill 集（7 个 Skill）
- ecc — 同类 Harness 性能优化系统，更大规模