真实工程师的AI代理技能库

## 简介

`mattpocock/skills` 是一套面向真实工程师的 AI 代理技能集合，直接来自作者 Matt Pocock 的 `.claude` 目录。这些技能专注于实际的工程实践，而非“魔法编程”，旨在解决使用 Claude Code、Codex 等编码代理时的常见故障模式。

## 为什么需要这些技能

– **#1 代理没按我的想法做：** 沟通偏差导致结果不符合预期。解决方案是使用 `/grill-me` 或 `/grill-with-docs` 进行深入对齐。
– **#2 代理过于冗长：** 缺乏共享语言使代码和对话臃肿。`/grill-with-docs` 在面试中构建领域模型和共享术语，让代理使用精炼的表达。
– **#3 代码无法运行：** 反馈循环不足。提供 `/tdd`（测试驱动开发）和 `/diagnosing-bugs`（诊断错误）来建立红 - 绿 - 重构循环和系统调试流程。
– **#4 构建了“泥球”架构：** 代理加速开发也加速了软件腐化。通过 `/to-spec`、`/improve-codebase-architecture` 等技能持续关注设计，维持代码的深度和简洁。

## 技能概览

技能分为用户调用（编排型）和模型调用（自动触发）两类，覆盖工程与生产力：

### 工程技能（日常使用）
– `/grill-with-docs`：面试并构建领域模型，更新 CONTEXT.md 与 ADR。
– `/triage`：按状态机流转问题。
– `/improve-codebase-architecture`：扫描并重构代码库架构。
– `/to-spec`：将会话内容合成为规范并发布到事务追踪器。
– `/to-tickets`：将计划拆分为关联任务。
– `/implement`：基于规范驱动 `/tdd` 实施，并进行代码审查。
– `/wayfinder`：大型任务的路线规划。
– 模型调用技能包括 `/prototype`、`/diagnosing-bugs`、`/research`、`/tdd`、`/domain-modeling`、`/codebase-design`、`/code-review`。

### 生产力技能
– `/grill-me`：无文档的深入面试。
– `/handoff`：压缩会话为交接文档。
– `/teach`：在项目目录中进行状态化教学。
– `/writing-great-skills`：编写优质技能的参考指南。

## 快速开始

1. 运行安装器：`npx skills@latest add mattpocock/skills`
2. 选择所需技能和目标代理。
3. 运行 `/setup-matt-pocock-skills`，配置事务追踪器和标签。

## 许可

开源项目，具体许可证请查看仓库。

[来源](https://github.com/mattpocock/skills)