一页看懂 Agent Skills 怎么用
Skills 是给 AI 编程助手的专业工作流程。Claude Code 和 Codex 都可以借助这类 skill，把“我现在遇到什么场景，该走什么流程”变成稳定、可教学、可复用的操作方式。
安装 Claude Code
Claude Code 是 Anthropic 官方的 CLI 工具，支持 macOS、Linux 和 Windows（WSL）。安装完成后即可在终端里直接调用所有 agent skills。
前置要求
- Node.js 18+推荐用最新 LTS 版本。运行 node -v 检查。
- git需要已配置好 git，因为 Claude Code 会读取仓库上下文。
- Anthropic API 权限需要能访问 Claude API（claude.ai 账户或企业授权）。
方式一：npm 安装（推荐）
适合已经装了 Node.js 的用户，后续升级也最方便。
安装完成后运行 claude --version 确认。
方式二：curl 一键安装
适合不想配 npm 环境，或想快速尝鲜的用户。
脚本会自动下载最新版并放到 ~/.local/bin 等可执行路径。
安装社区 Skills
Claude Code 本体安装后，还需要安装具体的 skill 集合。下面两个是社区最常用、课堂推荐优先配置的来源。
mattpocock/skills（工程技能集）
包含 diagnose、tdd、to-prd、to-issues、zoom-out 等核心工程 skill，是本指南的主要参考来源。
安装后运行 /setup-matt-pocock-skills 初始化项目配置（issue tracker、标签、文档目录等）。
andrej-karpathy-skills（行为指南）
不是传统 skill，而是一套编码行为约束（编码前思考、简洁优先、精准修改、目标驱动执行）。
把 CLAUDE.md 放到项目根目录即可生效。也可通过插件市场安装：/plugin marketplace add forrestchang/andrej-karpathy-skills。
首次运行与登录
1. 启动并登录
在任意 git 仓库目录下运行：
第一次使用会弹出浏览器 OAuth 登录，按提示完成授权即可。
2. 常用入口命令
- claude进入交互式对话（推荐日常用法）。
- claude "你的指令"单条命令模式，执行完自动退出。
- claude --version查看当前版本。
- claude config查看或修改配置项（主题、模型等）。
claude --version 验证安装成功，再进入交互模式体验第一个 skill（例如 diagnose 或 zoom-out）。
快速理解
把 skill 想成“给 AI 编程助手的专业作业指导书”。普通聊天靠模型常识，skill 会额外加载本地说明、流程、脚本、模板和约束。
怎么调用
你可以显式点名，也可以自然描述任务。教学时建议先让学员显式点名，形成稳定心智模型。
显式调用
-
直接说 skill 名
例如：
用 diagnose 帮我排查这个报错 -
用英文触发词
例如：
grill me 这个架构方案 -
组合多个 skill
例如：
先用 to-prd 写 PRD，再用 to-issues 拆任务
自然触发
-
描述问题即可
例如：
这个测试一直 flaky，帮我 debug会触发诊断流程。 -
说清楚产物
例如：
把这个方案拆成可交给 agent 做的 issues。 - 给上下文越具体越好 包括 repo、错误日志、目标用户、约束、验收标准。
场景选择器
不知道用哪个 skill 时，从左边的问题开始找。
| 你现在想做什么 | 优先用 | 适合这样说 |
|---|---|---|
| 排查 bug、报错、性能变慢 | diagnose |
用 diagnose 查这个登录失败的问题，先复现再修 |
| 按测试驱动开发一个功能 | tdd |
用 tdd 做导出 CSV 功能，先写失败测试 |
| 把想法写成产品需求 | to-prd |
用 to-prd 把上面的讨论整理成 PRD |
| 把计划拆成任务卡 | to-issues |
用 to-issues 把这个 PRD 拆成可独立开发的 issues |
| 整理、分类、推进 issue | triage |
用 triage 帮我整理这些 bug report，判断下一步状态 |
| 被追问方案是否靠谱 | grill-me |
grill me 这个课程设计，每次问一个问题并给建议答案 |
| 结合项目文档挑战方案 | grill-with-docs |
用 grill-with-docs 检查这个设计是否符合领域模型 |
| 看不懂一片代码 | zoom-out |
用 zoom-out 解释这个模块在整个系统里的位置 |
| 找架构重构机会 | improve-codebase-architecture |
用 improve-codebase-architecture 找出这个 repo 的深层重构机会 |
| 打开本地网页、点按钮、截图测试 | browser-use:browser |
用 browser-use 打开 localhost:3000，检查移动端布局 |
Skill 总览
搜索 skill 名、用途、关键词或示例话术。分类按钮可以快速缩小范围。
组合工作流
真正高效时，skill 往往不是单点使用，而是串成一个课堂可复用流程。
从想法到开发任务
grill-me追问目标用户、范围、边界。to-prd生成 PRD，补齐验收标准。to-issues拆成可独立交付的任务。triage给任务标状态、优先级和下一步。
从 bug 到可靠修复
diagnose建立可复现反馈环。- 列出可证伪假设并逐个验证。
tdd把复现固化为回归测试。- 实现修复，跑测试确认问题消失。
从混乱代码到架构改进
zoom-out先理解系统地图。setup-matt-pocock-skills补齐 repo 规则。improve-codebase-architecture找深层重构机会。grill-with-docs结合领域文档敲定方案。
逐个详解
这里适合课后查阅。每个条目都包含“什么时候用、不要什么时候用、推荐话术”。
常见问题
必须写 skill 名吗？
不必须。Claude Code 和 Codex 都可以根据请求意图触发合适流程。但教学时建议显式写 skill 名，因为学员能更快建立“场景到工具”的映射。
一个任务能用多个 skill 吗？
可以。比如先 grill-me 澄清方案，再 to-prd 写需求，最后 to-issues 拆任务。顺序比数量更重要。
skill 会自己改代码吗？
有些会。比如 diagnose、tdd、improve-codebase-architecture 可能会读写代码和跑测试。grill-me 更偏讨论，不会急着动手。
课堂上先教哪些？
建议先教 diagnose、tdd、to-prd、to-issues。这四个覆盖“发现问题、修复问题、定义需求、拆解执行”。