Agent Skills安装使用教程

GitHub: addyosmani/agent-skills

目录

1. 安装教程
2. 重启后的变化
3. 使用教程
4. 技能详解
5. 常见问题

1. 安装教程

方式一：Marketplace 自动安装（推荐）

# 1. 添加 marketplaceclaude plugin marketplaceaddaddyosmani/agent-skills# 2. 安装插件claude plugininstallagent-skills@addy-agent-skills

方式二：手动安装（网络受限时使用）

# 1. 创建目录mkdir-p~/.claude/plugins/repos ~/.claude/plugins/cache/agent-skills# 2. 克隆仓库cd~/.claude/plugins/reposgitclone https://github.com/addyosmani/agent-skills.git# 3. 复制文件到缓存目录cdagent-skillscp-r* ~/.claude/plugins/cache/agent-skills/

然后手动编辑配置文件：

编辑~/.claude/plugins/installed_plugins.json：

{"version":2,"plugins":{"agent-skills@addy-agent-skills":[{"scope":"user","installPath":"C:\\Users\\Lenovo\\.claude\\plugins\\cache\\agent-skills","version":"1.0.0","installedAt":"2026-06-25T06:12:00.000Z","lastUpdated":"2026-06-25T06:12:00.000Z"}]}}

编辑~/.claude/settings.json，在enabledPlugins中添加：

{"enabledPlugins":{"ecc@ecc":true,"agent-skills@addy-agent-skills":true}}

验证安装

# 检查技能目录ls~/.claude/plugins/cache/agent-skills/skills/# 检查命令目录ls~/.claude/plugins/cache/agent-skills/commands/

更新插件

# 拉取最新代码cd~/.claude/plugins/repos/agent-skillsgitpull# 同步到缓存目录cdagent-skillscp-r* ~/.claude/plugins/cache/agent-skills/# 重启 Claude Code 生效

2. 重启后的变化

新增的斜杠命令

重启 Claude Code 后，你将获得以下 8 个新命令：

新增的技能能力

Claude Code 将获得以下专业能力：

新增的专家角色

新增的参考清单

• definition-of-done- 完成定义
• testing-patterns- 测试模式
• security-checklist- 安全检查清单
• performance-checklist- 性能检查清单
• accessibility-checklist- 无障碍检查清单
• observability-checklist- 可观测性检查清单
• orchestration-patterns- 编排模式

3. 使用教程

基本工作流程

DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP 定义 规划 构建 验证 审查 发布

场景一：新功能开发（完整流程）

步骤 1：定义规格

# 启动 Claude Codeclaude# 使用 /spec 定义功能规格/spec 用户注册功能，支持邮箱和手机号注册

Claude 会：

• 询问需求细节
• 生成规格说明
• 定义验收标准

步骤 2：规划任务

/planning

Claude 会：

• 拆分为小的原子任务
• 确定任务依赖关系
• 生成实施计划

步骤 3：增量构建

/build

Claude 会：

• 一次实现一个任务切片
• 每完成一个任务进行验证
• 保持代码可运行状态

步骤 4：测试验证

/test

Claude 会：

• 编写测试用例
• 运行测试
• 验证覆盖率

步骤 5：代码审查

/review

Claude 会：

• 检查代码质量
• 检查安全问题
• 提供改进建议

步骤 6：发布

/ship

Claude 会：

• 准备发布文档
• 执行 CI/CD 流程
• 部署到生产环境

场景二：快速构建（自动化模式）

# 一键完成规划和实现/build auto

Claude 会：

1. 自动生成计划
2. 展示计划供审批
3. 实现所有任务

场景三：代码审查

# 审查当前代码/review# 简化代码/code-simplify# 性能审计/webperf

场景四：Bug 修复

# 调试模式# Claude 会自动使用 debugging-and-error-recovery 技能# 修复后验证/test# 提交前审查/review

高级用法

组合使用

# 先定义规格/spec API 接口设计# 规划任务/planning# 增量构建/build# 安全审查/review （Claude 会自动应用 security-auditor 角色）# 性能优化/webperf

指定重点

