Agent Skills安装&使用教程

GitHub: addyosmani/agent-skills

1. 安装教程

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

bash 复制代码

# 1. 添加 marketplace
claude plugin marketplace add addyosmani/agent-skills

# 2. 安装插件
claude plugin install agent-skills@addy-agent-skills

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

bash 复制代码

# 1. 创建目录
mkdir -p ~/.claude/plugins/repos ~/.claude/plugins/cache/agent-skills

# 2. 克隆仓库
cd ~/.claude/plugins/repos
git clone https://github.com/addyosmani/agent-skills.git

# 3. 复制文件到缓存目录
cd agent-skills
cp -r * ~/.claude/plugins/cache/agent-skills/

然后手动编辑配置文件：

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

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 中添加：

json 复制代码

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

验证安装

bash 复制代码

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

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

更新插件

bash 复制代码

# 拉取最新代码
cd ~/.claude/plugins/repos/agent-skills
git pull

# 同步到缓存目录
cd agent-skills
cp -r * ~/.claude/plugins/cache/agent-skills/

# 重启 Claude Code 生效

2. 重启后的变化

新增的斜杠命令

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

命令	功能	使用示例
`/spec`	定义规格（先规格后代码）	`/spec 用户登录功能`
`/planning`	任务规划与拆分	`/planning`
`/build`	增量构建	`/build`
`/build auto`	自动生成计划并实现	`/build auto`
`/test`	测试验证	`/test`
`/review`	代码审查	`/review`
`/ship`	发布到生产环境	`/ship`
`/code-simplify`	代码简化	`/code-simplify`
`/webperf`	Web 性能审计	`/webperf`

新增的技能能力

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

阶段	技能	说明
定义	`interview-me`	通过访谈明确需求
	`idea-refine`	精炼想法
	`spec-driven-development`	规格驱动开发
规划	`planning-and-task-breakdown`	任务拆分
构建	`incremental-implementation`	增量实现
	`test-driven-development`	测试驱动开发
	`context-engineering`	上下文工程
	`source-driven-development`	源码驱动开发
	`doubt-driven-development`	怀疑驱动开发
	`frontend-ui-engineering`	前端 UI 工程
	`api-and-interface-design`	API 接口设计
验证	`browser-testing-with-devtools`	浏览器测试
	`debugging-and-error-recovery`	调试与错误恢复
审查	`code-review-and-quality`	代码质量审查
	`code-simplification`	代码简化
	`security-and-hardening`	安全加固
	`performance-optimization`	性能优化
发布	`git-workflow-and-versioning`	Git 工作流
	`ci-cd-and-automation`	CI/CD 自动化
	`deprecation-and-migration`	弃用与迁移
	`documentation-and-adrs`	文档与决策记录
	`observability-and-instrumentation`	可观测性
	`shipping-and-launch`	发布上线

新增的专家角色

角色	职责
`code-reviewer`	代码审查专家
`test-engineer`	测试工程师
`security-auditor`	安全审计师
`web-performance-auditor`	Web 性能审计师

新增的参考清单

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

3. 使用教程

基本工作流程

bash 复制代码

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

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

步骤 1：定义规格

bash 复制代码

# 启动 Claude Code
claude

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

Claude 会：

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

步骤 2：规划任务

bash 复制代码

/planning

Claude 会：

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

步骤 3：增量构建

bash 复制代码

/build

Claude 会：

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

步骤 4：测试验证

bash 复制代码

/test

Claude 会：

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

步骤 5：代码审查

bash 复制代码

/review

Claude 会：

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

步骤 6：发布

bash 复制代码

/ship

Claude 会：

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

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

bash 复制代码

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

Claude 会：

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

场景三：代码审查

bash 复制代码

# 审查当前代码
/review

# 简化代码
/code-simplify

# 性能审计
/webperf

场景四：Bug 修复

bash 复制代码

# 调试模式
# Claude 会自动使用 debugging-and-error-recovery 技能

# 修复后验证
/test

# 提交前审查
/review

高级用法

组合使用

bash 复制代码

# 先定义规格
/spec API 接口设计

# 规划任务
/planning

# 增量构建
/build

# 安全审查
/review  （Claude 会自动应用 security-auditor 角色）

# 性能优化
/webperf

指定重点

bash 复制代码

# 代码审查时关注安全
/review 重点关注 SQL 注入和 XSS

# 性能审计时关注加载速度
/webperf 重点关注首屏加载时间

4. 技能详解

核心技能说明

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

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

流程:

收集需求
编写规格说明
定义验收标准
基于规格实现

好处:

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

`incremental-implementation` - 增量实现

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

流程:

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

好处:

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

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

原则: 测试即证明

流程:

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

好处:

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

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

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

流程:

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

好处:

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

`context-engineering` - 上下文工程

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

技巧:

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

好处:

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

专家角色说明

`code-reviewer` - 代码审查专家

职责:

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

检查项:

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

`test-engineer` - 测试工程师

职责:

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

测试类型:

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

`security-auditor` - 安全审计师

职责:

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

检查项:

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

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

职责:

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

关注指标:

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

5. 常见问题

Q1: 命令不生效怎么办？

检查:

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

Q2: 如何更新插件？

bash 复制代码

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

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

模式	说明
`/build`	增量构建，一次一个任务，每步确认
`/build auto`	自动生成计划并实现所有任务，只在开始时确认

Q4: 如何跳过某些步骤？

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

明确说明: "跳过测试，直接发布"
接受风险: Claude 会警告但会执行

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

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

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

Q6: 如何禁用插件？

编辑 ~/.claude/settings.json：

json 复制代码

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

或删除插件：

bash 复制代码

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

附录：快速参考卡

bash 复制代码

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

参考链接

GitHub : addyosmani/agent-skills

Agent Skills安装&使用教程

目录

1. 安装教程

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

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

验证安装

更新插件

2. 重启后的变化

新增的斜杠命令

新增的技能能力

新增的专家角色

新增的参考清单

3. 使用教程

基本工作流程

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

步骤 1：定义规格

步骤 2：规划任务

步骤 3：增量构建

步骤 4：测试验证

步骤 5：代码审查

步骤 6：发布

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

场景三：代码审查

场景四：Bug 修复

高级用法

组合使用

指定重点

4. 技能详解

核心技能说明

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

incremental-implementation - 增量实现

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

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

context-engineering - 上下文工程

专家角色说明

code-reviewer - 代码审查专家

test-engineer - 测试工程师

security-auditor - 安全审计师

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

5. 常见问题

Q1: 命令不生效怎么办？

Q2: 如何更新插件？

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

Q4: 如何跳过某些步骤？

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

Q6: 如何禁用插件？

附录：快速参考卡

参考链接

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

`incremental-implementation` - 增量实现

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

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

`context-engineering` - 上下文工程

`code-reviewer` - 代码审查专家

`test-engineer` - 测试工程师

`security-auditor` - 安全审计师

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

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