3 条路径装好 agent-skills：从选型到跑通第一个工程技能

3 条路径装好 agent-skills：从选型到跑通第一个工程技能

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills

agent-skills 是一套面向 AI 编码代理的工程技能库：24 个技能文件，让代理写代码前先过规格、先写测试、合并前跑审查。你的代理是不是常跳过测试直接交活？你用的是 Claude Code、Gemini CLI 还是 Cursor？两条都中，往下看。

选型三问：一条命令装到你手上

读完这节，你能在 30 秒内选对安装方式，不再在三种方法之间摇摆。只问三个问题：你用什么工具、想装多深、改不改源码。

你对号入座的位置	建议	理由
① 只想先试一个技能	路径 A	一行命令装单个技能，最快见效
② 想装全套，或要改技能源码	路径 B	完整仓库含 24 个技能、4 个代理角色、7 份清单
③ 用 Cursor、Copilot 等没有原生安装的工具	路径 C	技能就是 Markdown，拷进规则文件即可

克隆仓库的命令（把/path/to/agent-skills换成你的实际安装路径）：

git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills

路径 A：在代理目录里执行，装单个技能到当前项目：

npx skills add addyosmani/agent-skills --skill test-driven-development

路径 C：把选好的技能拷进你的规则文件（以 Cursor 为例）：

cp /path/to/agent-skills/skills/test-driven-development/SKILL.md .cursor/skills/test-driven-development/SKILL.md

跑通一个任务：给函数补测试并跑绿

读完这节，你会看到一条完整链路：加载技能、让代理干活、验证交付。以"给一个函数补上测试并跑通"为例。

先给代理加载 TDD 技能：

cat /path/to/agent-skills/skills/test-driven-development/SKILL.md

把输出粘进会话，或直接引用文件路径。然后只说一句：

按这个 TDD 技能处理：先写一个失败测试，再写最小实现，重构后跑全量测试。

执行时代理会按红-绿-重构循环推进：先写失败测试，再写最小代码让它通过，最后重构且测试保持绿色。验证靠证据——它必须贴出测试运行和构建输出，而不是口头声称"应该没问题"。做完你得到一份按流程产出、带测试证据的提交。

顺带交代仓库结构，后面用得上：skills/里是 24 个技能（23 个开发阶段技能 + 1 个元技能）；agents/是 4 个代理角色，如 code-reviewer；references/是 7 份共享检查清单；另有 8 个斜杠命令覆盖从/spec到/ship的完整生命周期。

三张配方：按任务取最小命令组合

读完这节，你遇到补测试、问需求、审代码三种高频任务时，都有可直接照抄的动作。

5 分钟给存量代码补测试

适合没人敢动的老函数。让代理加载agents/test-engineer.md角色，指令一句：

按 test-engineer 角色审查这次变更，给出测试策略，再写测试。

做完你能得到一份带测试策略说明的测试用例，且全部跑绿，后续改动有了回归网。

一句话需求逼成完整规格书

需求含糊时，用/spec命令配合 interview-me 技能。它一次只问一个问题，问到代理自述有约 95% 把握为止。产出是一份目标、边界、测试策略齐备的 PRD，可以直接交给拆任务环节。

合并前过一道五轴审查

涉及用户输入、认证或外部集成的改动，加载agents/security-auditor.md角色，再执行/review。做完你能拿到按严重度分级（Nit/Optional/FYI）的问题清单和整改建议，可以整段贴回 PR 评论。

排障快查：三行定位 + 行动清单

读完这节，技能不生效时你能 1 分钟定位，不再反复重启会话碰运气。

现象	原因	修复
代理完全没按技能流程走	技能文件没放在代理扫描的位置，或 frontmatter 缺 description	按所用工具的设置文档（如docs/cursor-setup.md）把文件放回正确目录
技能总被"顺手"跳过	你一次加载了太多技能，上下文被稀释	只留当前任务相关的 1-2 个技能
技能引用了references/清单却找不到文件	单技能安装只复制了skills/<name>/，没带仓库级清单	用 git clone 装全仓库，或把所需清单拷进技能目录内的references/

下一步行动清单：

• 按你的工具走一遍docs/getting-started.md的通用加载流程
• 按"最小三件套"加载：spec-driven-development、test-driven-development、code-review-and-quality
• 用上面"给函数补测试"那条链路完整跑一遍，确认你能拿到测试证据

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills