






















今天在 GitHub Trending 上看到一个很有深度的项目:Skills For Real Engineers,由知名 TypeScript 社区领袖 Matt Pocock 打造。这不是又一个"AI 编程提示词大全",而是一套基于数十年软件工程经验的可组合 Agent 技能体系,帮助开发者在 AI 编码时代写出真正可维护的软件。
Skills For Real Engineers 是一组精心设计的 AI Agent 技能(Skills),用于解决 Claude Code、Codex 等 AI 编程助手在日常工程中的核心痛点。与 GSD、BMAD、Spec-Kit 等框架不同,这些技能不会接管你的开发流程,而是小巧、可组合、适配任何模型,让开发者保持对过程的完全掌控。
项目目前在 GitHub 上已获得大量关注,Matt Pocock 的技术 Newsletter 订阅用户超过 60,000 人,可见其在开发者社区的影响力。
项目采用两层分类架构:
用户调用型技能(User-invoked)——由开发者主动触发,负责编排工作流。例如 /grill-me 在开始编码前对需求进行深度追问,确保开发者和 AI 对目标完全对齐;/to-prd 将当前对话综合为 PRD 文档并发布到 Issue Tracker。
模型调用型技能(Model-invoked)——可由 AI 代理在合适时机自动触发,承载可复用的工程纪律。例如 /tdd 强制执行红-绿-重构循环;/diagnosing-bugs 提供系统化的调试流程。
这种分层设计确保了用户始终掌握流程控制权,同时 AI 能在执行层面自动遵循最佳实践。
项目围绕 AI 编程中的四个经典失败模式构建:
对齐失败(“The Agent Didnt Do What I Want”):通过 /grill-me 和 /grill-with-docs 技能,在编码前进行深度质询会话,确保需求无歧义。
冗余输出(“The Agent Is Way Too Verbose”):通过 /grill-with-docs 构建共享领域语言(Shared Language),生成 CONTEXT.md 文档,让 AI 使用项目统一术语,大幅减少 token 消耗和冗长表达。
代码质量问题(“The Code Doesnt Work”):通过 /tdd 强制测试驱动开发循环,通过 /diagnosing-bugs 提供结构化调试方法论(复现→最小化→假设→插桩→修复→回归测试)。
架构退化(“We Built A Ball Of Mud”):通过 /improve-codebase-architecture 定期扫描代码库深度化机会,生成可视化 HTML 报告,并通过 /codebase-architecture 技能在日常开发中维护模块深度设计。
这是项目中最核心的设计思想之一。受 Eric Evans《领域驱动设计》启发,/grill-with-docs 技能会帮助团队建立项目专属术语表,写入 CONTEXT.md。效果示例:
共享语言不仅减少 AI 冗余输出,还带来连锁收益:变量/函数命名更一致、代码库更易导航、AI 思考消耗的 token 更少。
# 使用 skills.sh 安装器
npx skills@latest add mattpocock/skills
安装后按提示选择要安装的技能和目标代理,务必选择 /setup-matt-pocock-skills 进行初始配置。
在 AI 代理中运行 /setup-matt-pocock-skills,它会引导你完成:
/triage 技能使用)配置完成后即可开始使用全部技能。
一个典型的使用流程如下:
1. 需求对齐阶段
# 在 Claude Code 中输入
/grill-with-docs
AI 会开始深度追问你的需求,同时构建领域模型、更新 CONTEXT.md 和 ADR(架构决策记录)。
2. 任务拆分阶段
/to-issues
将 PRD 或需求拆分为独立的、可垂直切片的 Issue。
3. 编码执行阶段
AI 在编码时会自动触发 /tdd(红-绿-重构循环)和 /codebase-design(深度模块设计),无需手动干预。
4. 定期架构维护
/improve-codebase-architecture
每几天运行一次,扫描代码库中可以"加深"的模块,生成可视化报告后逐个改善。
除工程技能外,项目还提供通用生产力工具:
/handoff:将当前对话压缩为交接文档,方便切换到另一个 Agent 会话继续/teach:多会话渐进式教学技能,以当前目录为教学工作空间/ask-matt:智能路由器,根据你的场景推荐最合适的技能如果 npx skills@latest 执行失败,确保 Node.js 版本 ≥ 18,可尝试 npx --yes skills@latest add mattpocock/skills 强制安装。
确认已在安装时选中目标代理,并且 /setup-matt-pocock-skills 初始配置已完成。部分技能依赖配置文件中的路径设置。
Skills 项目设计为与任何模型配合使用。如果同时使用 GSD、BMAD 等框架,建议先评估是否有功能重叠,避免流程冲突。
CONTEXT.md 和 ADR 文件需要在 /grill-with-docs 会话中持续更新。如果发现 AI 回答开始变得冗长或不准确,可能是领域文档过时,建议重新运行一次 grill 会话。
Skills For Real Engineers 的核心理念非常清晰:软件工程的基本原则在 AI 时代比以往更重要。项目没有试图用新框架替代工程实践,而是将经典方法论(测试驱动开发、领域驱动设计、持续重构)封装为 AI 可执行的技能。
对于正在使用 AI 编程助手的开发者而言,这套技能体系提供了一条务实的中间道路——既不是放弃掌控的"全自动模式",也不是完全手工的"拒绝 AI",而是让 AI 在严格的工程纪律下发挥最大价值。正如 Matt Pocock 所引用的 Kent Beck 的话:“每天都在投资系统设计。” 在 AI 加速编码的今天,这句话的意义比任何时候都更重大。
项目地址:mattpocock/skills
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。