agent-skills 使用教程:24 个技能给 AI 编码助手补上工程流程
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
AI 写完一个功能,你不催它就不补测试;快到上线,安全审查也常被一句"变更很小"带过去。agent-skills 针对的就是这类漏洞:它把 24 个工程流程打包成 Markdown 技能,加载后每个环节都有固定步骤和验收标准,可以减少漏测、漏审的概率。
把工程纪律写成可执行流程
agent-skills 收录 24 个技能,覆盖从需求到上线的完整开发阶段。每个技能是一份带步骤、检查点和退出标准的流程文件,不是供人翻阅的参考文档。AI 要拿出证据才算完成——测试通过、构建成功、运行时数据正常。技能里还内置"反借口"表格:AI 若打算用"测试稍后再补"跳步,会直接撞上写好的反驳论据。
最小配置:给 agent-skills 加载第一个技能
第一步,把仓库拿到本地:
git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills第二步,确认核心目录:skills/(24 个技能,每个目录一份 SKILL.md)、agents/(4 个专家角色)、references/(配套清单);hooks/里还有 SDD-CACHE 等会话脚本,可自动缓存与恢复状态。
第三步,加载第一个技能:把某个技能的 SKILL.md 内容放进你工具的规则文件——Claude Code 可走插件市场安装,其他支持 Markdown 指令的工具直接粘进系统提示或会话即可。例如 Cursor 用户:
cp agent-skills/skills/test-driven-development/SKILL.md .cursor/rules/跟一个注册功能走完七步
以"给项目新增用户注册功能"为例,走一遍推荐顺序:
- 需求澄清:启用
interview-me,它一次只问一个问题,把模糊需求拆成可确认的答案,问到约 95% 置信度才停。 - 写规格:
spec-driven-development先生成 PRD(产品需求文档),覆盖目标、命令、目录结构、代码风格、测试策略与边界,存成SPEC.md确认后才动代码。 - 拆任务:
planning-and-task-breakdown把规格拆成小任务,每个任务带验收标准和依赖顺序。 - 增量实现:
incremental-implementation一次只做一个垂直切片(只把一个端到端小功能做完),每片走"实现 → 测试 → 验证 → 提交"。⚡️ 想少管一点,可用/build auto:批准一次计划后自主跑完,遇失败暂停。 - 测试:
test-driven-development强制红-绿-重构循环,并按测试金字塔分配比例(约 80% 单元 / 15% 集成 / 5% 端到端)。 - 审查🔍:
code-review-and-quality按五个维度过一遍变更;涉及认证、用户输入时挂security-and-hardening对照 OWASP Top 10,专项审查还可加载agents/里的 code-reviewer、test-engineer、security-auditor、web-performance-auditor 角色。 - 上线:
shipping-and-launch给出上线前检查清单、feature flag(功能开关)生命周期和回滚程序。
按任务选技能:速查表
agent-skills 的技能不必全装,按下表随取随用:
| 任务类型 | 推荐技能 / 命令 | 一句话作用 |
|---|---|---|
| 还没想清楚要什么 | interview-me | 一次一问,问到约 95% 置信度 |
| 只有模糊想法 | idea-refine | 先发散后收敛,产出具体方案 |
| 启动新功能 | spec-driven-development(/spec) | 先写 SPEC.md,再写代码 |
| 已有规格要拆分 | planning-and-task-breakdown(/plan) | 拆出带验收标准的小任务 |
| 开始编码 | incremental-implementation(/build) | 一次一个切片,实现-测试-验证-提交 |
| 证明功能可用 | test-driven-development(/test) | 红-绿-重构,测试即证据 |
| 合并前审查 | code-review-and-quality(/review) | 五维度审查,控制变更大小 |
| 安全或性能疑虑 | security-and-hardening / performance-optimization | 对照 OWASP Top 10 / 先测量再优化 |
| 部署到生产 | shipping-and-launch(/ship) | 上线前清单加回滚程序 |
| 不知道该选哪个 | using-agent-skills | 元技能,按任务类型路由到对应技能 |
容易踩的坑
- 注意:技能没生效时先确认文件完整加载——Cursor 要检查
.cursor/rules/目录存在,Claude Code 要确认插件安装成功。 - 注意:AI 仍跳步时,在指令开头加一句"请严格按技能步骤执行",通常能压住"变更太小不用审查"式借口。
- 建议:别一次性加载全部 24 个技能,会吃掉上下文;做 UI 装
frontend-ui-engineering,调试装debugging-and-error-recovery,按需取用。 - 建议:从元技能
using-agent-skills入手,它内置任务到技能的路由表,能减少选错技能的概率。
挑一个你最在意的环节——测试、安全或代码审查——把对应技能加载进当前工具,拿一个真实小任务试跑一次。对比加载前后的产出,就能判断这套 AI 编程工作流值不值得在你的项目里铺开。
资源链接
- 官方文档:docs/getting-started.md
- 技能目录:skills/
- 命令示例:commands/
- 角色定义:agents/
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考