skills

Skills for Real Engineers 是 Matt Pocock 维护的一个仓库，收录了用于日常软件工程工作的代理技能，可配合 AI 编码代理使用。这些技能来自作者本人的 .agents 目录，设计目标是小型、可适应、可组合且与模型无关。作者将它们与 GSD、BMAD、Spec-Kit 等更大型、会接管整体流程的方法区分开来，认为那些方案会夺走开发者的控制权；而这些技能则旨在融入开发者已有的工作流程。 安装提供两种方式：Claude Code 插件会将完整技能集作为托管的只读捆绑包安装，并自动更新；skills.sh 安装器则会把可编辑的技能文件复制到项目中，方便用户自行修改。安装完成后，需要在每个仓库中运行一次 setup-matt-pocock-skills 设置技能，用于配置问题跟踪器（GitHub、Linear 或本地文件）、分诊标签以及文档位置。 该仓库说明其动机是修复编码代理常见的失败模式： - 用户意图与代理构建结果不一致：通过在工作开始前对计划进行追问的 grilling 环节来解决，例如 grill-me 和 grill-with-docs。 - 代理输出冗长：通过在 CONTEXT.md 和 ADR 中记录共享领域语言来解决，使代理能够更简洁地推理和沟通。 - 代码无法运行：通过反馈循环解决，包括静态类型、浏览器访问和自动化测试，并提供 red-green-refactor 的 TDD 技能，以及分阶段的 diagnosing-bugs 调试循环。 - 架构腐化：通过关注设计的技能解决，鼓励构建深层模块，并定期对代码库进行架构调查。 技能主要分为两大类： 工程类技能包括用户调用的命令，例如 ask-matt（一个技能路由器）、grill-with-docs、triage、improve-codebase-architecture、to-spec、to-tickets、implement 和 wayfinder。模型调用的工程类技能包括 prototype、diagnosing-bugs、research、tdd、domain-modeling、codebase-design、code-review、resolving-merge-conflicts 和 wizard。模型调用技能可由代理在适当时自动调用；用户调用技能则负责编排工作流，并可能调用模型调用技能。 生产力类技能可用于编码之外的场景，包括用户调用的命令，例如 grill-me、handoff、teach、to-questionnaire 和 wait-what，以及可复用的 interviewing 基础技能 grilling，和用于编写代理可读文档（如 AGENTS.md 与 CLAUDE.md）的 writing-for-agents。 作者提供了一个 newsletter，用于跟踪技能的变化更新。仓库还在 ADR 目录中记录了设计决策，包括关于以 Claude Code 插件形式发布的决策。总体而言，这是一个实用的可复用工程实践库，以斜杠命令和代理可调用技能的形式呈现，面向希望更好地掌控 AI 代理如何编写软件的开发者。