agent-skills 完整教程：10 分钟装好并配置 AI 编码代理技能
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
agent-skills 是一套面向 AI 编码代理的生产级工程技能集合。它把资深工程师依赖的工作流——测试先行、合并前审查、小步迭代——写进可加载的技能文件，让 AI 代理写代码时也遵守可验证的标准。
30 秒认知 agent-skills：是什么、不是什么
| 问题 | 答案 |
|---|---|
| 是什么 | 一组 Markdown 技能文件，skills/ 下每个子目录是一个技能，使用时机、执行步骤、验证标准都写在 SKILL.md 里 |
| 不是什么 | 不是代码生成工具，也不是 IDE。它不替代你的 AI 工具，而是给支持 Markdown 指令的工具注入方法论 |
| 适合谁 | 日常用 AI 编码代理、但对"能生成代码、质量不稳定"不满意的人 |
| 入口在哪 | skills/using-agent-skills/SKILL.md 里有张流程图，把任务类型映射到具体技能 |
可以把每个技能看成一份菜谱：代理是厨师，菜谱规定了步骤和验收标准。
30 秒安装 agent-skills：按你用的工具选路线
⚡ 三条路线，选一条：
| 你用的工具 | 安装命令 | 说明 |
|---|---|---|
| 任意工具、想读源码 | git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills | 得到完整仓库：skills/ 放技能，agents/ 放代码审查员、测试工程师等角色，docs/ 放配置文档 |
| Gemini CLI | gemini skills install https://gitcode.com/GitHub_Trending/agentskill/agent-skills.git --path skills | 一行装好 skills 目录，不用手动拷文件 |
| Claude Code | /plugin install agent-skills@addy-agent-skills | 以插件形式安装，自带斜杠命令 |
跑通第一个技能：从装完到技能生效的最短路径
- 先读入口技能：
cat skills/using-agent-skills/SKILL.md，看一遍流程图，之后新任务来就知道该选哪个技能。 - 把要用的技能内容拷进你工具的配置位置：Cursor 放进
.cursor/rules/规则文件；GitHub Copilot 放进.github/skills/<技能名>/，agents/ 里的角色放.github/agents/。 - 下任务时明确说"按 test-driven-development 流程完成这个改动"。✅
到这一步技能加载完成：代理不再自由发挥，而是按写好的流程逐步执行，流程末尾自带验证清单。
三个真实场景：agent-skills 按任务配技能
不要一次全量加载技能，上下文装太满反而互相稀释。三个场景对应三个技能：
写新代码时→ test-driven-development 场景：代理习惯先写完代码，测试要人盯着补。选：TDD 技能。得到：被流程要求先写测试、跑红，再写实现。
提交流合前→ code-review-and-quality 场景：PR 要提交了，担心 AI 写的代码埋雷。选：代码审查技能，想审得更深可再加载 agents/ 下的 code-reviewer 角色。得到：按审查维度逐项核对，不靠感觉。
啃大型需求时→ incremental-implementation 场景：需求很大，代理一口气写完往往一团糟。选：增量实现技能。得到：需求被拆成小步骤，每步验证通过再进入下一步，返工最多回退一步。
想深入的两件事：自定义技能与钩子自动触发
自定义技能：每个技能都是同一套固定结构——使用时机、核心流程、示例、红旗信号、验证清单，详见 docs/skill-anatomy.md。按这个结构写下你团队的规范，代理就能像加载官方技能一样加载它。
钩子自动触发：仓库 hooks/ 目录提供 sdd-cache-pre.sh 与 sdd-cache-post.sh，注册到工具的 PreToolUse/PostToolUse 后，会在开发任务前后自动执行。比如它把 source-driven-development 技能抓取的官方文档缓存在本地，每次复用都回源验证新鲜度，省掉重复抓取，不改变技能自身流程。
避坑：agent-skills 配置的 3 个高频问题
- 工具提示找不到技能文件。原因基本是路径配错：技能不在工具查找的目录里，或相对路径在换目录后失效。核对文件确实在你写的那个位置，并对照 docs/ 下对应工具的 setup 文档（如 docs/copilot-setup.md）。
- 技能加载了，代理却不照做。通常是上下文塞了太多技能，或只拷了文件却没告诉代理该跟哪个流程。只加载与当前任务相关的 1-2 个技能，并在指令中点名技能。
- 技能加载失败。检查文件是否完整（拷一半很常见）、工具是否支持该技能格式；拿不准时看 docs/ 里该工具的安装文档。
agent-skills 不替你写代码，它让 AI 代理按可验证的流程和标准干活，这是"能生成"与"能交付"的分界线。完整工作流与团队落地建议，见官方 docs/getting-started.md 与 docs/adoption-guide.md。
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
