agent-skills(工程技能集)

作者 设施特

AI 写代码快,但常跳过写规格、跳过测试,直接产出能跑却不敢上线的代码。这是 Addy Osmani 开源的生产级工程技能集,把定义、规划、构建、验证、评审、上线六阶段固化成 9 个斜杠命令、共 25 个技能,一条 npx 装进 70 多个 Agent。

Github
Skill 编程开发 v1.0.0 热度 350

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-53(agent-skills(工程技能集))。
详情页:https://www.cweto.cn/work-53.html
GitHub:https://github.com/addyosmani/agent-skills
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

agent-skills 是什么

agent-skills 是一套面向 AI 编码 Agent 的「生产级工程技能」,由 Addy Osmani 开源。它把资深工程师实际在用的工作流、质量关卡和最佳实践打包成技能,让 Agent 在开发的每个阶段都按同一套规矩走,而不是每次自由发挥。

整个体系是一条六阶段流水线:定义 → 规划 → 构建 → 验证 → 评审 → 上线。每个阶段对应一个斜杠命令,命令会自动激活该阶段该用的技能。除了手动敲命令,技能也会按你正在做的事自动触发——设计 API 会拉起 api-and-interface-design,写界面会拉起 frontend-ui-engineering。

命令你在做什么关键原则
/spec定义要建什么规格先于代码
/plan规划怎么建小而原子化的任务
/build增量构建一次只做一片
/test证明它确实能用测试就是证据
/constraints设定质量线决策一次,处处执行
/review合并前评审提升代码健康度
/webperf审计网页性能先测量再优化
/code-simplify简化代码清晰优先于聪明
/ship发布到生产更快才更安全

还提供一个 /build auto:规格写完后一次性批准计划,它会自动生成计划并逐个实现所有任务。它省掉的是人在任务之间来回切换,不是验证——每个任务仍然是测试驱动、单独提交,遇到失败或高风险步骤会停下来。

agent-skills 怎么安装

最快的方式是用开源的 skills CLI,它支持 70 多个 Agent(Claude Code、Cursor、Codex、Copilot、Cline 等):

npx skills add addyosmani/agent-skills          # 装全部 25 个技能
npx skills add addyosmani/agent-skills --list   # 先浏览有哪些
npx skills add addyosmani/agent-skills --skill code-review-and-quality

Claude Code 可以走插件市场:

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

如果走市场时遇到 SSH 报错(git@github.com: Permission denied (publickey)),可以改用完整 HTTPS 地址添加,或一次性把 GitHub 的 SSH 地址重写成 HTTPS:

git config --global url."https://github.com/".insteadOf git@github.com:

注意一个已知限制:如果只单装某一个技能(--skill <name>),CLI 只复制 skills/<name>/,不会带仓库级的 references/ 目录。技能本身还能跑,但里面指向共享检查清单的路径会失效,需要整仓安装、克隆仓库,或手动把清单复制进去。

agent-skills 怎么使用

  1. 装好后照常写代码,需要哪个阶段就敲对应命令,比如先 /spec 把需求写成规格,再 /plan 拆成任务。
  2. 在 Claude Code 里,如果内置命令同名(例如 /review),用带命名空间的形式调用:/agent-skills:review。
  3. 规格写完后想少点人工步骤,用 /build auto 一次批准跑完;它会逐任务测试驱动并单独提交,失败或高风险处暂停等你。
  4. 质量线用 /constraints 定一次,之后所有改动都按这条线检查,不用每次重复交代。
  5. 很多技能会自动激活,不必刻意调用——你只要专心动手上做的事。

agent-skills 适合谁用

  • 日常用 Claude Code、Cursor、Codex、Copilot 写项目的开发者,想让 Agent 的输出稳定在可评审、可上线的水准。
  • 团队想在多人多 Agent 协作下统一质量线和评审标准。
  • 厌倦了每次新开会话都要重新教一遍工程规范的人。
  • 需要「先出规格再动手」这种纪律约束的复杂项目。
  • 只想让 AI 补几行代码片段、不需要完整工程流程的场景,用不上这套东西。

agent-skills 项目地址

  • GitHub 仓库:https://github.com/addyosmani/agent-skills
  • 技能介绍页:https://skills.addy.ie
  • skills CLI:https://github.com/vercel-labs/skills
  • Cursor 配置说明:https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md
  • 已知问题(单技能安装):https://github.com/addyosmani/agent-skills/issues/361