# 代码审查时关注安全/review 重点关注 SQL 注入和 XSS# 性能审计时关注加载速度/webperf 重点关注首屏加载时间

4. 技能详解

核心技能说明

spec-driven-development- 规格驱动开发

原则: 先写规格，再写代码

流程:

1. 收集需求
2. 编写规格说明
3. 定义验收标准
4. 基于规格实现

好处:

• 减少返工
• 明确预期
• 便于测试

incremental-implementation- 增量实现

原则: 一次一个切片，始终保持可运行

流程:

1. 选择最小可运行切片
2. 实现并测试
3. 确认可运行
4. 进入下一个切片

好处:

• 降低风险
• 便于调试
• 持续交付价值

test-driven-development- 测试驱动开发

原则: 测试即证明

流程:

1. 编写失败的测试 (RED)
2. 编写最小实现使测试通过 (GREEN)
3. 重构代码 (REFACTOR)

好处:

• 代码质量高
• 重构有信心
• 文档即测试

doubt-driven-development- 怀疑驱动开发

原则: 当不确定时，停下来验证

流程:

1. 识别不确定性
2. 编写验证代码
3. 确认假设正确
4. 继续实现

好处:

• 避免错误假设
• 减少 bug
• 提高代码可靠性

context-engineering- 上下文工程

原则: 为 AI 提供最佳上下文

技巧:

• 清晰的文件结构
• 良好的命名
• 适当的注释
• 有意义的类型定义

好处:

• AI 理解更准确
• 生成代码质量更高
• 减少误解

专家角色说明

code-reviewer- 代码审查专家

职责:

• 检查代码质量
• 发现潜在 bug
• 提供改进建议

检查项:

• 命名规范
• 代码结构
• 错误处理
• 性能问题

test-engineer- 测试工程师

职责:

• 设计测试策略
• 编写测试用例
• 验证覆盖率

测试类型:

• 单元测试
• 集成测试
• 端到端测试

security-auditor- 安全审计师

职责:

• 检查安全漏洞
• 验证输入验证
• 审查认证授权

检查项:

• SQL 注入
• XSS 攻击
• CSRF 防护
• 敏感数据泄露

web-performance-auditor- Web 性能审计师

职责:

• 测量性能指标
• 识别瓶颈
• 提供优化建议

关注指标:

• LCP (最大内容绘制)
• FID (首次输入延迟)
• CLS (累积布局偏移)

5. 常见问题

Q1: 命令不生效怎么办？

检查:

1. 确认插件已安装：ls ~/.claude/plugins/cache/agent-skills/
2. 确认配置正确：检查installed_plugins.json和settings.json
3. 重启 Claude Code

Q2: 如何更新插件？

cd~/.claude/plugins/repos/agent-skillsgitpullcp-r* ~/.claude/plugins/cache/agent-skills/# 重启 Claude Code

Q3:/build auto和/build有什么区别？

Q4: 如何跳过某些步骤？

Agent Skills 设计为强制执行完整流程，但你可以：

1. 明确说明: “跳过测试，直接发布”
2. 接受风险: Claude 会警告但会执行

注意: 不建议跳过测试和安全审查

Q5: 插件和其他插件冲突吗？

Agent Skills 与其他插件（如 ECC）兼容，可以同时使用。

Q6: 如何禁用插件？

编辑~/.claude/settings.json：

{"enabledPlugins":{"agent-skills@addy-agent-skills":false}}

或删除插件：

rm-rf~/.claude/plugins/cache/agent-skills

附录：快速参考卡

┌─────────────────────────────────────────────────────┐ │ Agent Skills 命令速查 │ ├─────────────────────────────────────────────────────┤ │ /spec - 定义功能规格 │ │ /planning - 任务规划与拆分 │ │ /build - 增量构建（逐步确认） │ │ /build auto - 自动构建（一键完成） │ │ /test - 测试验证 │ │ /review - 代码审查 │ │ /code-simplify - 代码简化 │ │ /ship - 发布部署 │ │ /webperf - Web 性能审计 │ ├─────────────────────────────────────────────────────┤ │ 工作流程: DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP │ └─────────────────────────────────────────────────────┘

参考链接

• GitHub: addyosmani/agent-skills