项目地址：https://github.com/mattpocock/skills
许可证：MIT
安装平台：skills.sh

一、项目概述

Skills For Real Engineers 是 TypeScript 与全栈开发领域知名开发者 Matt Pocock 开源的 AI 代理技能框架。该项目的核心理念是"为真实工程而非氛围编码"，将数十年的软件工程经验凝练为一套可复用、可组合的代理指令集，解决 AI 编码代理在实际工程中的四大失败模式：目标失准、输出冗余、代码失效和架构腐化。

与 GSD、BMAD、Spec-Kit 等试图"拥有流程"的方案不同，Skills 不接管开发流程，而是提供小型、可适配、可组合的指令单元，让开发者保留完整控制权的同时获得经验驱动的工程实践指导。每个 Skill 兼容任意模型，通过 skills.sh 平台一键安装，30 秒即可完成配置。

二、解决的四大核心问题

2.1 目标失准：代理未做你想要的

软件开发中最常见的失败模式是对齐失误——你以为开发者知道你要什么，但结果却完全偏离。AI 代理同样存在这个问题。解决方案是"烤问会话"（Grilling Session），让代理反复质问你关于目标的细节，在动手之前充分对齐。核心技能包括 /grill-me（通用场景）和 /grill-with-docs（工程场景），被认为是本仓库最受欢迎的技能。

2.2 输出冗余：代理过于啰嗦

代理被抛入项目后往往需要自行猜测术语，导致用 20 个词解释本可以 1 个词说清的内容。解决方案是建立共享语言（Shared Language）：通过 CONTEXT.md 文档和架构决策记录（ADR）将项目术语标准化。例如，将"当课程章节中的课时被赋予文件系统位置"简化为"物化级联"（Materialization Cascade），简洁性在每个会话中持续收益。这同时带来变量命名一致、代码导航性提升和 Token 消耗降低等附加效益。

2.3 代码失效：缺乏反馈循环

当目标已对齐但代理仍产出垃圾代码时，根因往往在于反馈循环缺失。代理无法感知代码的实际运行效果，自然无法自我纠正。解决方案包括静态类型、浏览器访问和自动化测试等反馈机制，其中红绿重构（Red-Green-Refactor）的 TDD 循环至关重要。/tdd 技能将此实践封装为可复用指令，/diagnose 技能则将调试最佳实践包装为"复现→最小化→假设→探针→修复→回归测试"的结构化循环。

2.4 架构腐化：代码库变成泥球

AI 代理加速了编码，也加速了软件熵变。代码库复杂度以前所未有的速度增长。解决方案是"关注代码设计"——这在 AI 时代比任何时候都更重要。/to-prd 在创建 PRD 时审视模块边界，/zoom-out 让代理从系统全局视角理解代码，/improve-codebase-architecture 则基于 CONTEXT.md 和 ADR 发现模块深化机会，建议每隔几天运行一次。

三、技能清单

3.1 工程技能（Engineering）

3.2 效率技能（Productivity）

3.3 其他工具（Misc）

四、快速上手

安装过程极简，仅需三步：

1. 执行 npx skills@latest add mattpocock/skills 安装技能
2. 选择所需技能和目标代理（必选 /setup-matt-pocock-skills）
3. 运行该技能完成仓库配置初始化

配置内容包括 Issue 追踪器选择（GitHub/Linear/本地文件）、分类标签词汇和文档存储位置。整个过程 30 秒即可完成。

五、评估与建议

Skills 项目的核心价值在于将软件工程基本功——对齐、简洁、反馈、设计——转化为 AI 代理可直接消费的可重复实践。其"小而组合"的设计哲学避免了流程框架的僵化问题，让团队能够根据项目需要灵活组合。对于已采用 AI 编码代理但受困于质量不可控的团队，建议优先采纳 /grill-with-docs 和 /tdd 两项核心技能，分别解决对齐和质量反馈问题。