AI 编码智能体的生产级工程技能库Agent Skills 完全指南 核心观点agent-skills是由 Addy Osmani 开源的一套面向 AI 编码智能体的生产级工程技能包。它将资深工程师在软件开发各阶段所遵循的工作流程、质量门禁和最佳实践封装成结构化的技能Skill让 AI 智能体能够在开发全生命周期中一致、可靠地执行这些规范。核心理念技能Skills 工作流程 质量门禁 最佳实践的标准化封装️ 开发生命周期全览DEFINE PLAN BUILD VERIFY REVIEW SHIP ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ Idea │─▶│ Spec │─▶│ Code │─▶│ Test │─▶│ QA │─▶│ Go │ │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship每个阶段对应一条斜杠命令命令触发时自动激活对应技能组合。 关键信息一、8 条核心斜杠命令命令用途核心原则/spec定义要构建的内容先写规格再写代码/plan规划如何构建小而原子化的任务/build增量式构建一次一个切片/test验证功能正确性测试即证明/review合并前质量审查持续改善代码健康度/webperf审计 Web 性能先度量再优化/code-simplify简化代码清晰优于聪明/ship发布到生产更快即更安全 自动驾驶模式/build auto一次批准计划后自动完成所有任务无需人工在任务间干预不跳过验证每个任务仍然是测试驱动并单独提交遇到失败或风险步骤时自动暂停二、全部 24 项技能清单技能按开发阶段分为 6 大类 Meta元技能技能作用using-agent-skills将输入任务映射到正确技能定义共享操作规则 Define定义阶段技能作用触发时机interview-me逐问提炼用户真实需求直到达到 ~95% 置信度需求模糊时idea-refine发散/收敛思维将模糊想法转化为具体提案有粗糙概念需探索时spec-driven-development编写覆盖目标、结构、代码风格、测试、边界的 PRD新项目或重大变更前️ Plan规划阶段技能作用planning-and-task-breakdown将规格分解为带验收标准和依赖排序的小任务 Build构建阶段技能作用incremental-implementation薄垂直切片实现→测试→验证→提交支持特性开关和回滚test-driven-development红绿重构循环测试金字塔 80/15/5DAMP 优于 DRYcontext-engineering在正确时机向智能体提供正确信息规则文件/上下文打包/MCP集成source-driven-development每个框架决策都以官方文档为依据注明来源并标记未验证部分doubt-driven-development对每个非平凡决策进行对抗性审查CLAIM→EXTRACT→DOUBT→RECONCILE→STOPfrontend-ui-engineering组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍api-and-interface-design契约优先设计、Hyrum 定律、单版本规则、错误语义、边界验证✅ Verify验证阶段技能作用browser-testing-with-devtoolsChrome DevTools MCP 获取运行时数据DOM、控制台、网络、性能分析debugging-and-error-recovery五步分类法复现→定位→缩减→修复→防护 Review审查阶段技能作用code-review-and-quality五维审查变更量约 100 行严重性标签Nit/Optional/FYIcode-simplification切斯特顿栅栏原则、500行规则降低复杂度同时保留行为security-and-hardeningOWASP Top 10 防护、认证模式、密钥管理、依赖审计、三层边界系统performance-optimization文章截断未完整显示三、快速安装方式通用 CLI支持 70 智能体# 安装全部 24 个技能 npx skills add addyosmani/agent-skills # 浏览后选择安装 npx skills add addyosmani/agent-skills --list # 安装单个技能 npx skills add addyosmani/agent-skills --skill code-review-and-quality npx skills add addyosmani/agent-skills --skill interview-me npx skills add addyosmani/agent-skills --skill test-driven-developmentClaude Code推荐# 通过插件市场安装 /plugin marketplace add addyosmani/agent-skills /plugin install agent-skillsaddy-agent-skills # 若遇 SSH 错误强制使用 HTTPS /plugin marketplace add https://github.com/addyosmani/agent-skills.git # 修复 Windows/macOS 上的 SSH 权限问题 git config --global url.https://github.com/.insteadOf gitgithub.com:其他工具支持工具安装方式Cursor技能文件放.cursor/skills/简短策略放.cursor/rules/*.mdcCodexcodex plugin marketplace add addyosmani/agent-skillsGemini CLIgemini skills install https://github.com/addyosmani/agent-skills.git --path skillsAntigravity CLIagy plugin install https://github.com/addyosmani/agent-skills.gitWindsurf将技能内容加入 Windsurf rules 配置Kiro技能文件放.kiro/skills/支持项目级/全局级其他智能体技能是纯 Markdown可直接用作 system prompt 或指令文件四、自动触发机制部分技能会根据上下文自动激活设计 API → 自动触发api-and-interface-design构建 UI → 自动触发frontend-ui-engineering 个人启发规格先于代码是 AI 时代更重要的原则AI 生成代码的速度极快若需求不清晰错误代码同样会以极快速度堆积。/spec强制在动手前写清 PRD是防止 AI 跑偏的关键护栏。技能即流程的可执行文档传统工程规范往往停留在 Wiki 或口口相传agent-skills将其变成 AI 可直接执行的结构化工作流这是工程文化数字化的具体实践。doubt-driven-development值得特别关注对 AI 输出的每个非平凡决策进行对抗性复审CLAIM→EXTRACT→DOUBT→RECONCILE这种让 AI 质疑 AI的模式是对抗 AI 过度自信的有效手段。/build auto的设计哲学很有启示它去除的是任务间的人工干预而非验证本身——每个任务仍然测试驱动、单独提交失败自动暂停。这体现了自动化≠放弃控制的原则。 延伸思考技能的腐化问题当框架/工具版本更新时技能中的最佳实践可能过时。如何为这 24 个技能建立持续维护机制避免技能变成过期规范是否应该在技能文件中内置版本号和有效期声明跨智能体一致性的代价将同一套技能同时部署到 Claude Code、Cursor、Copilot 等不同智能体每个底层模型对同一指令的理解和执行方式存在差异。这套技能体系是否应该针对不同模型做方言适配还是通过标准化指令写法来抹平差异人机协作边界的再思考/build auto让 AI 在批准计划后自主执行所有任务随着技能体系越来越完善哪些决策应该永远保留人工节点安全相关变更、生产数据库迁移、API 契约变更——是否需要在技能层面硬编码必须人工确认的触发条件
