addyosmani/agent-skills 完整解析
一、项目基础信息
仓库作者:Addy Osmani(Google Chrome 开发负责人,前端经典书籍作者) 仓库地址:https://github.com/addyosmani/agent-skills 定位:面向 AI 编程智能体的生产级工程技能库,MIT 开源协议

核心一句话概括
把资深工程师完整软件开发流程、质量校验标准、上线规范,封装成标准化 SKILL.md 工作流文件,让 Claude Code、Cursor、GitHub Copilot、Gemini CLI 等 AI 编码工具自动按工业级规范干活,不再只写半成品代码。
二、核心概念:什么是这里的 Skill?
和普通插件/零散 Prompt 完全不同:
-
Skill = 带校验节点的标准化工作流(SKILL.md) 不是一堆知识点,而是分步骤操作清单 + 强制校验关卡 + 明确退出标准,AI 必须走完所有验证环节才能结束任务,杜绝“随便写写交差”。 -
Persona(agents/文件夹) 专业角色系统提示词:安全审计师、代码评审、测试工程师等,给 AI 固定身份视角。 -
Slash 斜杠命令 7 条内置快捷指令,一键触发整套开发流程: /define/plan/build/test/review/code-simplify/ship
三、覆盖完整软件生命周期(6大阶段,24套技能)
全部技能覆盖场景
-
需求阶段:需求访谈、需求精炼、Spec 驱动开发 -
规划阶段:任务拆解、方案设计、API/接口设计 -
编码构建:增量开发、TDD 测试驱动、前端工程、错误处理 -
测试校验:浏览器调试、自动化测试、边界用例 -
评审优化:代码评审、复杂度精简、性能优化、安全加固 -
发布运维:Git 规范、CI/CD、数据迁移、上线验收
核心设计特色(区别普通 AI 规则库)
-
强制证据校验 每一步必须产出可验证结果(测试日志、构建输出、性能报告),不能靠 AI 口头“我觉得没问题”过关。 -
流程优先,而非纯文字参考 拒绝长篇大论最佳实践,只给可执行步骤,避免 AI 读一堆文档但不落地校验流程。 -
全工具兼容 一套技能文件,原生适配:Claude Code / Cursor / GitHub Copilot / Gemini CLI / Windsurf / OpenCode,每个工具都有配套部署教程。 -
轻量化上下文 渐进加载,只在执行对应任务时注入对应 Skill,不会一次性塞满 Token 浪费上下文窗口。
四、能解决什么痛点?
日常 AI 写代码普遍问题:
-
只实现功能,不写测试、不考虑边界 -
缺少代码评审、安全、性能检查 -
需求模糊直接上手编码,后期大量返工 -
上线前无标准化校验流程
这套仓库直接把大厂资深工程师完整开发规范固化给 AI,自动走完需求→设计→编码→测试→评审→发布全链路,产出可直接上线的工程代码。
五、简单使用方式
1. 一键安装 CLI
2. 手动部署
克隆仓库,把 skills/ 目录放到项目根目录,对应工具读取规则:
-
Cursor:放入 .cursor/rules -
Gemini CLI: gemini skills install ./agent-skills/skills/ -
Claude Code:仓库内置专用 manifest 配置文件
3. 使用示例
输入斜杠命令自动触发整套流程:
六、适用人群
-
前端/全栈开发者,日常用 AI 写业务代码 -
团队希望统一 AI 编码规范、保障代码质量 -
使用 Claude/Cursor/Gemini 等本地编码智能体的用户 -
想让 AI 遵循生产级开发流程,减少人工二次返工

