cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

技能

Addy Osmani 的工程技能

面向编码代理的一组工程技能,强调可维护的实现而不是一次性生成。

Addy Osmani 把一些他认为编码代理该具备的工程习惯收成技能,仓库说明写的是面向生产的工程技能,MIT 许可。主题围绕怎么让代理写出能留下来的代码,而不是只求一次生成通过。

用法是挑和你技术栈接近的技能,看它要求代理先检查什么,再决定要不要放进自己的技能目录。把它当成检查清单的来源,而不是整库安装。

本页是导读,不是原文。

解决什么问题

addyosmani/agent-skills 是 Addy Osmani 等人维护的一组面向编码代理的工程技能,仓库说明把它定位为可在开发各阶段复用的工作流和检查项。主题覆盖从写规格、拆任务、按测试实现,到代码评审和发布。配套站点是 skills.addy.ie。仓库用 MIT 许可发布,并未归档。

核验日期为 2026-11-16(Asia/Shanghai)。GitHub Releases 的最新正式版是 0.6.16,发布时间是 2026-11-14 04:33 UTC,换算为 2026-11-14 12:33(Asia/Shanghai)。当前 README 写明整包共 25 项技能,并提供 9 条与开发周期对应的斜杠命令(如 /spec、/plan、/build、/test、/review、/ship)。它不是「必须整库一次性装完」的产品;官方同时提供按单项技能安装的方式。

适合谁

适合已经在使用 Claude Code、Cursor、Codex 或其他支持技能的编码工具,并希望代理先把规格和验证标准说清楚,再改代码的人。若你只想临时让代理改一个小文件,不必先装整包。

仓库另有一份 比较说明,用来对照 Superpowers 等其他技能包。选择前请自己阅读,不要只根据星标或转述做决定。安装前先读你打算启用的那一项 SKILL.md,确认它要求代理先检查什么。

怎么装

命令来自 2026-11-16 查阅的仓库 README。官方把 vercel-labs/skills 这条 CLI 当作可覆盖多种代理的快捷方式。建议先浏览再决定装哪些,而不是默认装全部 25 项:

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

若你确认要装整包,官方命令是:

npx skills add addyosmani/agent-skills

Claude Code

README 把 Claude Code 标为推荐集成之一。先登记市场,再安装插件:

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

若克隆时出现 SSH 错误,官方建议改用完整 HTTPS 地址:

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

Claude Code 里如果某条内置命令重名(README 明确举了 /review),应使用带命名空间的形式,例如 /agent-skills:review。

Cursor

官方说明是把工作流技能放到项目的 .cursor/skills/(从仓库的 skills/ 同步),把简短策略放到 .cursor/rules/*.mdc,不要把整份技能正文贴进 rules。本仓库本身不带 .cursor/ 目录,细节见 docs/cursor-setup.md。

Codex CLI

README 要求 Codex CLI v0.122 或更新:

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

其他工具(Gemini CLI、OpenCode、Copilot 等)各有单独文档,请以 README 里对应链接为准。

一个实际例子

下面以官方示例里的 test-driven-development 为起点,只在一个很小的练习任务上启用单项技能。本次没有实跑,因此不编造测试输出或代理对话。

  1. 先执行 npx skills add addyosmani/agent-skills --list,确认该技能的当前名称,再按上一节安装这一项(或在 Claude Code 里用官方插件命令后,只调用与测试相关的技能)。
  2. 在一个可丢弃的练习目录里,给代理一个范围很小的任务,例如「为已有函数补一个失败测试,再写刚好让它通过的实现」。提示词示例:Use the test-driven-development skill. Add a failing unit test for the existing function that parses a date string, then write the minimum code to make it pass. Do not refactor unrelated files.
  3. 预期效果(来自技能定位,不是实测):代理应先补测试并确认失败,再改实现,而不是先改生产代码。
  4. 请自己查看 diff 和测试命令。若技能引用了仓库级 references/ 清单却找不到文件,先看下一节,不要反复重装。

常见坑

  • 一上来就执行「安装全部 25 项」。整包会同时引入规格、测试、评审等多条工作流,可能和你已有的项目约定冲突。先读 SKILL.md,先装一项。
  • 只按单项 npx skills add ... --skill 安装时,当前 README 仍写明:这种方式只复制 skills/<name>/,不会带上仓库级的 references/ 共享清单;技能还能用,但补充清单不可用。README 把这个问题指向 issue #361。该 issue 已于 2026-08-03 20:14 UTC(2026-08-04 04:14 Asia/Shanghai)关闭,关闭原因为 completed。本次没有重跑 npx 来核实缺口是否已经完全消失,因此仍按当前 README 的建议处理:改用整库集成、克隆仓库,或把需要的清单复制进已安装的技能目录。
  • 在 Claude Code 里输入 /review,结果调用的不是本包的评审技能。官方已提醒使用 /agent-skills:review。
  • 在 Windows 或 macOS 上用默认 SSH 地址登记市场,遇到 Permission denied (publickey)。先改用 README 给出的 HTTPS 写法,而不是反复重试同一条 SSH 命令。
  • 在 Cursor 里把整份 SKILL.md 粘贴进 rules。官方明确不建议这样做。

FAQ

必须一次安装全部 25 项技能吗?

不必。官方同时提供 --list 浏览和 --skill 按项安装。更稳妥的做法是先装一项与当前任务相关的技能,确认它的检查项适合你的仓库后再扩展。

Claude Code 的安装命令是什么?

2026-11-16 的 README 写的是:先 /plugin marketplace add addyosmani/agent-skills,再 /plugin install agent-skills@addy-agent-skills。若遇 SSH 问题,改用 README 中的 HTTPS 仓库地址。

为什么技能提到的共享清单找不到?

当前 README 仍说明:按单项安装时不会复制仓库级 references/。它引用的 issue #361 已经关闭。本次没有实跑验证该行为在 0.6.16 上是否变化,请以当前 README 的安装说明为准。

它和 Superpowers 有什么不同?

二者都是给编码代理用的技能包,侧重点和触发方式并不相同。请直接阅读仓库的 comparison.md,本文不把第三方评测写成结论。

许可证和当前版本是什么?

仓库为 MIT 许可,见 LICENSE。2026-11-16 查阅的最新正式版是 0.6.16(2026-11-14 12:33 Asia/Shanghai)。商用或再分发前请自行阅读许可全文。

来源与许可

仓库 addyosmani/agent-skills 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、0.6.16 发版说明、Cursor 安装文档 以及 issue #361,用自己的话写成,供 CQBase 上下文库使用。若安装命令有变,以仓库 README 为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。