agent-skills：让AI编码代理按生产流程交付代码
给AI编码代理装上从需求到发布的工程流程，不再只走最短代码路径。
GitHub addyosmani/agent-skills 更新 2026-09-04 分支 main 星标 97.0K 分叉 10.2K
AI coding agents Markdown skills skills CLI Claude Code/Codex

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你在Claude Code、Cursor或Codex中希望统一spec、test和review流程。
    README的Quick Start列出Claude Code、Cursor、Codex；核心流程图覆盖DEFINE、PLAN、BUILD、VERIFY、REVIEW、SHIP。
  • 你的团队希望一次接入25个技能，而不是逐个编写代理提示词。
    README的Quick Start写明`npx skills add addyosmani/agent-skills`可安装全部25个技能。
  • 你维护绿地项目或存量代码库，需要采用不同的技能推广路径。
    README的Adoption章节说明Adoption Guide覆盖greenfield全生命周期和established codebase的渐进式verification-first rollout。

不适合，如果你

  • 你只能单独安装技能，却依赖仓库级references目录中的共享检查清单。
    README明确说明单技能npx安装只复制`skills//`，不会复制`references/`，该问题记录在Issue #361。
  • 你的Codex CLI版本低于0.122，且不能升级到原生插件支持版本。
    README的Codex章节要求Codex CLI v0.122+。
  • 你的代理不接受system prompts或instruction files。
    README的Other Agents章节仅说明Skills适用于接受system prompts或instruction files的代理。

前置条件

  • 可运行open skills CLI的npx环境；README Quick Start使用`npx skills add`。
  • 目标代理需在README列出的集成范围内，例如Claude Code、Cursor、Codex、Copilot或Cline。
  • 使用Codex原生插件时需要Codex CLI v0.122+。
  • 使用Claude Code Marketplace时需要GitHub SSH密钥，或按README使用HTTPS URL。
  • Claude Code本地开发需要先执行`git clone https://github.com/addyosmani/agent-skills.git`。

第一步命令（README 原文）

npx skills add addyosmani/agent-skills

要注意

  • 用`--skill`安装单个技能时，仓库级references不会随之复制。
    README Quick Start的Installing one skill说明；相关可移植性问题追踪于Issue #361。
  • Claude Code Marketplace默认走SSH，Windows或macOS可能出现`Permission denied (publickey)`。
    README的Claude Code章节给出了SSH错误和`git config --global url."https://github.com/".insteadOf [email protected]:`解决方式。
  • Antigravity CLI的受影响版本可能无法发现由旧命令TOML转换出的wrapper commands。
    README的Antigravity CLI章节要求直接调用namespaced skills，并链接`docs/antigravity-setup.md`。

替代方案

  • 项目级AGENTS.md与代理规则：只需要少量项目规则，或希望继续使用OpenCode的`AGENTS.md`而不引入25个技能时更合适。
    README的OpenCode章节
  • 直接维护system prompts或instruction files：目标代理支持system prompts或instruction files，但不在README列出的原生集成范围内时更合适。
    README的Other Agents章节

材料未说明

  • README材料未说明各技能的具体文件数量、输入格式和输出格式。
  • README材料未提供测试套件、CI状态或25个技能的自动化验证结果。
  • 项目数据中的主要语言分布为空，无法确认实现语言或脚本运行时。
  • 项目数据称贡献者为0、版本为0且最近提交为0，但README列出Addy Osmani、Federico Bartoli和Joan León三位维护者；数据口径差异未解释。
  • README材料未说明不同代理版本之间的兼容性矩阵。
  • README材料未量化技能对代码质量、测试覆盖率或交付速度的实际提升。
  • README材料未说明最近更新日期，无法判断当前维护新鲜度。

💡 深度解析

6
适合 我们在没有 GitHub SSH 密钥的 macOS 和 Windows 机器上使用 Claude Code，能否通过 Marketplace 安装 agent-skills，还是必须改用本地克隆？
适合读者： 使用 Claude Code 的团队，面对没有 SSH GitHub 密钥的 macOS 或 Windows 开发环境，想通过 Marketplace 安装 agent-skills

适合通过 Marketplace 安装，但没有 SSH 密钥时应使用 README 给出的 HTTPS 地址或 Git URL 重写方案，不必改成本地克隆。

  • README 将 Claude Code Marketplace 标为推荐集成方式，但明确提醒 Marketplace 会通过 SSH 克隆仓库。
  • README 给出了完整 HTTPS marketplace 命令：/plugin marketplace add https://github.com/addyosmani/agent-skills.git，之后仍使用 /plugin install agent-skills@addy-agent-skills。
  • 如果 Windows 或 macOS 仍出现 Permission denied (publickey)，README 建议配置 git config --global ... insteadOf ...，让子进程克隆改走 HTTPS。
  • 本地开发方式也存在，但它是替代路径，并非无 SSH 环境的唯一选择。
  • Claude Code (recommended)：Marketplace clones repos via SSH
  • Quick Start：`/plugin marketplace add https://github.com/addyosmani/agent-skills.git`
  • Quick Start：`git config --global url."https://github.com/".insteadOf [email protected]:`
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
材料未说明：README 未说明 Claude Code Marketplace 安装是否需要特定 Claude Code 版本。；README 未说明组织代理、防火墙或企业 Git 配置对 HTTPS 子进程克隆的影响。
视情况 我们在 Cursor 中维护既有代码库，要求 AI 代理先完成测试，再进行合并前五维代码评审；这个项目能否直接提供这些质量门禁？
适合读者： 负责既有代码库变更风险的维护团队，使用 Cursor，并要求代理在合并前完成测试和五维代码评审

