跳转到内容
逍遥自在轩

Skills for Real Engineers - 开源琅嬛阁

mattpocock/skills

Skills for Real Engineers. Straight from my .agents directory.

1
201
178,620
15.3k
github.com · mattpocock/skills
AI 编程Agent工作流
在 GitHub 查看

项目介绍

Skills for Real Engineers 是 Matt Pocock 从日常 .agents 目录公开的一套 面向真实工程的 Agent 技能库。它刻意做成小而可组合、易改写的技能，而不是接管整条研发流程的大型方法论（如 GSD、BMAD、Spec-Kit）。目标是修复 Claude Code、Codex 等编码代理常见的四类失败：需求错位、表述冗长、代码不可靠、架构迅速腐化，让你在保留控制权的前提下，用可重复的工程纪律交付应用。

核心特性

  • /grill-me / /grill-with-docs：动手前强制「拷问」对齐需求；后者还会沉淀项目领域语言（CONTEXT.md）与 ADR
  • 反馈闭环技能：/tdd（红绿重构）、/diagnosing-bugs（复现 → 假设 → 观测 → 修复）、/code-review（规范轴 + 规格轴双审查）
  • 架构与规格工具：/to-spec、/to-tickets、/implement、/improve-codebase-architecture、/wayfinder 覆盖从规格到大块工作拆解
  • 用户触发 vs 模型触发：用户斜杠命令负责编排；模型可自动调用的技能承载可复用纪律，避免技能互相嵌套失控
  • 双安装哲学：skills.sh 拷贝进项目可本地改写；Claude Code 插件则以只读托管包跟随上游更新

对用户价值

Agent 最常见的问题不是「不会写代码」，而是没对齐就开写、缺少共享术语导致啰嗦、没有测试与调试闭环、以及高速编码加速软件熵增。这套技能把 Pragmatic Programmer、DDD、TDD 与深模块设计等工程基本功压缩成可调用流程：先 grilling 对齐，再建立领域语言，用 TDD/诊断技能保证反馈，用架构技能定期「救泥球」。适合想认真交付产品、又不想把流程主权交给黑盒方法论的人。

与替代方案

  • 相比 Superpowers 与 Agent Skills 等「完整方法论 / 全生命周期工作流」包，本仓库强调 小技能可组合、可本地 hack，明确反对由方法论「拥有」整条流程。
  • 相比 Karpathy Coding Guidelines 等单文件行为准则，这里提供 可触发的 grilling、规格、TDD、审查与架构改进技能链，而不只是编码克制原则。
  • 相比 GSD / BMAD / Spec-Kit 一类重流程框架：它们帮你推进过程，但常削弱你对中间步骤与故障排查的控制；本仓库刻意把控制权留在用户与可编辑 skill 文件中。
  • 若你需要官方 Agent Skills 规范与跨宿主分发标准，可并行参考 agentskills.io / Anthropic skills 生态；本仓库是方法论实践集，不是规范本身。

适应人群

  • 使用 Claude Code、Codex、Cursor 等 Agent，希望先对齐再写代码的工程师。
  • 受够 vibe coding，想把 TDD、领域语言与代码审查嵌回日常 Agent 流程的个人开发者。
  • 需要可 fork、可改写技能包，而不是订阅黑盒研发框架的团队与 Tech Lead。

如何使用

前置条件

  • 已安装可运行 Agent Skills 的宿主（Claude Code、Codex，或 skills.sh 支持的其他 harness）。
  • Node.js / npx 可用（skills.sh 安装路径）；或已安装 Claude Code CLI（插件路径）。
  • 每个仓库首次使用前需运行一次 /setup-matt-pocock-skills 完成配置。

安装方式

方式 A：skills.sh（可编辑副本，推荐想本地改写时）

Terminal window
npx skills@latest add mattpocock/skills

安装时选择需要的 skills 与目标 Agent，并确保勾选 /setup-matt-pocock-skills。

方式 B：Claude Code 插件（只读托管、跟随上游更新）

在 Claude Code 内：

/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

或在 shell：

Terminal window
claude plugin marketplace add mattpocock/skills
claude plugin install mattpocock-skills@mattpocock

首次运行

在目标仓库中运行 /setup-matt-pocock-skills，按提示选择：

  1. Issue tracker（GitHub / Linear / 本地文件）
  2. triage 所用标签（供 /triage 使用）
  3. 文档存放位置（如 CONTEXT.md、ADR 目录）

之后对任意变更先跑 /grill-me 或 /grill-with-docs，再进入规格、实现与审查。

验证是否成功

  • /setup-matt-pocock-skills 能完成问答并写入配置。
  • 能调用 /grill-me（或 /grill-with-docs）并对计划展开追问。
  • 工程类技能（如 /tdd、/to-spec）可在对应场景被触发或手动调用。
  • 使用 skills.sh 时，项目内应出现可编辑的 skill 文件；使用插件时，技能以托管包形式可用。

常见坑 / 注意事项

  • 务必先 setup：跳过 /setup-matt-pocock-skills 时，依赖 issue tracker / 标签 / 文档路径的工程技能可能行为异常。
  • 两种安装别混用预期：skills.sh 适合 fork 改造；插件适合「订阅 Matt 的集合」——本地改插件内容不会持久，也不应指望。
  • Codex 等非 Claude 宿主：当前通过 skills.sh 安装；原生 Codex 插件仍在路线图上（见仓库 ADR）。
  • grilling 会变慢变深：这是刻意设计；小改动可酌情缩短，但核心价值就在对齐，不要为了速度完全跳过。
  • 技能会随上游演进，关注 CHANGELOG 与作者 newsletter。