# Claude Code 完整指南 - 研究笔记

## 资料来源

### 官方文档
- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices) - Anthropic 官方最佳实践
- [Agent Skills - Claude Code Docs](https://code.claude.com/docs/en/skills)
- [Subagents - Claude Code Docs](https://code.claude.com/docs/en/sub-agents)
- [Common Workflows - Claude Code Docs](https://code.claude.com/docs/en/common-workflows)
- [Manage Claude's Memory](https://code.claude.com/docs/en/memory)

### 社区教程
- [Claude Code Customization Guide](https://alexop.dev/posts/claude-code-customization-guide-claudemd-skills-subagents/)
- [Claude Skills Tutorial](https://sidbharath.com/claude-skills/)
- [Claude Code: Subagent Deep Dive](https://cuong.io/blog/2025/06/24-claude-code-subagent-deep-dive)
- [How to Use Claude Code Features](https://www.producttalk.org/how-to-use-claude-code-features/)
- [Claude Code Developer Cheatsheet](https://awesomeclaude.ai/code-cheatsheet)
- [Writing a Good CLAUDE.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)
- [Understanding Claude Code: Skills vs Commands vs Subagents vs Plugins](https://www.youngleaders.tech/p/claude-skills-commands-subagents-plugins)

### 开源资源
- [Claude Code Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory)
- [Awesome Claude Code Subagents](https://github.com/VoltAgent/awesome-claude-code-subagents)
- [Claude Code Sub-Agents Collection](https://github.com/lst97/claude-code-sub-agents)

---

## 一、Claude Code 核心能力

### 1.1 基础能力

- **代码生成与编辑** - 直接从命令行编写、修改、重构代码
- **文件系统操作** - 读取、创建、编辑项目文件
- **终端命令执行** - 使用 Claude 辅助运行 shell 命令
- **多文件上下文** - 理解并跨多个文件工作
- **Git 集成** - 帮助版本控制操作

### 1.2 高级功能

- **Jupyter Notebook** - 读写 notebook，解释输出（包括图像）
- **图像理解** - 可以接收截图、设计稿进行分析
- **URL 获取** - 可以获取并阅读网页内容
- **MCP 集成** - 连接外部工具和服务

### 1.3 常用场景

- 调试和修复错误
- 编写测试
- 代码重构
- 文档生成
- 探索不熟悉的代码库
- 代码审查
- Git/GitHub 操作

---

## 二、四种定制化方法

| 方法 | 触发方式 | 最佳场景 | 存储位置 |
|------|---------|---------|---------|
| **CLAUDE.md** | 自动加载 | 永久性项目规则和约定 | 项目根目录 |
| **Slash Commands** | 手动 `/command` | 显式、可重复的任务 | `.claude/commands/` |
| **Subagents** | 自动委派 | 研究型任务、保持上下文清洁 | `.claude/agents/` |
| **Skills** | 自动匹配 | 自动应用的丰富工作流 | `.claude/skills/` |

### 2.1 核心区别

- **Slash Commands**: 用户调用 (你输入 `/command`)，简单提示，单文件
- **Skills**: 模型调用 (自动)，复杂能力，多文件 + 脚本
- **Subagents**: 独立的 Claude 实例，有自己的上下文窗口

---

## 三、CLAUDE.md 详解

### 3.1 什么是 CLAUDE.md

CLAUDE.md 是一个特殊文件，Claude 在启动对话时会自动加载到上下文中。理想用于文档化：
- 常用 bash 命令
- 核心文件位置
- 代码风格指南
- 测试说明
- 仓库规范

### 3.2 内存层级 (4层)

1. **项目内存** (`./CLAUDE.md`) - 位于仓库根目录，提交到版本控制
2. **本地项目内存** (`./CLAUDE.local.md`) - 个人工作区笔记，gitignore
3. **用户内存** (`~/.claude/CLAUDE.md`) - 全局偏好，跨项目通用
4. **规则目录** (`.claude/rules/`) - 大型项目，将指令组织成多个文件

### 3.3 最佳实践

#### 保持精简
- 保持文件在 500 行以下
- 只包含每个会话都必需的信息
- 不要填充通用指令如 "写干净的代码" 或 "遵循最佳实践"

#### 具体和结构化
- "使用 2 空格缩进" 比 "正确格式化代码" 更好
- 使用项目符号和描述性标题组织

#### 包含内容 (WHAT, WHY, HOW)
1. **WHAT**: 技术栈、项目结构、代码库地图（monorepo 尤其重要）
2. **WHY**: 项目目的和各组件的作用
3. **HOW**: 如何在项目上工作 - 构建命令、测试执行、验证方法

#### 不要用作 Linter
- 永远不要包含代码风格指南 - 使用真正的 linter 和 formatter
- 考虑使用 Claude Code Hooks 或 Slash Commands 进行风格强制

#### 快速更新
- 按 `#` 键可以让 Claude 自动将指令合并到相关的 CLAUDE.md 中

### 3.4 示例结构

```markdown
# Project Name

## Tech Stack
- Language: TypeScript
- Framework: React
- Database: PostgreSQL

## Common Commands
- `npm run dev` - Start development server
- `npm test` - Run tests
- `npm run build` - Production build

## Code Conventions
- Use 2-space indentation
- Prefer functional components
- File naming: kebab-case

## Key Files
- `src/index.ts` - Entry point
- `src/config/` - Configuration files
- `tests/` - Test files

## Important Notes
- Always run tests before committing
- Use feature branches for new work
```

---

## 四、Slash Commands 详解

### 4.1 什么是 Slash Commands

Slash Command 是一个保存的提示，通过输入 `/command-name` 调用 - 就像提示的宏或快捷键。

### 4.2 存储位置

- 全局: `~/.claude/commands/`
- 项目: `.claude/commands/`

### 4.3 文件格式

```markdown
---
description: "描述命令做什么"
---

# 命令标题

具体指令内容...

## 参数
$ARGUMENTS - 使用此关键字接收参数
```

### 4.4 内置命令

- `/clear` - 重置会话上下文
- `/compact` - 压缩长对话（节省 token）
- `/model opus` - 切换到 Opus（复杂推理）
- `/model sonnet` - 切换到 Sonnet（速度和效率）
- `/rewind` - 恢复之前的代码/对话状态
- `/mcp` - 管理 MCP 服务器
- `/agents` - 管理自定义子代理
- `/config` - 查看/修改设置
- `/memory` - 编辑 CLAUDE.md 文件
- `/permissions` - 管理工具权限

### 4.5 最佳实践

- 为重复的工作流创建命令（调试循环、日志分析等）
- 将命令提交到 git 使其对整个团队可用
- 可以在命令中调用子代理或特定 skill

### 4.6 示例

```markdown
---
description: "Run tests and fix any failures"
---

# Test & Fix

1. Run the test suite
2. If any tests fail, analyze the failures
3. Fix the failing tests
4. Re-run to verify

Focus on $ARGUMENTS if specified, otherwise run all tests.
```

---

## 五、Skills 详解

### 5.1 什么是 Skills

Skill 是一个自包含的 "插件"，打包为一个文件夹，包含自定义指令、可选代码脚本和资源文件，Claude 在执行特定任务时可以按需加载。

### 5.2 与 Slash Commands 的区别

| 特性 | Slash Commands | Skills |
|-----|---------------|--------|
| 触发方式 | 手动输入 `/command` | Claude 自动匹配 |
| 复杂度 | 简单提示 | 复杂能力 |
| 文件数量 | 单文件 | 多文件 + 脚本 |
| 使用场景 | 显式重复任务 | 自动应用的工作流 |

### 5.3 目录结构

```
.claude/skills/
└── my-skill/
    ├── SKILL.md           # 必需：主要指令文件
    ├── reference.md       # 可选：补充文档
    └── scripts/           # 可选：可执行脚本
        ├── validate.py
        └── process.sh
```

### 5.4 SKILL.md 格式

```markdown
---
name: skill-name
description: When to use this skill
---

# Skill Title

## Instructions
详细的指导内容...

## Examples
示例输入和输出...
```

**重要**：
- frontmatter 使用小写名称
- description 非常关键 - 决定 Claude 何时自动调用此 skill

### 5.5 最佳实践

#### 写精确的描述
模糊描述（"处理文档"）不会正确触发。指定 Claude 何时应该使用此 skill 以及它完成什么。

#### 包含具体示例
展示预期的输入和输出。示例帮助 Claude 理解"成功是什么样子"。

#### 必要时模块化
当复杂度增长时，将冗长的 SKILL.md 拆分成单独的参考文档。

#### 彻底测试
用不同的措辞、边缘情况和与其他 skill 的组合进行评估。

### 5.6 安全考虑

**警告**：只使用来自可信来源的 skill。恶意 skill 可以执行有害命令、泄露数据或进行未授权的 API 调用。部署前审计所有代码。

### 5.7 常见用例

- 会议分析和提案生成
- 自动报告编译和格式化
- 代码审查工作流
- 内容营销标准化
- 数据验证管道

---

## 六、Subagents 详解

### 6.1 什么是 Subagents

Subagent 是 Claude Code 的轻量级实例，通过 Task Tool 运行。每个 subagent 有自己独立的上下文窗口。

### 6.2 核心优势

#### 并行化
可以启动多个 subagent 同时处理不同任务。

#### 上下文管理
- Subagent 使用自己隔离的上下文窗口
- 只将相关信息发送回主线程
- 对大型代码库探索特别有用

#### 任务委派
可以高效地委派以下任务：
- 基本文件读写
- 代码搜索
- 文件分析
- Bash 操作
- 研究任务

### 6.3 并行执行

- **并行上限**: 最多 10 个并行任务
- **队列管理**: 如果不指定并行级别，任务完成后自动从队列中拉取下一个（更高效）
- **批量行为**: 如果显式指定并行限制，会等待当前批次全部完成后再开始下一批
- **可扩展性**: 系统可以处理 100+ 任务，超出的会排队顺序执行

**建议**: 除非需要限流，否则不要指定并行级别，让 Claude Code 自主管理并行会更高效。

### 6.4 限制

- Subagent 不能再生成其他 subagent（防止无限嵌套）

### 6.5 工具访问级别

每个 subagent 可以有不同的工具访问级别：

| 类型 | 工具 | 用途 |
|-----|------|-----|
| **只读代理** | Read, Grep, Glob | 分析但不修改 |
| **研究代理** | Read, Grep, Glob, WebFetch, WebSearch | 收集信息 |
| **代码编写代理** | Read, Write, Edit, Bash, Glob, Grep | 创建和执行 |

### 6.6 创建 Subagents

#### 目录结构

```
.claude/agents/
└── my-agent/
    └── agent.md
```

或全局：`~/.claude/agents/`

#### agent.md 格式

```markdown
---
name: code-reviewer
description: Reviews code for quality and best practices
allowed_tools:
  - Read
  - Grep
  - Glob
---

# Code Reviewer Agent

## Instructions
Review the provided code for:
- Code quality
- Potential bugs
- Performance issues
- Security vulnerabilities

## Output Format
Provide structured feedback with:
- Summary
- Issues found (with severity)
- Recommendations
```

### 6.7 最佳实践

#### 何时使用 Subagents
- 复杂问题探索
- 早期对话中验证细节或调查问题
- 大量阅读/搜索任务（保持主线程清洁）
- Plan 模式下的代码库探索

#### 精简指令
研究表明，精简指令（54% 行数减少）可以保持完整功能。

#### 7 并行任务方法（功能实现）
1. 组件创建
2. 样式/CSS
3. 测试
4. 类型定义
5. 自定义 hooks/工具
6. 集成更新
7. 剩余配置/文档

---

## 七、工作流最佳实践

### 7.1 探索、计划、编码、提交

1. **探索**: 让 Claude 阅读相关文件，不写代码
2. **计划**: 使用 "think" 触发扩展思考模式，请求计划
3. **编码**: 实现解决方案
4. **提交**: 创建提交和 PR

### 7.2 测试驱动开发 (TDD)

1. 先写测试用例
2. 确认测试失败
3. 提交测试
4. 迭代编写代码使测试通过
5. 提交工作代码

### 7.3 Plan 模式

使用 Plan 模式开始每个复杂功能，制定详细大纲可以减少 30% 以上的 bug。

适用场景：
- 开始新功能
- 处理复杂挑战
- 重构代码
- 基本上任何新项目

### 7.4 权限模式

利用动态权限模式平衡速度、控制和安全：
- **Default**: 标准模式
- **AcceptEdits**: 自动接受编辑
- **Plan**: 规划模式
- **BypassPermissions**: 跳过权限（谨慎使用）

可以在会话中切换以匹配任务复杂度和风险。

### 7.5 上下文管理

- **`/clear + /catchup`**: 简单重启方法
  - `/clear` 状态
  - 运行自定义 `/catchup` 命令让 Claude 阅读 git 分支中所有更改的文件

- **Document & Clear**: 用于大型任务
  - 让 Claude 将计划和进度转储到 .md 文件
  - `/clear` 状态
  - 开始新会话，告诉 Claude 阅读 .md 并继续

### 7.6 视觉上下文

嵌入视觉输入（截图和架构图）可以减少最多 30% 的迭代周期，给 Claude 更丰富的上下文来故障排除和对齐目标。

### 7.7 检查点和回退

检查点加 `/rewind` 让你可以安全地探索和回退，而不是从头开始。

---

## 八、键盘快捷键

| 快捷键 | 功能 |
|-------|-----|
| `Esc` | 中断 Claude |
| `Esc + Esc` | 打开回退菜单（撤销更改）|
| `Ctrl+R` | 完整输出/上下文 |
| `Shift+Tab` | 自动接受（"yolo 模式"）|
| `@` | 提及文件/文件夹 |
| `!` | Bash 模式前缀 |
| `#` | 添加到内存 |

---

## 九、配置层级

优先级从高到低：

1. **企业**: `/etc/claude-code/managed-settings.json`
2. **项目本地**: `.claude/settings.local.json`
3. **项目共享**: `.claude/settings.json`
4. **用户全局**: `~/.claude/settings.json`

---

## 十、Headless 模式

使用 `-p` 标志运行非交互式：

```bash
claude -p "your prompt"
```

输出格式：
- 纯文本
- JSON
- 流式 JSON (`--output-format stream-json`)

用例：
- CI/CD 管道
- Pre-commit hooks
- 构建脚本
- GitHub 事件触发的工作流
- 主观 linting

---

## 十一、MCP 集成

通过 `claude mcp add <name> <command>` 连接外部工具。

支持的服务包括：
- GitHub
- Notion
- Linear
- Stripe
- 40+ 其他服务

配置方式：
- 项目配置
- 全局配置
- checked-in `.mcp.json` 文件

使用 `--mcp-debug` 标志排查配置问题。

---

## 十二、安全权限

在设置中配置工具访问：
- 允许特定 bash 命令
- 阻止敏感文件
- 限制 MCP 服务器
- 对生产环境使用 `deny` 列表

---

## 十三、多 Claude 工作流

### 并行验证
让一个 Claude 写代码，另一个独立审查。使用分离的上下文比单一 Claude 处理效果更好。

### 多仓库检出
在不同文件夹创建 3-4 个 git checkout，在不同终端标签页打开。循环批准权限请求并检查进度。

### Git Worktrees
多检出的轻量替代。运行独立任务，同时共享 git 历史。

```bash
git worktree add <path> <branch>
```

### Headless 模式模式

- **扇出**: 生成任务列表，为每个任务程序化调用 Claude
- **管道**: 集成 Claude 到数据处理管道
  ```bash
  claude -p "<prompt>" --json | your_command
  ```

---

## 十四、核心建议总结

1. **具体性很重要** - 提供清晰、详细的指令，减少后续修正
2. **保持 CLAUDE.md 精简** - 只包含必要信息，避免通用建议
3. **使用 subagents 处理复杂任务** - 保持主上下文清洁
4. **利用 Plan 模式** - 复杂功能前先规划
5. **频繁 `/clear`** - 在任务之间重置上下文
6. **使用检查点** - 配合 `/rewind` 安全探索
7. **提供视觉上下文** - 截图和图表能显著提高效率
8. **迭代优化 CLAUDE.md** - 像对待 prompt 一样对待它

---

## 十五、真实用户实践案例

### 15.1 Simon Willison 的观点 (知名开发者/博主)

**来源**: [Claude Skills are awesome, maybe a bigger deal than MCP](https://simonwillison.net/2025/Oct/16/claude-skills/)

**核心观点**:
- Skills 可能比 MCP 更重要，因为设计简洁
- MCP 消耗大量 token（GitHub 官方实现消耗数万 token），Skills 只需几十 token
- Claude Code 不仅是编码工具，而是"通用计算机自动化工具"

**实测案例**:
测试 slack-gif-creator skill，请求生成一个关于 "Skills 比 MCP 更酷" 的 GIF，Claude 成功完成并自动验证 Slack 大小兼容性。

**愿景**:
可以组合多个 skill（人口普查数据访问 + 数据库加载 + 云发布 + 可视化）创建"数据新闻代理"。

---

### 15.2 Puzzmo 团队的 6 周使用经验

**来源**: [6 Weeks of Claude Code - Puzzmo Blog](https://blog.puzzmo.com/posts/2025/07/30/six-weeks-of-claude-code/)

#### 成功案例

**大规模技术债务清理** (单人 6 周完成):
- React Native 组件转换为 React
- 数据库迁移
- 测试框架切换
- 实现服务端渲染
- 重建 iOS 系统

> "这些任务通常需要整个团队数周的全职努力，但现在可以作为背景工作完成。"

**快速原型验证**:
- 采用"先写后决定"方法
- 两周内为每个 PR 写测试，评估后再删除
- 游戏设计师可以在数小时（而非数周）内原型化新谜题

**Dual-Clone 工作流**:
- 设置不同的 VS Code profile
- 同时在多个 PR 上并行工作

#### 失败案例

**复杂 CSS 布局问题**:
- 可打印 PDF 的 CSS 布局问题多次尝试未解决
- 核心问题是"问题框架不完整"而非模型限制

**长期所有权**:
- 工具不擅长持续的项目上下文和所有权
- 需要人类连续性

#### 成功关键因素
- Monorepo 架构提供丰富的跨 schema、API、组件上下文
- 成熟、显式的技术栈 (React, TypeScript, GraphQL)
- 标准 CRUD 工作流
- 最近的代码库（2021年后）

---

### 15.3 开发者的 Subagents 并行化实践

**来源**: [How to Use Claude Code Subagents to Parallelize Development](https://zachwills.net/how-to-use-claude-code-subagents-to-parallelize-development/)

#### 案例 1: 功能规划加速

为 Linear 创建 "AI Insights" 页面 ticket，同时启动 3 个专家 agent:
1. **Product Manager** - 定义需求
2. **UX Designer** - 创建用户流程
3. **Senior Engineer** - 制定技术方案

> "通常需要数小时的规划，几分钟内在多个终端完成。"

#### 案例 2: Stripe 支付集成

同时启动 4 个专家:
1. **Backend Agent** - 编写 Node.js 端点
2. **Frontend Agent** - 构建 React 支付表单
3. **QA Agent** - 生成测试套件
4. **Docs Agent** - 撰写设置文档

> "所有工作在最长单个任务的时间内完成。"

#### 案例 3: 大规模重构

废弃一个在 75 个文件中使用的函数:
1. 主 agent 用 grep 找到所有实例
2. 为每个文件启动专用 sub-agent 执行替换
3. 每个 agent 在小而安全的上下文中工作

#### 案例 4: 事故响应分析

分析 3 个微服务的故障:
1. 3 个 sub-agent 并行分析各服务日志
2. 每个提取关键事件时间线
3. 主 agent 综合 3 个预处理时间线生成统一报告

---

### 15.4 10 个必备 Subagents 的真实成效

**来源**: [10 Claude Code Subagents Every Developer Needs in 2025](https://dev.to/necatiozmen/10-claude-code-subagents-every-developer-needs-in-2025-2ho)

| Agent | 成功案例 |
|-------|---------|
| **Code Reviewer** | 捕获一个会导致生产间歇性故障的微妙竞态条件。"修复花了 5 分钟；在生产中调试本需要数天。" |
| **React Specialist** | 将 300 行复杂组件用 custom hooks 重构为 80 行，提高可读性和性能 |
| **Refactoring Specialist** | 将 2000 行遗留控制器重构为干净架构，代码减少 60%，测试覆盖率 100% |
| **DevOps Engineer** | 将部署设置时间从"数天减少到数小时" |
| **Test Automator** | 在复杂应用上实现 95% 测试覆盖率，在进入 staging 前发现 15 个 bug |
| **Database Optimizer** | 将关键查询执行时间从 30 秒减少到 0.3 秒 |
| **API Designer** | 设计直观 API，前端集成时间减少 50% |
| **Security Engineer** | 在安全审计前识别并修复 3 个关键漏洞，"节省数千美元补救成本" |
| **Performance Engineer** | 页面加载时间从 8 秒减少到 1.2 秒，用户参与度提高 40% |

---

### 15.5 一位资深工程师的 CLAUDE.md 实践

**来源**: [How I Use Every Claude Code Feature](https://blog.sshh.io/p/how-i-use-every-claude-code-feature)

**实践数据**:
- 为专业 monorepo 维护 **13KB 的 CLAUDE.md**
- 文档化被 30%+ 工程师使用的工具
- 为每个工具分配"token 预算"，强制精简解释

**上下文管理策略**:

1. **简单重启**: `/clear` + 自定义 `/catchup` 命令读取 git 分支中所有修改的文件

2. **复杂任务**: 将进度文档化到 markdown，清除状态，从保存的计划恢复

**自定义命令**:
- `/catchup`: 让 Claude 阅读当前分支所有修改的文件
- `/pr`: 自动化代码清理和 PR 准备

**关于 Subagents 的不同观点**:
作者**避免使用自定义 subagents**，认为它们会"阻止上下文传递给主 agent"。更倾向于"Master-Clone"架构——让主 agent 决定何时使用内置 `Task()` 功能生成任务克隆。

**大规模重构方法**:
编写 bash 脚本并行调用 `claude -p "in /pathA change..."` — 比让一个 agent 管理数十个子任务更可扩展。

---

### 15.6 用户常见痛点与挑战

**来源**: [What are the top 3 things Claude Code users struggle with](https://gist.github.com/eonist/0a5f4ae592eadafd89ed122a24e50584)

#### 痛点 1: 使用限制不透明
- 用户报告在 10-15 分钟内就达到限制
- 即使是 $200/月的 Max 订阅也会遇到
- 无法清楚看到限制或用量跟踪

#### 痛点 2: 上下文丢失
- 会话期间 Claude Code 失去项目上下文
- auto-compact 功能经常丢弃关键项目细节

#### 痛点 3: 撤销困难
> "唯一不太擅长的，而且是很大的问题，是撤销更新，你必须过度依赖 Git。"

---

## 十六、开源 Skills/Subagents 资源库

### 16.1 Skills 资源库

| 仓库 | Stars | 描述 |
|------|-------|------|
| [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) | - | 官方和社区 Skills 精选列表 |
| [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) | - | 48 个生产就绪 Skills，覆盖营销、工程、AI/ML、监管合规等 |
| [VoltAgent/awesome-claude-skills](https://github.com/VoltAgent/awesome-claude-skills) | - | 按类别组织的 Skills 集合 |
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | - | 可与 500+ 应用集成的 Skills |

#### 热门官方 Skills

| Skill | 描述 |
|-------|------|
| **docx** | 创建、编辑、分析 Word 文档，支持修订和评论 |
| **pdf** | PDF 操作工具包，提取文本、表格、元数据 |
| **pptx** | PowerPoint 演示文稿创建和编辑 |
| **xlsx** | Excel 电子表格操作，支持公式、图表、数据转换 |
| **webapp-testing** | 使用 Playwright 测试本地 Web 应用 |
| **mcp-builder** | 创建高质量 MCP 服务器指南 |
| **frontend-design** | 指导 Claude 避免通用美学，做出大胆设计决策 |

#### 热门社区 Skills

| Skill | 作者 | 描述 |
|-------|------|------|
| **ios-simulator-skill** | conorluddy | iOS 应用构建和测试自动化 |
| **playwright-skill** | lackeyjb | 通用浏览器自动化 |
| **claude-d3js-skill** | chrisvoncsefalvay | d3.js 数据可视化 |
| **loki-mode** | asklokesh | 多代理自治创业系统，协调 37 个 AI agent |
| **obra/superpowers** | - | 20+ 经过实战检验的核心 Skills 库 |

---

### 16.2 Subagents 资源库

| 仓库 | Stars | 描述 |
|------|-------|------|
| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 7.4k | 110+ 专业 Subagents，覆盖 10 个类别 |
| [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | 19.7k | 命令、CLAUDE.md 文件、工作流精选 |

#### Subagents 分类 (110+ agents)

| 类别 | 数量 | 示例 |
|------|------|------|
| **Core Development** | 11 | api-designer, fullstack-developer, microservices-architect |
| **Language Specialists** | 25 | typescript-pro, python-pro, rust-engineer, react-specialist |
| **Infrastructure** | 14 | kubernetes-specialist, terraform-engineer, cloud-architect |
| **Quality & Security** | 12 | code-reviewer, penetration-tester, security-auditor |
| **Data & AI** | 12 | ai-engineer, data-scientist, mlops-engineer, prompt-engineer |
| **Developer Experience** | 12 | documentation-engineer, refactoring-specialist, mcp-developer |
| **Specialized Domains** | 12 | blockchain-developer, game-developer, fintech-engineer |
| **Business & Product** | 10 | product-manager, scrum-master, technical-writer |
| **Meta & Orchestration** | 9 | pied-piper, workflow-orchestrator, multi-agent-coordinator |
| **Research & Analysis** | 6 | research-analyst, competitive-analyst, trend-analyst |

---

### 16.3 Slash Commands 资源库

| 仓库 | 描述 |
|------|------|
| [wshobson/commands](https://github.com/wshobson/commands) | 57 个生产就绪命令，覆盖工作流、工具、AI/ML |
| [qdhenry/Claude-Command-Suite](https://github.com/qdhenry/Claude-Command-Suite) | 148+ 命令，54 个 AI agents，结构化工作流 |
| [ChrisWiles/claude-code-showcase](https://github.com/ChrisWiles/claude-code-showcase) | 完整项目配置示例，包含 skills、agents、commands |

#### 热门工作流命令

| 命令 | 描述 |
|------|------|
| `/feature-development` | 端到端功能实现，协调后端、前端、测试、部署 |
| `/tdd-cycle` | TDD 编排，协调测试编写、实现、重构 |
| `/full-review` | 多视角代码分析：架构、安全、性能、质量 |
| `/security-hardening` | 安全优先开发，威胁建模和漏洞评估 |
| `/incident-response` | 生产问题解决，诊断和根因分析 |

#### 热门工具命令

| 命令 | 描述 |
|------|------|
| `/docker-optimize` | 容器优化，多阶段构建和层缓存 |
| `/k8s-manifest` | Kubernetes 配置生成 |
| `/security-scan` | 漏洞评估，OWASP、CVE 扫描 |
| `/test-harness` | 测试套件生成：单元、集成、e2e、性能 |
| `/db-migrate` | 数据库迁移，零停机策略和回滚计划 |

---

## 十七、alirezarezvani 的 48 个生产级 Skills

**来源**: [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)

### Marketing (5)
| Skill | 描述 |
|-------|------|
| Content Creator | 品牌声音分析、SEO 优化、平台特定内容框架 |
| Marketing Demand & Acquisition | 多渠道需求生成、付费媒体、合作伙伴策略 |
| Marketing Strategy | 定位、GTM 策略、竞争情报 |
| App Store Optimization | Apple App Store 和 Google Play 优化 |
| Social Media Analyzer | 跨平台活动分析、ROI 追踪 |

### C-Level Advisory (2)
| Skill | 描述 |
|-------|------|
| CEO Advisor | 战略决策、财务建模、利益相关者管理 |
| CTO Advisor | 技术领导、工程团队、架构决策 |

### Product Team (5)
| Skill | 描述 |
|-------|------|
| Product Manager Toolkit | 功能优先级、访谈分析、PRD 模板 |
| Agile Product Owner | Sprint 执行、用户故事生成、速度追踪 |
| UX Researcher Designer | 人物画像生成、旅程映射、研究综合 |
| UI Design System | 设计令牌、组件架构、系统文档 |

### Project Management (6)
| Skill | 描述 |
|-------|------|
| Senior Project Management Expert | 项目组合管理、利益相关者对齐 |
| Scrum Master Expert | 敏捷促进、Sprint 仪式 |
| Atlassian Jira Expert | JQL 精通、配置、自动化 |
| Atlassian Confluence Expert | 知识管理、文档架构 |
| Atlassian Template Creator Expert | 模板设计，15+ 现成模板 |

### Core Engineering (13)
| Skill | 描述 |
|-------|------|
| Senior Software Architect | 系统架构设计和文档 |
| Senior Frontend Engineer | React/Next.js 开发、性能优化 |
| Senior Backend Engineer | API 设计、数据库优化、微服务 |
| Senior DevOps Engineer | CI/CD 自动化、基础设施即代码 |
| Code Reviewer | 自动化代码审查、PR 分析 |
| AWS Solution Architect | 无服务器架构、AWS 优化 |
| TDD Guide | 测试驱动开发方法论 |

### AI/ML/Data (5)
| Skill | 描述 |
|-------|------|
| Senior Data Scientist | 统计建模、实验 |
| Senior Data Engineer | 数据管道、ETL/ELT 工作流 |
| Senior ML/AI Engineer | MLOps、模型部署 |
| Senior Prompt Engineer | LLM 优化、RAG 系统 |

### Regulatory Affairs & Quality Management (12)
- ISO 13485 QMS 实施
- FDA 提交路径和 QSR 合规
- EU MDR 2017/745 合规
- ISO 27001 ISMS 实施
- GDPR/DSGVO 隐私和数据保护

---

## 十八、生产力数据与统计

### 使用效果统计

| 指标 | 数值 | 来源 |
|------|------|------|
| Bug 减少 | +62% | 系统化工作流命令 |
| 代码审查时间 | -58% | 系统化工作流命令 |
| 合并冲突 | 0 | "因为我们停止了每天做 50 次相同的手动任务" |
| 预计生产力提升 | 10-30% | Claude Code 2.0 官方估计 |
| 视觉上下文减少迭代 | 最高 30% | 截图和架构图 |
| Plan 模式减少 Bug | 30%+ | 制定详细大纲 |

### 真实案例数据

| 案例 | Before | After | 提升 |
|------|--------|-------|------|
| 关键查询执行时间 | 30 秒 | 0.3 秒 | 100x |
| 页面加载时间 | 8 秒 | 1.2 秒 | 6.7x |
| 用户参与度 | - | +40% | - |
| 复杂组件代码行数 | 300 行 | 80 行 | 73% 减少 |
| 遗留控制器代码 | 2000 行 | - | 60% 减少 |
| 前端集成时间 | - | -50% | - |
| 部署设置时间 | 数天 | 数小时 | - |

---

## 十九、用户评价摘录

### 正面评价

> "我已经使用 Claude Code 整整 2 周了，完全取代了我在 Copilot 中做的所有任务。Claude Code 完全值得我支付的 $20。事实上，如果我运营一个编码团队，我会很容易地为团队许可证买单，因为它真的很棒。"

> "作为产品，它在 QoL 功能上比 Codex 领先一英里。"

> "harness、prompts 和模型组合带来了神奇的体验。"

> "Opus 模型是我用过的最有'品味'的编程模型。"

### 负面评价

> "唯一不太擅长的，而且是很大的问题，是撤销更新，你必须过度依赖 Git。"

> "使用限制在 10-15 分钟内就达到，即使是 $200/月的订阅。"

> "auto-compact 功能经常丢弃关键项目细节。"

---

## 二十、工具对比

### Claude Code vs MCP

| 方面 | Claude Code Skills | MCP |
|------|-------------------|-----|
| Token 消耗 | 几十 token | 数万 token (GitHub 实现) |
| 设计理念 | 简单，利用 LLM 自然能力 | 复杂协议和规范 |
| 学习曲线 | 低 | 高 |
| 灵活性 | 高 | 中 |

### Claude Code vs CodeX CLI

| 方面 | Claude Code | CodeX CLI |
|------|------------|-----------|
| 优势 | 推理密集型任务、本地控制 | 可扩展协作开发、云集成 |
| 适用场景 | 复杂推理、单人开发 | 团队协作、云原生项目 |

---

## 二十一、完整配置示例：ChrisWiles/claude-code-showcase

**来源**: [github.com/ChrisWiles/claude-code-showcase](https://github.com/ChrisWiles/claude-code-showcase) (2.2k stars)

> "The real unlock is building a solid set of reusable skills plus agents for repetitive tasks."

### 21.1 完整项目结构

```
your-project/
├── CLAUDE.md                          # 持久项目记忆
├── .mcp.json                          # MCP 服务器配置
├── .claude/
│   ├── settings.json                  # Hooks & 环境配置
│   ├── settings.local.json            # 个人覆盖 (gitignored)
│   ├── settings.md                    # 人类可读文档
│   ├── .gitignore
│   ├── agents/                        # 自定义 AI 助手
│   │   ├── code-reviewer.md
│   │   └── github-workflow.md
│   ├── commands/                      # Slash 命令
│   │   ├── onboard.md
│   │   ├── ticket.md
│   │   ├── pr-review.md
│   │   ├── pr-summary.md
│   │   ├── code-quality.md
│   │   └── docs-sync.md
│   ├── hooks/                         # 自动化脚本
│   │   ├── skill-eval.js              # Skill 评估引擎
│   │   └── skill-rules.json           # Skill 触发规则
│   ├── skills/                        # 领域知识文档
│   │   ├── testing-patterns/
│   │   ├── systematic-debugging/
│   │   ├── react-ui-patterns/
│   │   ├── graphql-schema/
│   │   ├── core-components/
│   │   └── formik-patterns/
│   └── rules/                         # 模块化指令
└── .github/workflows/                 # GitHub Actions 自动化
    ├── pr-review.yml
    ├── code-quality.yml
    ├── docs-sync.yml
    └── dependency-audit.yml
```

### 21.2 CLAUDE.md 模板示例

```markdown
# 项目名称

## 快速概览
- 技术栈: React, TypeScript, Node.js
- 常用命令: `npm test`, `npm run lint`, `npm run build`

## 关键目录
- `src/components/` - React 组件
- `src/hooks/` - 自定义 React hooks
- `src/utils/` - 工具函数
- `src/api/` - API 客户端代码
- `tests/` - 测试文件

## 代码风格
- 必须使用 TypeScript strict 模式
- 优先使用 interface（除了 unions/intersections 用 type）
- 使用 `unknown` 替代 `any`
- 使用提前返回，避免嵌套条件
- 组合优于继承

## Git 规范
- 分支命名: `{姓名缩写}/{描述}`
- 提交格式: Conventional Commits
- PR 标题遵循提交格式

## 关键规则
- 错误处理: 永远不要静默吞掉错误
- UI 状态: 处理 loading、error、empty、success 状态
- 数据变更: 异步操作期间禁用按钮

## 测试
- 先写测试 (TDD)
- 使用工厂模式: `getMockX(overrides)`
- 测试行为，而非实现

## Skill 激活
不同任务的相关 skills:
- testing-patterns: 编写测试时
- formik-patterns: 处理表单时
- graphql-schema: 修改 GraphQL 时
- react-ui-patterns: 构建 UI 组件时
```

### 21.3 Skill 示例：testing-patterns

```markdown
---
name: testing-patterns
description: "本项目的 Jest 测试模式。用于编写测试、创建 mock 或遵循 TDD 工作流时"
allowed_tools:
  - Read
  - Write
  - Edit
  - Bash
---

# 测试模式和工具

## 核心原则

### 测试驱动开发
遵循红-绿-重构循环:
1. 先写失败的测试
2. 实现最小通过代码
3. 重构提升质量

### 行为导向测试
- 强调公共 API 和业务逻辑
- 不要测试内部实现细节
- 使用清晰、描述性的测试名称，反映实际用户行为

### 工厂模式
创建可复用的工厂函数如 `getMockX()`:
- 提供合理的默认值
- 允许属性覆盖
- 保持测试可维护

## 关键技术

### 自定义渲染工具
用必要的 Provider 包装组件:
```typescript
const renderWithTheme = (ui: React.ReactElement) => {
  return render(<ThemeProvider>{ui}</ThemeProvider>);
};
```

### 数据工厂
```typescript
const getMockUser = (overrides?: Partial<User>): User => ({
  id: 'user-1',
  name: 'Test User',
  email: 'test@example.com',
  ...overrides,
});
```

### 查询模式
- `getBy*`: 必需元素（找不到会抛错）
- `queryBy*`: 不应存在的元素
- `findBy*`: 异步加载的元素

## 要避免的反模式
- 不要验证 mock 调用而非实际渲染输出
- 不要在多个测试中重复测试数据
- 测试行为和结果，而非实现机制
```

### 21.4 Agent 示例：code-reviewer

```markdown
---
name: code-reviewer
description: "高级代码审查。代码修改后自动激活。"
allowed_tools:
  - Read
  - Grep
  - Glob
  - Bash
---

# 代码审查员

## 严重性层级
- **严重 (Critical)**: 安全问题、破坏性变更、逻辑错误
- **警告 (Warning)**: 规范违反、性能问题、代码重复
- **建议 (Suggestion)**: 命名改进、优化机会、文档缺失

## 强制执行的核心标准

### TypeScript 实践
- "禁止 `any`" — 使用 `unknown` 替代
- 优先使用 `interface`（除了 unions 用 `type`）
- 避免没有理由的类型断言

### 状态管理
- 顺序: Error → Loading (无数据时) → Empty → Success
- Loading 状态仅在数据不存在时显示
- 每个列表都需要 `ListEmptyComponent`

### 数据变更安全
- 按钮必须显示 `isLoading` 状态
- 操作期间保持 `isDisabled`（防止重复提交）
- `onError` 处理器始终显示带上下文的 toast 通知

### 不可变性
- 不直接修改；使用展开运算符
- 使用提前返回而非嵌套条件
- 最多 2 层嵌套

## 审查流程
1. 执行自动化 lint (`npm run lint`)
2. 分析完整的 diff 输出
3. 逐行追踪执行逻辑
4. 交叉检查测试、安全、性能清单
5. 对不直观的模式应用常识过滤
```

### 21.5 Command 示例：/ticket

```markdown
---
description: "完整的 JIRA/Linear 工作流：读取 ticket、实现功能、更新状态、关联 PR"
---

# Ticket 工作流

## 步骤

### 1. 获取 Ticket
使用 MCP 工具获取详情:
- 标题、描述、验收标准
- 关联项、评论

### 2. 代码库探索
- 搜索相关代码模式
- 识别需要修改的文件

### 3. 创建分支
格式: `{姓名缩写}/{ticket-id}-{简短描述}`
示例: `cw/PROJ-123-add-user-auth`

### 4. 实现
- 遵循项目模式
- 测试驱动开发
- 增量提交

### 5. 更新 Ticket
- 添加进度评论
- 将状态转为 "进行中"
- 记录任何阻塞问题

### 6. PR 和关联
- 创建包含 ticket ID 的 PR 标题
- 格式: `feat(PROJ-123): 描述`
- 关联到原始 ticket

### 7. Bug 处理
发现不相关的问题时:
- 创建单独的 ticket
- 记录关联关系
```

### 21.6 Command 示例：/onboard

```markdown
---
description: "深度任务探索，在实现前提供全面的上下文"
---

# 入职/准备

> "AI 模型是天才，但每个任务都从零开始。"

## 指令
通过以下方式为任务做准备:
1. 进行深度思考
2. 探索相关代码库
3. 根据需要提出澄清问题

## 文档要求
创建一个全面的文件:
`.claude/tasks/[TASK_ID]/onboarding.md`

这会记录你的准备工作，供同一任务的未来会话使用。

## 理念
充分准备 > 准备不足

在执行实际工作之前，投入额外精力理解上下文。
```

### 21.7 Hooks 配置

**settings.json 中的 Hooks**:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "node .claude/hooks/skill-eval.js"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npm run lint --fix"
      }
    ],
    "UserPromptSubmit": [
      {
        "command": "node .claude/hooks/skill-eval.js suggest"
      }
    ]
  }
}
```

**Skill 评估引擎触发规则**:

| 触发方式 | 分数 | 示例 |
|---------|------|------|
| 关键词匹配 | 2分 | "test", "jest", "spec" |
| 关键词模式 | 3分 | `/test|spec|mock/i` |
| 路径模式 | 4分 | `*.test.ts`, `__tests__/*` |
| 目录映射 | 5分 | `src/components/` → react-ui-patterns |
| 意图模式 | 4分 | "write a test", "add coverage" |

### 21.8 GitHub Actions 工作流

| 工作流 | 频率 | 功能 | 估计成本 |
|--------|------|------|---------|
| PR Review | 每个 PR | 自动代码审查 | $0.05-$5/次 |
| Code Quality | 每周 | 审查目录、自动修复 | - |
| Docs Sync | 每月 | 对齐文档与代码 | - |
| Dependency Audit | 每两周 | 安全依赖更新 | - |

**月度预估成本**: $10-$50（取决于 PR 量）

### 21.9 MCP 服务器集成示例

```json
{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["@anthropic/mcp-server-jira"],
      "env": {
        "JIRA_HOST": "${JIRA_HOST}",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_TOKEN": "${JIRA_TOKEN}"
      }
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["@anthropic/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}
```

**支持的集成**:
- JIRA/Linear: 读取 ticket、更新状态、链接 PR
- GitHub: PR 操作、提交、分支管理
- Slack: 团队通知
- PostgreSQL: 数据库查询
- Sentry: 错误追踪

### 21.10 最佳实践总结

1. **从 CLAUDE.md 开始** - 作为基础配置
2. **基于痛点增量构建 Skills** - 不要一次性添加所有
3. **用 Hooks 处理重复自动化** - 如 lint、格式化
4. **为复杂多步骤工作流创建 Agents** - 如代码审查
5. **利用 GitHub Actions 持续维护** - 自动化日常任务
6. **版本控制配置** - 除了 secrets 和个人设置

---

## 二十二、非技术人员/办公室人员实践案例

**来源**:
- [How to use Claude Code for non-engineering use cases](https://departmentofproduct.substack.com/p/how-to-use-claude-code-for-non-engineering)
- [How Anthropic teams use Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code)
- [Everyone should be using Claude Code more](https://www.lennysnewsletter.com/p/everyone-should-be-using-claude-code)
- [Claude Code: What It Is and Why Non-Technical People Should Use It](https://www.producttalk.org/claude-code-what-it-is-and-how-its-different/)

### 22.1 核心观点：Claude Code 不只是给程序员用的

> "Claude Code 不应该叫 Claude Code — 这个名字让非技术人员望而却步。但 Anthropic 发布的功能几乎与编写软件无关！"

> "使用 Claude Code 不需要懂编程。你不需要理解终端如何工作。如果你能整理文件夹里的文件（你会的），你能创建文本文件（你会的），你就能使用 Claude Code。"

> "越来越多的非技术人员 — 产品经理、设计师、高管 — 正在使用 Claude Code 的强大能力。这个模式很清晰：智能编码不仅仅是在加速传统开发，它正在消除技术和非技术工作之间的边界，将任何能描述问题的人变成能构建解决方案的人。"

### 22.2 为什么非技术人员应该使用 Claude Code

| 优势 | 说明 |
|------|------|
| **只需 3-4 个命令** | 不需要编程知识，只要会整理文件夹、创建文本文件 |
| **数据所有权** | 所有内容以纯文本 markdown 存储在本地，不锁定在任何生态系统 |
| **自动化重复任务** | 设置一次后，一个命令执行整个多步骤流程 |
| **并行处理** | 同时分析多个目标（如 5 个竞争对手），而非逐个进行 |

### 22.3 Anthropic 内部非工程团队的实践

#### 法务团队 (Legal)
**案例**: 创建了原型"电话树"系统，帮助团队成员找到 Anthropic 合适的律师。

**意义**: 展示了部门如何在没有传统开发资源的情况下构建自定义工具。

---

#### 市场营销团队 (Marketing)

**案例 1: 广告批量生成**
- 构建了处理 CSV 文件的智能工作流
- 识别表现不佳的广告
- 使用 2 个专门的 sub-agent 生成新变体
- **效果**: 几分钟内生成数百个新广告（原本需要数小时）

**案例 2: Figma 插件**
- 识别 Figma 中的 frame
- 通过替换标题和描述程序化生成最多 100 个广告变体
- **效果**: 将数小时的复制粘贴工作减少到每批 0.5 秒

---

#### 数据科学团队 (Data Science)

**案例**: 即使不懂 TypeScript，数据科学家也能用 Claude Code 构建完整的 React 应用来可视化 RL 模型性能。

**关键点**: 可以从零编写 TypeScript 可视化代码，而不需要理解底层代码本身。

---

#### 设计团队 (Design)

**案例 1: 自动化设计实现**
- 将 Figma 设计文件输入 Claude Code
- 设置自主循环：工具编写代码 → 运行测试 → 持续迭代
- 甚至让 Claude 构建 Vim 快捷键，只需最少的人工审核

**案例 2: 设计阶段的边缘情况发现**
- 映射错误状态、逻辑流程、系统状态
- 在设计阶段而非开发阶段识别边缘情况
- **效果**: 从根本上提高初始设计质量

---

### 22.4 办公室日常工作场景

#### 文件组织与管理

| 场景 | 实际用法 |
|------|---------|
| **文件整理** | "找出重复文件并帮我决定保留哪个" |
| **下载目录清理** | "把这些下载的文件整理到合适的文件夹" |
| **目录结构优化** | "审查我的目录结构并建议改进" |
| **旧文件清理** | "找出我可能不再需要的旧文件" |
| **发票管理** | 自动重命名和分类混乱的发票文件，整理成报税准备文件夹 |
| **系统诊断** | 检查 Mac 性能问题：内存、磁盘空间、卡住的进程 |

---

#### 内容创作与沟通

| 场景 | 实际用法 |
|------|---------|
| **写作改进** | 在 VS Code 中迭代大纲、研究主题、获得实时反馈 |
| **更新日志生成** | 扫描提交记录，几分钟内生成面向用户的更新日志（原需数小时）|
| **职位描述** | 从内部模板创建招聘计划、面试评分表、角色描述 |
| **语音转文章** | 将零散的语音笔记转换为结构化文章，保持创作者的声音 |
| **演示文稿** | 创建品牌一致的交互式 HTML 幻灯片模板 |

---

#### 商务开发

| 场景 | 实际用法 |
|------|---------|
| **潜在客户识别** | 分析项目代码，识别适合试点项目的顶级公司 |
| **GitHub 调研** | 搜索 repo 中的敏感数据模式，找到有上下文的合格线索 |
| **竞争对手研究** | 截图竞争对手在广告库中的广告，用于营销灵感 |
| **竞品分析** | 同时分析 5 个竞争对手的价格和功能，输出对比表格 |

---

#### 个人效率

| 场景 | 实际用法 |
|------|---------|
| **个人教练** | 分析日记和 git 提交，发现既定目标与实际行动之间的差距 |
| **图片增强** | 提升截图质量用于发布 |
| **视频管理** | 下载 YouTube 内容并处理音频文件 |
| **抽奖** | 从电子表格中随机选择获奖者 |

---

### 22.5 企业级部署案例

#### TELUS (电信/医疗巨头)
- 将 Claude 作为内部 Fuel iX 平台的核心引擎
- **57,000 名员工**直接访问高级 AI 工作流

#### Newfront (保险经纪公司)

| 应用场景 | 实现方式 |
|---------|---------|
| **HR 支持** | Claude 驱动的 HR 机器人回答员工查询、审查内部政策文档 |
| **合同审查** | 使用 Claude Sonnet 处理保险协议，加速合同摄入工作流 |
| **知识管理** | 完全集成到 Slack 和 Google Drive，无缝访问 |
| **效果** | HR 团队每年节省超过一个月的行政时间 |

#### Rakuten
> "Claude 处理多个电子表格，捕捉关键异常，并使用我们的程序生成报告。曾经需要一天的工作，现在一个小时就能完成。"

**效果**: 特定工作流 **8 倍效率提升**

---

### 22.6 内置 Office 技能 (Agent Skills)

Anthropic 提供了 4 个预置 Agent Skills，专门用于办公场景：

| Skill | 功能 |
|-------|------|
| **Microsoft Word** | 创建文档、编辑内容、格式化文本 |
| **PDF** | 构建格式化的 PDF 文档和报告 |
| **Microsoft PowerPoint** | 制作演示文稿、分析内容、编辑幻灯片 |
| **Microsoft Excel** | 生成电子表格、分析数据、生成带图表的报告 |

---

### 22.7 非技术人员入门指南

#### 你只需要知道的 3-4 个命令

```bash
# 1. 安装（一次性）
npm install -g @anthropic-ai/claude-code

# 2. 在任意文件夹启动
claude

# 3. 用自然语言描述你想做的事
# 例如："帮我整理这个文件夹里的发票，按日期分类"

# 4. 保存常用工作流为命令
# 创建 .claude/commands/organize-invoices.md
```

#### 实际案例：竞品分析工作流

**传统方式**:
1. 打开浏览器，访问竞争对手网站
2. 复制信息到 Excel
3. 重复 5 次
4. 手动创建对比表格
5. **耗时**: 1+ 小时

**Claude Code 方式**:
1. 创建 `competitors.txt` 列出 5 个竞争对手
2. 创建一个 slash command 定义分析流程
3. 运行一个命令
4. **耗时**: 几分钟，自动生成对比表格

---

### 22.8 办公场景效率提升数据

| 场景 | 效率提升 |
|------|---------|
| 广告变体生成 | 数小时 → 几分钟 |
| Figma 广告批量生成 | 数小时 → 0.5 秒/批 |
| 更新日志生成 | 数小时 → 几分钟 |
| 报表生成 (Rakuten) | 1 天 → 1 小时 (8x) |
| 综合生产力提升 | 25-75% |
| HR 行政时间节省 | 每年超过 1 个月 |

---

### 22.9 给非技术人员的建议

1. **不要被名字吓到** — "Claude Code" 听起来很技术，但大部分功能与编程无关

2. **从文件组织开始** — 这是最低门槛的入口，效果立竿见影

3. **利用自然语言** — 你不需要学习任何语法，只需用中文描述你想做什么

4. **保存常用工作流** — 一次设置，反复使用

5. **使用内置 Office Skills** — Word、Excel、PPT、PDF 都有现成的能力

6. **并行处理** — 让多个任务同时进行，而不是逐个等待

7. **数据留在本地** — 所有文件都存储在你的电脑上，不用担心隐私