视情况：项目能提供流程指令和评审清单入口，但不能独立证明测试通过或替代 CI、静态分析与安全扫描。

  • README 提供 test-driven-development 和 code-review-and-quality 两个明确技能，分别对应测试驱动开发与合并前五维评审。
  • Cursor 的集成方式是把工作流技能放在 .cursor/skills/，把简短策略放在 .cursor/rules/*.mdc，而不是把完整 Skill 粘进规则文件。
  • 项目说明 Skills 通过步骤和质量门禁约束代理，但项目洞察明确指出它不是独立测试平台、CI 系统或安全扫描器。

因此它适合统一“代理必须做什么”的过程，不足以单独满足“机器已经验证什么”的审计要求。最终门禁仍取决于仓库已有测试命令、CI 结果和扫描工具。

  • Quick Start：`code-review-and-quality` 为 `five-axis review before merge`
  • Quick Start：Cursor 使用 `.cursor/skills/` 与 `.cursor/rules/*.mdc`，不要把完整 Skills 粘入 rules
  • 项目洞察 usage_limitations：不是独立的测试平台、静态分析器、CI 系统、部署系统或安全扫描器
npx skills add addyosmani/agent-skills --skill code-review-and-quality   # five-axis review before merge
材料未说明：README 未列出 Cursor 集成后每个 Skill 的自动发现和触发优先级。；README 未说明项目是否提供可直接接入 CI 的机器可读评审结果格式。；README 未说明维护团队现有测试、静态分析和安全扫描工具的兼容范围。
适合 我在 Claude Code 中维护一个既有代码库，只想先启用 code-review-and-quality 和 test-driven-development，避免一次安装全部 25 个技能；这个项目适合我的渐进式流程吗？
适合读者： 使用 Claude Code 维护既有代码库、希望先从代码评审和测试驱动开发开始，而不想一次启用全部 25 个技能的个人开发者

适合，因为 README 明确支持按单个 Skill 安装，并且这两个技能分别覆盖合并前的五维评审与 red-green-refactor 流程。

  • 可直接安装 code-review-and-quality，README 将其定义为 “five-axis review before merge”。
  • test-driven-development 被描述为 “red-green-refactor, enforced”，适合作为既有代码库的验证入口。
  • Claude Code 同时提供 Marketplace 和本地插件集成，便于在当前仓库逐步引入。

但单独安装有边界：README 说明只复制 skills//，不会复制仓库级 references/，相关共享检查清单路径可能不可用。因此选择单技能时，必须确认该技能引用的清单是否需要一并复制。

  • Quick Start：`npx skills add addyosmani/agent-skills --skill code-review-and-quality # five-axis review before merge`
  • Quick Start：`npx skills add addyosmani/agent-skills --skill test-driven-development # red-green-refactor, enforced`
  • Quick Start：单技能安装只复制 `skills//`，不复制仓库级 `references/`
npx skills add addyosmani/agent-skills --skill test-driven-development   # red-green-refactor, enforced
材料未说明：README 未说明这两个单独安装的 Skill 是否分别依赖哪些具体 references 清单。；README 未说明 Claude Code 中单独安装 Skill 后的自动触发优先级。
视情况 我们想在团队内统一 Claude Code、Cursor 和 Copilot 的 AI 开发流程，但代码库已有自己的架构历史、测试命令和发布政策；可以直接照搬这些 Skills 吗？
适合读者： 希望在团队内统一 AI 辅助开发流程、同时需要保留项目自身架构文档、测试命令和发布政策的软件工程团队

视情况：项目适合作为通用流程层，但不适合未经定制就取代团队已有的架构、测试和发布规则。

  • README 说明 Skills 是偏流程化、带明确步骤和工程判断的 Markdown；它们可跨 Claude Code、Cursor、Copilot 等宿主分发。
  • 项目洞察明确指出，通用技能不会自动了解业务约束、架构历史、合规要求和组织发布政策，直接照搬可能生成不适合项目的检查步骤。
  • 项目洞察还要求为仓库补充架构说明、开发命令、测试命令、验收标准、数据安全要求和发布流程。
  • 团队可以把项目作为共同底座，再通过平台规则文件和仓库上下文补充本地约束，而不是维护三套完全独立的工作流。
  • README Why Agent Skills：Skills encode “when to write a spec, what to test, how to review, and when to ship”
  • 项目洞察 common_pitfalls：通用技能不会自动了解业务约束、架构历史、合规要求和组织发布政策
  • 项目洞察 best_practices：为仓库补充架构说明、开发命令、测试命令、验收标准、数据安全要求和发布流程
npx skills add addyosmani/agent-skills --list     # browse before installing
材料未说明：README 未说明如何把团队规则优先级与 Skills 中的通用规则冲突解决。；README 未提供针对特定合规框架或企业发布政策的现成适配模板。；项目数据表明 release_count 为 0，但 README 未说明推荐的组织内版本锁定机制。
适合 我负责一个绿地项目，准备在 Codex CLI v0.122+ 中让代理从需求澄清、规格设计、计划拆解一直走到测试、评审和发布；应该采用完整技能包吗？
适合读者： 负责绿地项目架构和交付流程的技术负责人，计划让 Codex CLI v0.122+ 从需求规格一直执行到发布

适合，尤其适合需要从零建立完整交付流程的绿地项目；README 描述的技能集合覆盖了从定义到发布的连续生命周期。

  • 项目洞察将流程组织为 DEFINE、PLAN、BUILD、VERIFY、REVIEW、SHIP 六阶段，正好对应你的端到端约束。
  • README 的 Quick Start 提供一次安装全部 25 个技能的命令，适合需要多个阶段协同的项目。
  • Codex CLI v0.122+ 支持原生插件，安装后可通过 @ 调用，例如 @spec-driven-development。
  • 项目价值在于把需求澄清、规格、测试、评审和发布实践写成代理可执行的步骤，而不是只生成代码。

不过完整采用会增加流程记忆和选择负担；项目洞察指出，习惯直接修改代码的个人开发者可能感到交互变长。绿地项目应先确认团队愿意接受这些阶段性入口。

  • 项目洞察 solution_analysis：生命周期按 `DEFINE、PLAN、BUILD、VERIFY、REVIEW、SHIP` 组织
  • Quick Start：`npx skills add addyosmani/agent-skills # install all 25 skills`
  • Codex：`Codex CLI v0.122+`，使用 `@spec-driven-development` 调用技能
npx skills add addyosmani/agent-skills            # install all 25 skills
材料未说明：README 未说明完整技能包在 Codex 中的默认触发顺序。；README 未说明 SHIP 阶段如何对接具体部署平台、审批流或生产权限。；README 未给出完整技能包对上下文长度和代理执行时间的量化影响。
适合 我们同时使用 Codex CLI v0.122+、GitHub Copilot 和 Gemini CLI，能否用同一套 agent-skills 规范需求、编码和代码评审，而不为每个平台维护三套提示词？
适合读者： 同时使用 Codex CLI v0.122+、GitHub Copilot 和 Gemini CLI 的软件工程团队，想统一 AI 代理的需求、实现和评审入口

适合，但需要为三个宿主分别配置加载方式；项目的核心工作流可复用，平台接入并不是完全相同的安装动作。

  • README 将 Skills 定义为 plain Markdown，并说明它们可用于接受 system prompts 或 instruction files 的其他代理。
  • Codex CLI v0.122+ 可通过原生插件读取根目录 skills/，并用 @ 调用技能。
  • Gemini CLI 支持原生 Skills 安装或写入 GEMINI.md；Copilot 则使用 agents/ 和 .github/copilot-instructions.md。
  • 因而可以共享同一仓库内容，但必须把平台适配层纳入团队配置，否则“同一套规范”不会自动在三处生效。
  • Quick Start：`Skills are plain Markdown - they work with any agent that accepts system prompts or instruction files.`
  • Codex：`Codex CLI v0.122+`，读取根目录 `skills/` 并使用 `@` 调用
  • Gemini CLI：原生 Skills 或 `GEMINI.md`；GitHub Copilot：`agents/` 与 `.github/copilot-instructions.md`
codex plugin marketplace add addyosmani/agent-skills
材料未说明：README 未定义三个平台之间完全等价的触发规则或上下文优先级。；README 未说明团队如何把平台配置纳入统一版本发布和变更审批。

✨ 核心亮点

  • 25个技能覆盖DEFINE到SHIP完整生命周期
  • skills CLI支持Claude Code等70+代理
  • 工作流内置验证门与反合理化表
  • MIT许可，GitHub获92,155颗星

🔧 工程化

  • 用25个Markdown技能规范定义、计划、编码、测试、审查和发布
  • npx skills add可一次安装全部技能或指定code-review-and-quality
  • 原生集成覆盖Claude Code、Gemini CLI、Codex和Command Code

⚠️ 风险

  • 单独安装技能不会复制references目录，补充检查清单路径不可用
  • Claude Code Marketplace通过SSH克隆，缺少GitHub密钥会触发SSH错误
  • README未提供语言分布、版本发布或近期提交数据

👥 适合谁？

  • 使用Claude Code、Cursor或Codex的AI辅助开发团队
  • 需要把spec、test和review流程固化进代理的工程团队
  • 采用绿地全生命周期或存量项目渐进式落地的代码库