GitHub 趋势 · 第 3 期
AI 写代码总翻车？这套 Skills 专治「假工程」
#AgentSkills#工程实践#MattPocock
结论前置
判断：mattpocock/skills 是 TypeScript 教育者 Matt Pocock 把自己日常真实工程里用的 Agent Skills 开源出来——小、可改、可组合，不接管你的流程。它不教你「怎么让 Agent 跑更快」，而是把软件工程的基本功（对齐、共享语言、TDD、架构审视）压成可复用的 slash 指令。MIT 协议，Claude Code 官方市场可直接装。
痛点场景
你让 Agent 写代码，常见四种翻车：① 它压根没理解你想要什么（沟通错位）；② 啰嗦到用 20 个词说 1 个词能讲清的事；③ 代码跑不起来、没有反馈闭环；④ 为了赶进度堆出一坨改不动的「泥球」。Agent 加速了产出，也加速了熵增——这是当下 AI 编码最容易被忽视的代价。
项目是什么
来自 Matt Pocock（Total TypeScript 作者、知名 TS 教育者）。一句话：把真实工程里被验证有效的做法，做成 Agent 能直接调用的小技能，而不是又一坨「流程接管」框架。README 里他点名了 GSD / BMAD / Spec-Kit 这类工具——它们想帮你接管过程，却顺手夺走了你的控制权，让流程里的 bug 更难修。这套 skills 反其道：小、易改、可组合、跨模型可用，基于数十年工程经验，鼓励你拿去改、变成自己的。
核心能力
Skills 分两类：用户触发（你主动敲 /xxx 编排），模型触发（Agent 在合适任务上自动调用，承载可复用纪律）。挑几个最硬的：
| 类别 | 代表 Skill | 作用 |
|---|---|---|
| 用户触发 | grill-me / grill-with-docs | 动手前先把需求和领域语言对齐，后者顺手更新 CONTEXT.md 与 ADR |
| 用户触发 | to-spec / to-tickets | 把对话转成 spec、拆成带依赖边的可追踪 ticket |
| 用户触发 | improve-codebase-architecture | 扫描代码库找「加深模块」机会，输出可视化 HTML 报告 |
| 模型触发 | tdd | 红-绿-重构循环，逐垂直切片写功能 / 修 bug |
| 模型触发 | diagnosing-bugs | 纪律化诊断循环：复现→最小化→假设→插桩→修复→回归 |
| 模型触发 | code-review | 双轴评审（规范 / spec），并行子 agent 互不污染 |
| 模型触发 | research | 基于高可信一手来源调研，产出带引用的 Markdown |
- ▪grilling 是底层访谈原语，被 grill-me、triage、wayfinder 等复用——一次写对，处处受益。
- ▪wizard 能生成交互式 bash 向导，把只有人能做的步骤（配密钥、走第三方后台）自动化。
上手：README 原文命令
README 给出两条安装路径，逐字引用：
# Claude Code（官方市场，自动更新） claude plugins install mattpocock-skills # 或在会话内 /plugin install mattpocock-skills # Codex 及其他 agent（写入可编辑的 skill 文件到仓库） npx skills@latest add mattpocock/skills # 每个仓库跑一次初始化 /setup-matt-pocock-skills # 想自己改、自己拉更新时用 npx skills update
README 强调：两条路二选一——Claude Code plugin 是只读托管包、随作者发布自动更新；skills.sh 是可编辑副本、写入你自己的仓库。两者都装会出现每个 skill 两份。
我的判断
适合谁：用 Claude Code / Codex 做真实项目、受够了「Agent 写一堆但质量不稳」的人；想把 TDD、对齐、架构审视这些基本功制度化、可复用的人。
不适合谁：只想要一键生成、不想操心流程的「纯 vibe coder」；团队已被某套重流程框架（GSD / BMAD）深度绑定、且不愿抽身的人。
坑：① 两条安装路径二选一，都装会每个 skill 重复；② /setup-matt-pocock-skills 需每个仓库跑一次，要选好 issue tracker、triage 标签、文档落点；③ 非 Claude Code 用户走 npx skills，更新需手动 npx skills update；④ 它本质是「纪律」不是「魔法」——指望装完 Agent 自动变强是误会，它给你的是可复用的最佳实践骨架。
数据脚注
仓库地址：mattpocock/skills（https://github.com/mattpocock/skills）
总 star：约 257k 本周新增：+21,684 许可证：MIT
技术栈：Agent Skills（Claude Code / Codex / 多 agent 兼容）· TypeScript 生态
抓取时间：2026-09-09（数据来自 GitHub Trending 官方页面实时快照）
互动与下期预告
你现在是「流程接管派」还是「小技能组合派」？评论区聊聊。下期我们蹲 DietrichGebert/ponytail——让 Agent 像房间里最懒的高级工程师那样思考：「最好的代码，是你从没写过的代码」。
#AgentSkills#工程实践#MattPocock