agent-skills 是什么?

agent-skills(作者 Addy Osmani)是一套面向 AI 编码智能体的「生产级工程技能」。它把资深工程师在构建软件时用的工作流、质量门和最佳实践编码成技能,打包后让 AI 智能体在开发各阶段都能一致地遵循。核心是 7 个映射开发生命周期的斜杠命令(/spec、/plan、/build、/test、/review、/code-simplify、/ship),并能根据你在做的事自动激活相应技能(如设计 API 触发 api-and-interface-design、做 UI 触发 frontend-ui-engineering)。许可为 MIT,约 45,197 stars,支持 Claude Code、Cursor、Gemini CLI、Windsurf 等。

⭐ 46,296 Stars 🍴 5,140 Forks Shell MIT 作者: addyosmani
来源:README.md(标题、首段、Commands 表、Quick Start);GitHub 仓库元数据(stars=45197、license=MIT) 查看 GitHub 仓库 →

为什么值得关注

把「资深工程师的工程纪律」固化给 AI 智能体、让它在 spec→plan→build→test→review→ship 各阶段一致遵循最佳实践,是很受欢迎的方向;加上作者 Addy Osmani 在前端/工程领域的影响力,使其获得很高关注。它强调质量门与渐进式构建(小而原子的任务、一次一片、测试即证明、合并前评审),并跨多种 AI 编码工具,实用且权威。截至数据采集约 45,197 stars。

来源:README.md(首段、Commands 表的 Key principle);GitHub 仓库元数据(stars=45197)

核心功能

覆盖开发生命周期的 7 命令

/spec、/plan、/build、/test、/review、/code-simplify、/ship,分别对应定义→规划→构建→验证→评审→简化→上线,各自带明确的工程原则。

来源:README.md(Commands 表)
技能按场景自动激活

无需手动指定——设计 API 触发 api-and-interface-design、做 UI 触发 frontend-ui-engineering 等,根据当前工作自动套用相应技能。

来源:README.md(自动激活段落)
编码资深工程纪律

把工作流、质量门和最佳实践(先规格、小原子任务、一次一片、测试即证明、合并前评审、清晰优先)固化给智能体一致执行。

来源:README.md(首段、Commands 表的 Key principle)
跨多工具支持

支持 Claude Code(插件 marketplace/本地)、Cursor(.cursor/rules)、Gemini CLI(gemini skills install)、Windsurf(规则配置)等。

来源:README.md(Quick Start 各工具)

技术架构

它是一组 Agent Skills(skills/ 下的 SKILL.md),并配 7 个映射开发生命周期的斜杠命令——每个命令自动激活对应技能:/spec(写代码前先定规格)、/plan(拆成小而原子的任务)、/build(一次一片增量构建)、/test(测试即证明)、/review(合并前改善代码健康)、/code-simplify(清晰胜过聪明)、/ship(更快即更安全)。技能也会按当前工作自动激活(API 设计、前端 UI 工程等)。分发上可作为 Claude Code 插件(marketplace 或本地 --plugin-dir),也可把 SKILL.md 复制到 Cursor 的 .cursor/rules、用 gemini skills install 装到 Gemini CLI、或加入 Windsurf 规则。

来源:README.md(Commands 表、自动激活说明、Quick Start 各工具)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code / Cursor / Gemini CLI / Windsurf 等宿主Claude Code /… 覆盖开发生命周期的 7 命令覆盖开发生命周期的 7… 技能按场景自动激活 编码资深工程纪律 跨多工具支持 agent-skills 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown(SKILL.md)+ Shell(脚本)框架Agent Skills + 斜杠命令;可作为 Claude Code 插件
Claude Code / Cursor / Gemini CLI / …
Claude Code 插件 marketplace、gemini skills install、或手动复制 SKILL.md
来源:README.md(Quick Start、Commands);GitHub 仓库元数据(language=Shell)

快速上手

Claude Code(推荐):/plugin marketplace add addyosmani/agent-skills 再 /plugin install agent-skills@addy-agent-skills(marketplace 用 SSH 克隆,无 SSH key 可改用 https://github.com/addyosmani/agent-skills.git);本地开发用 git clone 后 claude --plugin-dir /path/to/agent-skills。Cursor:把 SKILL.md 复制到 .cursor/rules/ 或引用 skills/ 目录。Gemini CLI:gemini skills install https://github.com/addyosmani/agent-skills.git --path skills。Windsurf:把技能内容加入规则配置。安装后用 /spec /plan /build /test /review /code-simplify /ship 走开发生命周期,技能也会按场景自动激活。
来源:README.md(Quick Start 各工具、Commands)

使用场景

适合想让 AI 编码智能体「按资深工程师的纪律办事」的开发者与团队:在写代码前先用 /spec 定清楚、用 /plan 拆原子任务、/build 增量构建、/test 用测试证明、/review 在合并前改善代码健康、/code-simplify 简化、/ship 安全上线;并在 API 设计、前端工程等具体场景自动套用对应技能。它把工程最佳实践标准化,适合提升 AI 产出的一致性与质量,跨多种编码工具使用。产出仍需工程师把关。

来源:README.md(Commands、自动激活、首段)

优势与局限

优势

  • 把资深工程纪律固化为覆盖全生命周期的技能与命令,质量导向
  • 技能按场景自动激活,无需手动指定
  • 跨 Claude Code/Cursor/Gemini CLI/Windsurf 多工具,安装方式齐全
  • 作者权威、口碑好,MIT 开源

局限

  • 本质是工作流/最佳实践模板,效果取决于模型与使用者是否照做
  • 需要兼容的 AI 编码宿主,部分工具需手动配置
  • 强调流程纪律,对极小一次性任务可能偏重
  • 产出仍需人工审核,技能不替代工程判断
来源:README.md(Commands、Quick Start、首段)

最新版本

本页未列出具体版本号;项目以 Agent Skills + 斜杠命令集合持续维护,通过 Claude Code 插件 marketplace 与多工具安装方式分发。更新以完善覆盖开发生命周期的技能、命令与跨工具支持为主。

来源:README.md(Quick Start、Commands)

总结评价

agent-skills 把「资深工程师怎么做软件」的纪律——先规格、小原子任务、一次一片、测试即证明、合并前评审、清晰优先、安全上线——固化成覆盖开发全生命周期的 7 个命令与一组自动激活的技能,让 AI 编码智能体一致地遵循最佳实践,且跨多种工具、作者权威。对想提升 AI 产出一致性与质量的开发者和团队很实用。边界也清楚:它是工作流模板、需兼容宿主、对极小任务偏重、产出仍需人工把关。作为给 AI 编码注入工程纪律的技能集,它定位清晰、质量导向、可信度高。

来源:综合 README.md 的命令体系、工程原则与跨工具支持
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 13:30. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件