给 AI 编码代理装上工程化技能

你有没有遇到过这些问题：AI 代理不明白你到底想要什么？生成的代码跑不起来？对话越来越长但没结论？代码库越改越乱？

TypeScript 专家 Matt Pocock 创建了一套 Agent Skills——专门解决 AI 编码代理在实际工程中的常见失败模式。而这个仓库将其完整翻译为中文，让中文开发者也能无障碍使用。

快速安装

npx skills@latest add vinvcn/mattpocock-skills-zh-CN

核心技能一览

工程技能

• diagnose（诊断）——严谨的调试循环：复现 → 最小化 → 假设 → 检测 → 修复 → 回归测试。告别盲猜式调试。
• grill-with-docs（文档拷问）——让 AI 的计划对照现有领域模型和 ADR 进行审查，自动更新 CONTEXT.md。确保新代码不走偏。
• triage（分类）——用状态机自动分类 Issue，不再遗漏和混乱。
• improve-codebase-architecture（架构改进）——根据领域语言和 ADR 发现代码库的改进机会，对抗软件熵。
• tdd（测试驱动开发）——红-绿-重构循环，一次构建一个垂直切片。让 AI 不再瞎写代码。
• to-issues（拆解为 Issue）——将计划/规格/PRD 拆分为独立 Issue，每个 Issue 有清晰的垂直切片。
• to-prd（生成 PRD）——将会话上下文综合为结构化的 PRD 文档。
• zoom-out（全局视角）——快速理解不熟悉的代码区域，获得更广泛的上下文。

效率技能

• caveman（穴居人模式）——超压缩沟通，减少约 75% 的 token 消耗。和 AI 对话更省钱。
• grill-me（拷问我）——持续追问，直到每个决策分支都被理清。避免模糊需求。
• handoff（交接）——将会话压缩为交接文档，方便另一个代理无缝接手。
• write-a-skill（写技能）——脚手架工具，快速创建新的 Skill。

其他实用技能

• git-guardrails-claude-code——防止 Claude Code 执行危险的 git 命令
• setup-pre-commit——配置 Husky + lint-staged + Prettier + 类型检查 + 测试的 pre-commit 钩子
• scaffold-exercises——练习目录结构生成器

解决的问题

问题	对应技能
AI 不明白你想要什么	grill-me, grill-with-docs
AI 太啰嗦、token 消耗大	caveman, grill-with-docs
生成的代码跑不起来	tdd, diagnose
代码库越改越乱	to-prd, zoom-out, improve-codebase-architecture

总结

Matt Pocock 的 Agent Skills 是目前最系统的 AI 编码代理工作流方案之一。这个中文翻译版让中文开发者能以更低的门槛使用这些技能。如果你在用 Claude Code 或 Codex 做实际工程，这套技能能让你从"让 AI 写代码"升级为"让 AI 按工程规范写代码"。

▶ 前往 GitHub 仓库 · 342 ★