@sharbel: 有人构建了一个免费的、生产级工程技能合集，教会你的 AI 编码代理如何像高级工程师一样精确工作……

有人构建了一个免费的生产级工程技能合集，能让你的 AI 编码智能体像资深工程师一样工作。它叫 agent-skills。GitHub 上 60,800+ 星。你可以把它放入 Claude Code、Codex、Cursor 或 Gemini CLI。功能如下：→ /spec 强制智能体在接触代码之前先定义要构建什么。先写规格，后写代码。每次都这样。→ /plan 将规格拆分为细小的原子任务。没有巨大的 PR。没有神秘的 diff。→ /build 一次实现一个片段。每个任务都遵循测试驱动并单独提交。→ /build auto 生成计划并在一次批准通过后执行所有任务。你只需批准一次，它会自主执行。遇到失败或风险步骤时暂停。→ /test 证明代码有效。测试被视为证明，而非事后补丁。→ /review 在合并前强制执行代码健康度。真正的质量门，而非感觉检查。→ /code-simplify 为了清晰而非炫技重写代码。干掉智能体凌晨 2 点写出来的花哨废话。→ /ship 执行完整的生产检查清单。只有在没有跳过任何步骤时，“更快”才意味着“更安全”。→ 技能会根据上下文自动激活。构建 API 触发 api-and-interface-design。构建 UI 触发 frontend-ui-engineering。无需手动配置。100% 开源。GitHub 仓库链接：https://github.com/addyosmani/agent-skills… — # addyosmani/agent-skills 来源：https://github.com/addyosmani/agent-skills # Agent Skills 面向 AI 编码智能体的生产级工程技能。 技能封装了资深工程师在构建软件时使用的工作流、质量门和最佳实践。这些技能被打包，使 AI 智能体在开发的每个阶段都一致地遵循。 Addy 的 Agent Skills 定义 规划 构建 验证 审查 发布 ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ 创意 │ ───▶ │ 规格 │ ───▶ │ 代码 │ ───▶ │ 测试 │ ───▶ │ 质量│ ───▶ │ 投产│ │迭代│ │ PRD │ │ 实现 │ │ 调试│ │ 门禁│ │ 线上│ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship — ## 命令 7 个斜杠命令映射到开发生命周期。每个命令会自动激活正确的技能。 | 你在做什么 | 命令 | 关键原则 | |—————––|———|—————| | 定义要构建什么 | /spec | 先写规格，后写代码 | | 规划如何构建 | /plan | 细小的原子任务 | | 增量构建 | /build | 一次一个片段 | | 证明它能工作 | /test | 测试就是证明 | | 合并前审查 | /review | 改善代码健康度 | | 简化代码 | /code-simplify | 清晰优于炫技 | | 发布到生产 | /ship | 更快更安全 | 在规格确定后想要更少的手动步骤？/build auto 生成计划并在一次批准通过后实现每个任务——你只需批准计划一次，然后它自主运行。它去掉了人类在任务之间的介入，而不是去掉验证：每个任务仍然测试驱动并单独提交，遇到失败或风险步骤时暂停。技能还会根据你正在做的事情自动激活——设计 API 触发 api-and-interface-design，构建 UI 触发 frontend-ui-engineering，等等。 — ## 快速开始 Claude Code（推荐） Marketplace 安装： /plugin marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills > SSH 错误？ Marketplace 通过 SSH 克隆仓库。如果你没有在 GitHub 上设置 SSH 密钥，要么添加你的 SSH 密钥（https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account），要么使用完整的 HTTPS URL 强制 HTTPS 克隆： > bash > /plugin marketplace add https://github.com/addyosmani/agent-skills.git > /plugin install agent-skills@addy-agent-skills > 本地/开发： bash git clone https://github.com/addyosmani/agent-skills.git claude --plugin-dir /path/to/agent-skills Cursor 将任意 SKILL.md 复制到 .cursor/rules/，或引用完整的 skills/ 目录。参见 docs/cursor-setup.md。 Antigravity CLI 作为原生插件安装，支持技能、子智能体和斜杠命令。参见 docs/antigravity-setup.md。 从仓库安装： bash agy plugin install https://github.com/addyosmani/agent-skills.git 从本地克隆安装： bash git clone https://github.com/addyosmani/agent-skills.git agy plugin install ./agent-skills Gemini CLI 安装为原生技能以支持自动发现，或添加到 GEMINI.md 以获得持久上下文。参见 docs/gemini-cli-setup.md。 从仓库安装： bash gemini skills install https://github.com/addyosmani/agent-skills.git --path skills 从本地克隆安装： bash gemini skills install ./agent-skills/skills/ Windsurf 将技能内容添加到你的 Windsurf 规则配置中。参见 docs/windsurf-setup.md。 OpenCode 通过 AGENTS.md 和 skill 工具使用智能体驱动的技能执行。参见 docs/opencode-setup.md。 GitHub Copilot 使用 agents/ 中的智能体定义作为 Copilot 人格，技能内容放在 .github/copilot-instructions.md。参见 docs/copilot-setup.md。 Kiro IDE & CLI Kiro 的技能位于 “.kiro/skills/” 下，可以存储在项目级或全局级。Kiro 也支持 Agents.md。参见 Kiro 文档：https://kiro.dev/docs/skills/ Codex / 其他智能体 技能是纯 Markdown——它们适用于任何接受系统提示或指令文件的智能体。参见 docs/getting-started.md。 — ## 全部 24 项技能 上面的命令是入口点。此包包含 24 项技能——23 项生命周期技能加上 1 项元技能 using-agent-skills。每项技能都是一个结构化工作流，包含步骤、验证门和反合理化表格。你也可以直接引用任何技能。 ### 元 - 发现适用的技能 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | using-agent-skills | 将传入工作映射到正确的技能工作流，并定义共享操作规则 | 开始一个会话或决定哪项技能适用 | ### 定义 - 澄清要构建什么 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | interview-me | 一次一问的访谈，提取用户真正想要的，而不是他们认为自己应该想要的，直到约 95% 的置信度 | 需求不明确，或用户调用 “interview me” / “grill me” | | idea-refine | 结构化的发散/收敛思维，将模糊的想法转变为具体的提议 | 你有一个粗略的概念需要探索 | | spec-driven-development | 在编写任何代码之前，编写覆盖目标、命令、结构、代码风格、测试和边界的 PRD | 开始新项目、功能或重大变更 | ### 规划 - 分解 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | planning-and-task-breakdown | 将规格分解为小的、可验证的任务，包含验收标准和依赖顺序 | 你有了规格，需要可实现的单元 | ### 构建 - 编写代码 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | incremental-implementation | 瘦垂直切片——实现、测试、验证、提交。特性标志、安全默认值、易于回滚的变更 | 任何涉及多个文件的变更 | | test-driven-development | 红-绿-重构、测试金字塔（80/15/5）、测试规模、DAMP 优于 DRY、Beyonce 规则、浏览器测试 | 实现逻辑、修复错误或改变行为 | | context-engineering | 在正确的时间向智能体提供正确的信息——规则文件、上下文打包、MCP 集成 | 开始会话、切换任务或输出质量下降时 | | source-driven-development | 将每个框架决策建立在官方文档之上——验证、引用来源、标记未经验证的内容 | 你想为任何框架或库编写权威且引用来源的代码 | | doubt-driven-development | 对每个进行中的非平凡决策进行对抗性的新上下文审查——CLAIM → EXTRACT → DOUBT → RECONCILE → STOP，可选的在用户授权下跨模型升级 | 风险很高（生产、安全、不可逆），在陌生的代码库中工作，或者一个自信的输出现在验证比以后调试更便宜 | | frontend-ui-engineering | 组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍 | 构建或修改面向用户的界面 | | api-and-interface-design | 契约优先设计、Hyrum’s Law、One-Version Rule、错误语义、边界验证 | 设计 API、模块边界或公共接口 | ### 验证 - 证明它能工作 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | browser-testing-with-devtools | Chrome DevTools MCP 用于实时运行时数据——DOM 检查、控制台日志、网络追踪、性能分析 | 构建或调试任何在浏览器中运行的内容 | | debugging-and-error-recovery | 五步分类：复现、定位、缩减、修复、防护。停线规则、安全回退 | 测试失败、构建中断或行为异常 | ### 审查 - 合并前的质量门 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | code-review-and-quality | 五轴审查、变更规模（约 100 行）、严重性标签（Nit/Optional/FYI）、审查速度规范、拆分策略 | 合并任何变更之前 | | code-simplification | Chesterton’s Fence、500 规则、在保持精确行为的同时降低复杂度 | 代码能工作但读起来或维护起来比应该的更难 | | security-and-hardening | OWASP Top 10 预防、认证模式、密钥管理、依赖审计、三层边界系统 | 处理用户输入、认证、数据存储或外部集成 | | performance-optimization | 测量优先方法——Core Web Vitals 目标、性能分析工作流、包分析、反模式检测 | 存在性能要求或怀疑有回归 | ### 发布 - 自信部署 | 技能 | 作用 | 何时使用 | |—––|———––|–––––| | git-workflow-and-versioning | 主干开发、原子提交、变更规模（约 100 行）、提交即保存点模式 | 进行任何代码变更（始终） | | ci-cd-and-automation | 左移、更快更安全、特性标志、质量门流水线、失败反馈循环 | 设置或修改构建和部署流水线 | | deprecation-and-migration | 代码即负债的思维、强制性与建议性弃用、迁移模式、僵尸代码清理 | 移除旧系统、迁移用户或日落特性 | | documentation-and-adrs | 架构决策记录、API 文档、内联文档标准——记录为什么 | 做架构决策、更改 API 或发布特性 | | observability-and-instrumentation | 结构化日志、RED 指标、OpenTelemetry 追踪、基于症状的告警——边构建边埋点 | 添加遥测，或发布任何在生产中运行的内容 | | shipping-and-launch | 上线前检查清单、特性标志生命周期、分阶段发布、回滚流程、监控设置 | 准备部署到生产 | — ## 智能体人格 预配置的专家人格用于针对性审查： | 智能体 | 角色 | 视角 | |—––|——|———––| | code-reviewer | 高级 Staff 工程师 | 五轴代码审查，标准为“Staff 工程师会批准这个吗？” | | test-engineer | QA 专家 | 测试策略、覆盖率分析，以及 Prove-It 模式 | | security-auditor | 安全工程师 | 漏洞检测、威胁建模、OWASP 评估 | | web-performance-auditor | Web 性能工程师 | Core Web Vitals 审计，含 Quick/Deep 模式和指标诚实规则；通过 /webperf 运行 | 参见 docs/agents.md 了解决策矩阵、编排规则，以及人格如何与技能和斜杠命令组合。 — ## 参考检查清单 技能在需要时拉入的快速参考材料： | 参考 | 涵盖内容 | |———–|––––| | testing-patterns.md | 测试结构、命名、模拟、React/API/E2E 示例、反模式 | | security-checklist.md | 提交前检查、认证、输入验证、标头、CORS、OWASP Top 10 | | performance-checklist.md | Core Web Vitals 目标、前端/后端检查清单、测量命令 | | accessibility-checklist.md | 键盘导航、屏幕阅读器、视觉设计、ARIA、测试工具 | — ## 技能如何工作 每项技能都遵循一致的结构： ┌─────────────────────────────────────────────────┐ │ SKILL.md │ │ │ │ ┌─ 前置信息 ─────────────────────────────┐ │ │ │ name: 小写-连字符-名称 │ │ │ │ description: 引导智能体完成 [任务]。│ │ │ │ 何时使用... │ │ │ └───────────────────────────────────────────┘ │ │ 概述 → 本技能的作用 │ │ 何时使用 → 触发条件 │ │ 流程 → 步骤式工作流 │ │ 合理化 → 借口 + 反驳 │ │ 红旗 → 出了问题的迹象 │ │ 验证 → 证据要求 │ └─────────────────────────────────────────────────┘ 关键设计选择： - 流程，而非散文。 技能是智能体遵循的工作流，而不是它们阅读的参考文档。每个都有步骤、检查点和退出标准。 - 反合理化。 每项技能都包含一个表格，列出智能体跳过步骤时常用的借口（例如“我稍后加测试”）并附有文档化的反驳论据。 - 验证不可协商。 每项技能都以证据要求结束——测试通过、构建输出、运行时数据。“看起来不错”永远不够。 - 渐进式披露。 SKILL.md 是入口点。仅在需要时才加载支持性参考，从而最小化 token 使用。 — ## 项目结构 `` agent-skills/ ├── skills/ # 24 项技能（23 生命周期 + 1 元） │ ├── interview-me/ # 定义 │ ├── idea-refine/ # 定义 │ ├── spec-driven-development/ # 定义 │ ├── planning-and-task-breakdown/ # 规划 │ ├── incremental-implementation/ # 构建 │ ├── context-engineering/ # 构建 │ ├── source-driven-development/ # 构建 │ ├── doubt-driven-development/ # 构建 │ ├── frontend-ui-engineering/ # 构建 │ ├── test-driven-development/ # 构建 │ ├── api-and-interface-design/ # 构建 │ ├── browser-testing-with-devtools/ # 验证 │ ├── debugging-and-error-recovery/ # 验证 │ ├── code-review-and-quality/ # 审查 │ ├── code-simplification/ # 审查 │ ├── security-and-hardening/ # 审查 │ ├── performance-optimization/ # 审查 │ ├── git-workflow-and-versioning/ # 发布 │ ├── ci-cd-and-automation/ # 发布 │ ├── dep