技能库：把重复的流程沉淀下来
一句话：提示词管这一次，Skills 管这一类，项目指令管整个项目，Agents 负责跑腿。 这一页讲清它们的关系，并给一份「常见技能 + 作用」的推荐清单。
一、四样东西，一张表说清
| 提示词 | Skill（技能） | 项目指令文件 | Agent | |
|---|---|---|---|---|
| 是什么 | 对话框里的一句话 | 一份「这类任务怎么做」的说明书 | 项目的长期规矩 | 能自主干多步活的智能体 |
| 寿命 | 一次性 | 长期保存，随项目走 | 长期保存 | 单次任务 |
| 什么时候被读到 | 你发出去的那一刻 | 遇到相关任务时（也可手动调用） | 每次会话自动读 | 被派出去时 |
| 谁触发 | 你 | AI 按需 / 你手动 | 工具自动 | 你 |
| 适合 | 临时、一次性需求 | 反复出现的多步流程 | 项目约定、风格、禁止事项 | 研究、并行、长任务 |
| 常见形态 | 一句话 | SKILL.md + 可选脚本/模板 | AGENTS.md / CLAUDE.md | 子代理 / 分身 |
关系一句话：规矩（项目指令）常驻 → 手艺（Skill）随取 → 这一次（提示词）现说 → 跑腿（Agent）外包。
为什么 Skill 不是「更长的提示词」
- 提示词活在当前会话里，换个会话就没了；Skill 存在文件里，随项目走、可提交、可分享。
- 提示词每次都要重打一遍；Skill 平时不占上下文，用到才加载。
- 判断标准只有一条：这事你是不是重复干第三遍了？ 是，就该沉淀成 Skill。
概念辨析与提示词写法见Vibe Coding 入门教程与提示词与上下文工程。
二、常见技能推荐（含作用）
| 场景 | 技能 | 作用是…… |
|---|---|---|
| 代码审查 | /code-review（Claude Code）；/review-bugbot、/review-security（Cursor） | 只审不改，按严重程度列出问题与证据——专治「AI 说完成了」 |
| 调试排错 | /debug（Claude Code 内置）、/diagnosing-bugs | 按「现象 → 复现 → 证据 → 根因」走，而不是东补西补 |
| 文档处理 | pdf、docx、pptx、xlsx（Anthropic 官方 document-skills） | 直接读写 PDF / Word / PPT / Excel，省掉手工复制粘贴 |
| 前端与设计 | frontend-design、canvas-design、web-artifacts-builder | 生成界面、海报、可交互网页原型 |
| 需求与产品 | 需求分析 / PRD / 原型类技能 | 把一句想法整理成需求清单、PRD、界面草图——动手之前最有用 |
| 提交与协作 | 提交信息与拆分类（如 Cursor 的 /split-to-prs） | 生成规范提交信息，把大改动拆成多个小 PR |
| 计划与测试 | /plan、/tdd | 先出可验证的计划；测试先行，改 bug 先写会失败的测试 |
| 自己造技能 | skill-creator、/create-skill | 把反复交代的流程，直接写成一份新技能 |
选技能的原则：先看你重复干过什么，再去找对应的技能；不要为了装而装。
三、自己写一个最小 Skill
一个 Skill 就是一个文件夹 + 一个 SKILL.md：
markdown
---
name: commit-message
description: 按项目规范生成提交信息。当用户要提交代码，或提到「提交」「commit」时使用。
---
## 我要做什么
- 先看 `git status` 和 `git diff`
- 按 `<type>: <中文简述>` 生成提交信息（feat / fix / docs / refactor）
- 一个行为一次提交；检查没通过就不要提交
## 什么时候用我
用户准备提交代码时。三条要点：
name+description必填。description一定要写清「什么时候用我」——AI 就是靠它判断该不该加载这个技能。- 正文写「怎么做」，可以带脚本和模板（放进同目录的
scripts/、assets/）。 - 描述要具体：
提交信息规范比帮我写代码好一万倍。
四、放哪里
技能放在约定目录里，工具启动时自动扫描：
| 工具 | 项目级 | 用户级（全局） |
|---|---|---|
| 跨工具通用 | .agents/skills/<name>/SKILL.md | ~/.agents/skills/ |
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| opencode | .opencode/skills/ | ~/.config/opencode/skills/ |
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| Codex | .agents/skills/ | ~/.agents/skills/ |
项目级的技能可以提交进 Git，团队共享；用户级的只对你本人生效。各工具的完整规则见下方文档。
五、去哪找
- Agent Skills 开放标准：agentskills.io —— 技能格式通用规范，一次写好、多工具通用
- Anthropic 官方技能库：github.com/anthropics/skills —— 文档处理、设计、前端等示例技能；Claude Code 里执行
/plugin marketplace add anthropics/skills即可浏览安装 - Claude Code 技能文档：code.claude.com/docs/en/skills
- Codex 技能文档：developers.openai.com/codex/skills
- Cursor 技能文档：cursor.com/docs/context/skills
- opencode 技能文档：opencode.ai/docs/skills
- 陶渊明 harness（本站作者出品）：github.com/Thorleying/tyuanming-releases —— 内置一批开箱即用的技能，装好即用