好的，这是您要求的英文文章的中文翻译，已按照规范处理。
addyosmani agent-skills
Agent Skills
面向 AI 编码 Agent 的生产级工程技能。这些技能编码了高级工程师在构建软件时所使用的工作流程、质量门禁和最佳实践。它们被打包好，以便 AI Agent 在开发的每个阶段都能一致地遵循。
DEFINE PLAN BUILD VERIFY REVIEW SHIP
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Idea │───▶│ Spec │───▶│ Code │───▶│ Test │───▶│ QA │───▶│ Go │
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
/spec /plan /build /test /review /ship命令 7 个映射到开发生命周期的斜杠命令。每个命令会自动激活相应的技能。
| 你正在做什么 | 命令 | 核心原则 | |---|---|---| | 定义要构建的内容 | /spec | 先写 Spec，再写代码 | | 规划如何构建 | /plan | 小而原子的任务 | | 增量构建 | /build | 一次只做一个切片 | | 证明它能工作 | /test | 测试即证明 | | 合并前审查 | /review | 改善代码健康度 | | 简化代码 | /code-simplify | 清晰胜过巧妙 | | 发布到生产环境 | /ship | 更快更安全 |
技能也会根据你正在做的事情自动激活——设计 API 会触发 api-and-interface-design，构建 UI 会触发 frontend-ui-engineering，以此类推。
快速开始
Claude Code (推荐)
市场安装：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsSSH 错误？市场通过 SSH 克隆仓库。如果你在 GitHub 上没有设置 SSH 密钥，可以添加你的 SSH 密钥，或者使用完整的 HTTPS URL 强制使用 HTTPS 克隆：
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills本地 / 开发环境：
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skillsCursor 将任何 SKILL.md 复制到 .cursor/rules/ 中，或者引用整个 skills/ 目录。参见 docs/cursor-setup.md。
Gemini CLI 安装为原生技能以实现自动发现，或添加到 GEMINI.md 中以获得持久上下文。参见 docs/gemini-cli-setup.md。
从仓库安装：
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills从本地克隆安装：
gemini skills install ./agent-skills/skills/Windsurf 将技能内容添加到你的 Windsurf 规则配置中。参见 docs/windsurf-setup.md。
OpenCode 通过 AGENTS.md 和 skill 工具使用 Agent 驱动的技能执行。参见 docs/opencode-setup.md。
GitHub Copilot 使用 agents/ 中的 Agent 定义作为 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 / 其他 Agent 技能是纯 Markdown 格式——它们可以与任何接受系统提示或指令文件的 Agent 一起使用。参见 docs/getting-started.md。
全部 20 项技能
上述命令是入口点。在底层，它们会激活以下 20 项技能——每一项都是一个结构化的工作流程，包含步骤、验证门禁和反合理化表格。你也可以直接引用任何技能。
定义 - 明确要构建的内容
| 技能 | 作用 | 使用时机 | |---|---|---| | idea-refine | 结构化的发散/收敛思维，将模糊的想法转化为具体的提案 | 你有一个粗略的概念需要探索 | | spec-driven-development | 在任何代码之前编写 PRD，涵盖目标、命令、结构、代码风格、测试和边界 | 开始一个新项目、功能或重大变更 |
计划 - 分解任务
| 技能 | 作用 | 使用时机 | |---|---|---| | planning-and-task-breakdown | 将规范分解为小的、可验证的任务，包含验收标准和依赖顺序 | 你有了规范，需要可执行的单元 |
构建 - 编写代码
| 技能 | 作用 | 使用时机 | |---|---|---| | incremental-implementation | 薄垂直切片——实现、测试、验证、提交。特性开关、安全默认值、支持回滚的更改 | 任何涉及多个文件的更改 | | test-driven-development | 红-绿-重构，测试金字塔 (80/15/5)，测试规模，DAMP 优于 DRY，Beyonce 规则，浏览器测试 | 实现逻辑、修复错误或更改行为 | | context-engineering | 在正确的时间为 Agent 提供正确的信息——规则文件、上下文打包、MCP 集成 | 开始一个会话、切换任务或输出质量下降时 | | source-driven-development | 将每个框架决策建立在官方文档之上——验证、引用来源、标记未经验证的内容 | 希望为任何框架或库获得权威的、有来源引用的代码 | | frontend-ui-engineering | 组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍标准 | 构建或修改面向用户的界面 | | api-and-interface-design | 契约优先设计、Hyrum 定律、单版本规则、错误语义、边界验证 | 设计 API、模块边界或公共接口 |
验证 - 证明它能工作
| 技能 | 作用 | 使用时机 | |---|---|---| | browser-testing-with-devtools | 使用 Chrome DevTools MCP 获取实时运行时数据——DOM 检查、控制台日志、网络追踪、性能分析 | 构建或调试任何在浏览器中运行的内容 | | debugging-and-error-recovery | 五步分类法：重现、定位、简化、修复、防护。停止生产原则，安全回退 | 测试失败、构建中断或行为异常 |
审查 - 合并前的质量门禁
| 技能 | 作用 | 使用时机 | |---|---|---| | code-review-and-quality | 五轴审查，变更规模 (~100 行)，严重性标签 (Nit/Optional/FYI)，审查速度规范，拆分策略 | 合并任何更改之前 | | code-simplification | Chesterton 围栏，500 规则，在保持精确行为的同时降低复杂度 | 代码能工作但难以阅读或维护 | | security-and-hardening | OWASP Top 10 预防，认证模式，密钥管理，依赖审计，三层边界系统 | 处理用户输入、认证、数据存储或外部集成 | | performance-optimization | 测量优先方法——Core Web Vitals | 需要优化性能时 |