Claude Code 实战指南：从入门到精通

通过本文你将获得什么

• 用最小配置，让 Claude Code“懂你的项目”
• 把团队规范沉淀为可复用的 Skills、Agents、Commands
• 用 Hooks 与 CI 把格式化、测试、审查自动化
• 通过 MCP/LSP 把 Claude 连接到真实工具链与类型系统

目录（快速导航）

• 快速起步：5 分钟看到效果
• 核心概念详解：CLAUDE.md / Skills / Commands / Agents / Hooks
• 进阶配置：MCP / LSP / 智能技能推荐系统
• 自动化工作流：GitHub Actions 集成
• 最佳实践：循序渐进的落地策略
• Git 提交建议 与 完整示例索引
• 优秀的开源项目和合集

为什么你应该关注 Claude Code

想象一下：你有一位超级厉害的同事，他能记住项目的所有规范、理解你的代码风格、自动运行测试、帮你审查代码，甚至能在你睡觉时自动维护项目。这不是科幻，这就是配置好的 Claude Code 能做到的。

大多数开发者严重低估了当前 LLM 智能体的能力。一旦你掌握了 Claude Code 的正确使用方式，它就像是给你的开发团队增加了一位永不疲倦、记忆力超群的高级工程师。

真实场景举例：

• 自定义组件库？ 准备一份”组件使用说明书”（Skill），Claude 生成的代码就会自动遵循你的设计规范

• 代码质量检查？ 设置自动化钩子（Hooks），每次修改后自动格式化、运行测试、类型检查

• 深度代码审查？ 配置审查智能体（Agent），按照你的检查清单自动审查每个 PR

• JIRA/Linear 集成？ 一个命令就能让 Claude 读取需求、实现功能、更新工单状态

这份指南将带你从零开始，循序渐进地掌握 Claude Code 的精髓，把它变成你开发工作中不可或缺的得力助手。

快速起步：5 分钟看到效果

第一步：创建项目记忆文件

在项目根目录（或推荐的 .claude/CLAUDE.md）创建 CLAUDE.md 文件，这是 Claude 的”项目笔记本”，每次启动时它都会自动阅读。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 我的项目

## 项目概述
这是一个使用 React + TypeScript 的前端项目。

## 技术栈
- React 18
- TypeScript 5.0
- Vite 构建工具
- Jest 测试框架

## 代码规范
- 使用函数组件和 Hooks
- 组件文件使用 PascalCase 命名
- 测试文件后缀为 `.test.tsx`

就这么简单！现在 Claude 已经知道你的项目基本情况了。

第二步：体验第一个技能（Skill）

创建 .claude/skills/testing-patterns/SKILL.md：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

---
name: testing-patterns
description: Jest 测试规范，包括如何编写单元测试、Mock 数据等
---

# 测试编写规范

## 基本结构
- 使用 `describe` 分组测试用例
- 使用 `it` 或 `test` 编写单个测试
- 测试文件与源文件同名，后缀为 `.test.tsx`

## Mock 数据
使用工厂函数创建测试数据：
~~~typescript
const createMockUser = () => ({
  id: 1,
  name: 'Test User'
});
~~~

现在试试对 Claude 说：”帮我写一个用户列表组件的测试”，你会发现它自动遵循了你定义的规范！

第三步：添加自动化钩子

创建 .claude/settings.json：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "hooks": {
    "PostToolUse": [
      {
        "name": "auto-format",
        "tools": ["WriteFile", "ReplaceInFile"],
        "command": "npx prettier --write ${files}",
        "filePatterns": ["**/*.{ts,tsx,js,jsx}"]
      }
    ]
  }
}

现在，每次 Claude 修改代码后，都会自动格式化！

核心概念详解

CLAUDE.md：Claude 的项目记忆

类比： 把它想象成新员工入职时看的”项目手册”。你不会指望新同事记住所有细节，但你会给他一份文档，包含项目的核心信息。

为什么需要？

• Claude 每次启动都是”失忆”的，它需要项目上下文
• 与其每次都重复告诉它项目信息，不如写在一个固定位置
• 这是最基础也是最重要的配置

三个存放位置（按优先级排序）：

1. .claude/CLAUDE.md - 项目级别（推荐，可以提交到 Git）
2. ./CLAUDE.md - 项目根目录
3. ~/.claude/CLAUDE.md - 用户级别（所有项目共享）

应该写什么？

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# 项目名称

## 项目概述
简要说明项目是做什么的，解决什么问题。

## 技术架构
- 前端框架：React 18 + TypeScript
- 状态管理：Zustand
- API：GraphQL (Apollo Client)
- 样式：TailwindCSS + CSS Modules

## 目录结构
~~~text
src/
  components/  # 可复用组件
  pages/       # 页面组件
  hooks/       # 自定义 Hooks
  utils/       # 工具函数
~~~

## 关键约定
- 所有 API 调用必须有错误处理
- 组件必须有 loading 和 error 状态
- 不使用 `any` 类型

## 常用命令
- `npm run dev` - 启动开发服务器
- `npm test` - 运行测试
- `npm run build` - 构建生产版本

实战建议：

• 不要写得太长（Claude 会优先读取这个文件，占用 token）
• 专注于”最重要的 20% 信息”
• 随着项目演进不断更新

Skills：给 Claude 的专业培训教材

类比： 想象你在培训一个新同事使用公司的自研 UI 组件库。你不会每次都口头解释，而是给他一份”组件使用手册”。Skill 就是这个手册。

为什么需要？

• Claude 不可能知道你团队的特定规范和约定
• 与其每次都在对话中解释，不如写成可复用的”知识库”
• 当检测到相关任务时，Claude 会自动激活对应的 Skill

Skill 结构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

---
name: core-components
description: 公司自研组件库使用规范，包括 Button、Input、Modal 等组件的使用方法
model: sonnet
tools: [Read, WriteFile]
---

# 核心组件库使用指南

## Button 组件

### 基本用法
~~~tsx
import { Button } from '@/components/core';

<Button variant="primary" size="md" onClick={handleClick}>
  点击我
</Button>
~~~

### Props 说明

- `variant`: 'primary' | 'secondary' | 'danger'
- `size`: 'sm' | 'md' | 'lg'
- `loading`: boolean - 显示加载状态

### 设计规范

- 主要操作用 primary
- 次要操作用 secondary
- 危险操作（删除等）用 danger

**关键字段说明：**

| 字段 | 必填 | 说明 |
|------|------|------|
| `name` | 是 | 小写字母+连字符，与目录名一致 |
| `description` | 是 | **最重要！** Claude 用这个判断何时激活 Skill |
| `model` | 否 | 指定使用的模型（sonnet/opus/haiku）|
| `tools` | 否 | 限制可用的工具（如只读取不写入）|

**实战建议：**
- `description` 字段要包含用户可能说的关键词
- 一个 Skill 专注一个领域（不要大而全）
- 提供具体的代码示例（比文字描述更有效）

**常见 Skill 类型：**

1. **组件库规范** - 自研组件的使用方法
2. **测试规范** - 如何编写和组织测试
3. **API 规范** - GraphQL/REST API 的调用约定
4. **调试方法** - 系统化的问题排查流程
5. **代码风格** - 特定的编码规范和最佳实践

Commands：一键触发的工作流

类比： 就像在终端输入 npm run dev 启动开发服务器一样，Commands 让你用 /命令名 快速触发预定义的工作流。

为什么需要？

• 有些任务需要固定的步骤和检查项
• 与其每次都说一遍，不如定义成一个命令
• 可以和 MCP 服务器结合，实现复杂的自动化

文件位置： .claude/commands/{命令名}.md

示例 1：深度任务探索（/onboard）

.claude/commands/onboard.md：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

---
name: onboard
description: 深入理解任务需求，包括技术调研、方案设计等
---

# 任务深度分析

执行以下步骤：

1. **需求理解**
   - 详细阅读任务描述
   - 列出关键功能点
   - 识别潜在的边界情况

2. **技术调研**
   - 搜索相关代码和组件
   - 查看类似功能的实现
   - 确定复用哪些现有代码

3. **方案设计**
   - 提出 2-3 个可行方案
   - 对比各方案的优劣
   - 给出推荐方案和理由

4. **风险评估**
   - 列出潜在的技术风险
   - 评估工作量和复杂度
   - 提出需要额外关注的点

使用方式：

1

/onboard

示例 2：工单处理（/ticket）

这个命令能实现真正的”自动化开发”：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

---
name: ticket
description: 处理 JIRA/Linear 工单，从读取到实现到更新状态
---

# 工单处理流程

## 1. 读取工单
使用 MCP 工具获取工单详情：
- 工单标题和描述
- 验收标准
- 相关附件和评论

## 2. 任务分析
- 理解需求
- 设计技术方案
- 列出需要修改的文件

## 3. 实现功能
按照验收标准实现功能：
- 编写代码
- 添加测试
- 更新文档

## 4. 质量检查
- 运行测试
- 代码审查
- 确认验收标准都满足

## 5. 更新工单
- 添加实现说明
- 关联 PR 链接
- 更新工单状态为 "In Review"

使用方式：

1

/ticket PROJ-123

Claude 会自动完成从读取工单到提交代码的全流程！

Agents：专业领域的智能助手

类比： 如果 Skills 是”培训教材”，Agents 就是”专业顾问”。你可以随时请他们按照预定义的流程和标准完成特定任务。

为什么需要？

• 某些任务需要固定的评估流程（如代码审查）
• Agent 会严格按照你定义的标准执行
• 可以确保质量门槛的一致性

文件位置： .claude/agents/{agent名}.md

示例：代码审查 Agent

.claude/agents/code-reviewer.md：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

---
name: code-reviewer
description: 全面的代码审查，包括类型安全、错误处理、性能等方面
---

# 代码审查检查清单

## 1. TypeScript 类型安全
- [ ] 没有使用 `any` 类型
- [ ] 所有函数都有明确的返回类型
- [ ] Props 接口定义完整
- [ ] 正确使用了泛型类型

## 2. 错误处理
- [ ] API 调用有 try-catch
- [ ] 用户友好的错误提示
- [ ] 边界情况都有处理
- [ ] 不会出现未捕获的异常

## 3. React 最佳实践
- [ ] 使用函数组件
- [ ] Hooks 依赖数组正确
- [ ] 避免不必要的重渲染
- [ ] Key 属性使用恰当

## 4. 用户体验
- [ ] Loading 状态清晰
- [ ] Error 状态有提示
- [ ] Empty 状态有引导
- [ ] 交互反馈及时

## 5. 测试覆盖
- [ ] 核心逻辑有测试
- [ ] 边界情况有测试
- [ ] Mock 数据合理
- [ ] 测试描述清晰

## 审查输出格式

### ✅ 通过的项
列出做得好的地方

### ⚠️ 需要改进的项
列出需要优化的地方，按优先级排序

### 💡 建议
提供进一步优化的建议

使用方式： 在对话中直接说：”使用 code-reviewer agent 审查刚才的改动”，或者在 GitHub Actions 中自动触发。

Hooks：自动化的魔法时刻

类比： 就像 Git Hooks 能在 commit 前自动运行检查一样，Claude Code Hooks 能在特定时机自动执行任务。

为什么需要？

• 有些任务应该”自动发生”，不需要人为触发
• 确保代码质量和规范的一致性
• 减少重复性的手工操作

配置位置： .claude/settings.json

四种 Hook 类型：

实战示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

{
  "hooks": {
    "PreToolUse": [
      {
        "name": "protect-main-branch",
        "command": "bash .claude/hooks/check-branch.sh",
        "continueOnError": false
      }
    ],
    "PostToolUse": [
      {
        "name": "auto-format",
        "tools": ["WriteFile", "ReplaceInFile"],
        "command": "npx prettier --write ${files}",
        "filePatterns": ["**/*.{ts,tsx,js,jsx}"]
      },
      {
        "name": "run-tests",
        "tools": ["WriteFile"],
        "command": "npm test -- --findRelatedTests ${files}",
        "filePatterns": ["**/*.test.{ts,tsx}"]
      },
      {
        "name": "type-check",
        "tools": ["WriteFile"],
        "command": "npx tsc --noEmit",
        "filePatterns": ["**/*.{ts,tsx}"]
      }
    ],
    "UserPromptSubmit": [
      {
        "name": "skill-suggestion",
        "command": "bash .claude/hooks/skill-eval.sh"
      }
    ]
  }
}

Hook 配置字段：

变量支持：

• ${files} - 被修改的文件列表
• ${tool} - 当前工具名称
• ${env.VAR} - 环境变量

进阶配置：释放 Claude Code 的完整潜力

MCP 服务器：连接外部世界

什么是 MCP？ MCP (Model Context Protocol) 让 Claude Code 能够连接到外部工具和服务，如 JIRA、GitHub、Slack、数据库等。这是实现真正自动化工作流的关键。

配置位置： .mcp.json（项目根目录，建议提交到 Git）

工作原理： MCP 服务器在本地运行，为 Claude 提供工具函数。比如配置了 JIRA MCP 后，Claude 就能使用 jira_get_issue、jira_update_issue 等工具。

常用 MCP 服务器配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

{
  "jira": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-jira"],
    "env": {
      "JIRA_HOST": "${JIRA_HOST}",
      "JIRA_EMAIL": "${JIRA_EMAIL}",
      "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
    }
  },
  "github": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-github"],
    "env": {
      "GITHUB_TOKEN": "${GITHUB_TOKEN}"
    }
  },
  "linear": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-linear"],
    "env": {
      "LINEAR_API_KEY": "${LINEAR_API_KEY}"
    }
  },
  "slack": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-slack"],
    "env": {
      "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}"
    }
  },
  "postgres": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-postgres"],
    "env": {
      "DATABASE_URL": "${DATABASE_URL}"
    }
  }
}

配置字段说明：

环境变量配置：

在 shell 配置文件（.bashrc、.zshrc）或 .env 文件中设置：

1
2
3
4

export JIRA_HOST="your-company.atlassian.net"
export JIRA_EMAIL="your-email@company.com"
export JIRA_API_TOKEN="your-api-token"
export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"

自动批准 MCP 服务器：

在 settings.json 中配置：

1
2
3
4
5

{
  "mcpServers": {
    "autoApprove": ["jira", "github", "linear"]
  }
}

实战工作流示例：

有了 MCP，配合 /ticket 命令，你能实现：

1. Claude 读取 JIRA 工单（jira_get_issue）
2. 理解需求并实现功能
3. 运行测试确保质量
4. 创建 GitHub PR（github_create_pull_request）
5. 更新 JIRA 工单状态（jira_update_issue）
6. 在 Slack 通知团队（slack_post_message）

全程自动化！

LSP 集成：让 Claude 像 IDE 一样理解代码

什么是 LSP？ LSP (Language Server Protocol) 让 Claude 能够实时”看到”代码的类型信息、错误、定义跳转等，就像你的 IDE 一样。

为什么重要？

• 没有 LSP：Claude 只能”读文本”，可能写出类型错误的代码
• 有了 LSP：Claude 立即知道类型错误，生成的代码质量大幅提升

配置方式：

在 settings.json 中启用插件：

1
2
3
4
5
6
7
8
9
10

{
  "lspPlugins": {
    "typescript-lsp": {
      "enabled": true
    },
    "pyright-lsp": {
      "enabled": true
    }
  }
}

支持的语言：

LSP 提供的能力：

• 实时诊断：修改后立即看到类型错误和警告
• 类型信息：悬停查看类型、函数签名
• 代码导航：跳转到定义、查找引用
• 智能补全：上下文感知的符号建议

高级配置（.lsp.json）：

1
2
3
4
5
6
7
8

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "rootPatterns": ["tsconfig.json", "package.json"],
    "languageIds": ["typescript", "typescriptreact"]
  }
}

排查问题：

1. 检查二进制是否安装：

   1 2	which typescript-language-server which pyright

2. 启用调试日志：

   1 2 3 4 5 6 7 8

   { "lspPlugins": { "typescript-lsp": { "enabled": true, "logLevel": "debug" } } }

3. 检查插件状态： 在 Claude Code 中输入 /lsp status

智能技能推荐系统

这是什么？ 一个自动化系统，能分析你的每个提示词，智能推荐应该激活哪些 Skills。你不需要手动指定，系统会根据关键词、文件路径、意图模式自动匹配。

工作流程：

1. 提示词分析 - 检测关键词和文件路径
2. 目录映射 - 根据文件位置推断需要的技能
3. 置信度评分 - 为每个匹配打分
4. 自动推荐 - 超过阈值的 Skills 会被建议激活

配置文件：

1. Hook 配置 (.claude/settings.json)：

1
2
3
4
5
6
7
8
9
10

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "name": "skill-evaluation",
        "command": "bash .claude/hooks/skill-eval.sh"
      }
    ]
  }
}

1. 技能规则 (.claude/hooks/skill-rules.json)：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
  "testing-patterns": {
    "description": "Jest 测试模式和 TDD 工作流",
    "priority": 9,
    "triggers": {
      "keywords": ["test", "jest", "spec", "tdd", "mock"],
      "keywordPatterns": ["\\btest(?:s|ing)?\\b", "\\bspec\\b"],
      "pathPatterns": ["**/*.test.ts", "**/*.test.tsx"],
      "intentPatterns": [
        "(?:write|add|create|fix).*(?:test|spec)",
        "(?:test|spec).*(?:for|of|the)"
      ]
    },
    "excludePatterns": ["e2e", "maestro", "end-to-end"]
  },
  "graphql-schema": {
    "description": "GraphQL schema 定义和 resolver 编写",
    "priority": 8,
    "triggers": {
      "keywords": ["graphql", "query", "mutation", "resolver"],
      "pathPatterns": ["**/schema/*.ts", "**/resolvers/*.ts"],
      "intentPatterns": ["(?:add|create|update).*(?:query|mutation)"]
    }
  }
}

评分机制：

• 关键词匹配：每个 +3 分
• 关键词模式（正则）：每个 +2 分
• 路径模式匹配：每个 +5 分
• 意图模式匹配：每个 +4 分
• 优先级加成：priority 字段值
• 阈值：默认 8 分以上推荐

实战示例：

提示词： “帮我给 UserList 组件写测试”

分析结果：

• 关键词匹配：test (+3)
• 意图模式：write.*test (+4)
• 优先级：9
• 总分：16 → ✅ 自动激活 testing-patterns Skill

提示词： “修改 src/components/UserList.test.tsx”

分析结果：

• 关键词匹配：test (+3)
• 路径匹配：*.test.tsx (+5)
• 优先级：9
• 总分：17 → ✅ 自动激活 testing-patterns Skill

如何使用：

1. 复制示例的 Hook 脚本到项目：
   • .claude/hooks/skill-eval.sh
   • .claude/hooks/skill-eval.js
   • .claude/hooks/skill-rules.json

2. 在 settings.json 中配置 Hook

3. 根据项目自定义 skill-rules.json 中的规则

自动化工作流：GitHub Actions 集成

PR 自动审查

功能： 每个 PR 创建后，Claude 自动进行全面的代码审查，并将结果作为评论发布。

配置文件： .github/workflows/pr-claude-code-review.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic-api-key: $
          command: /pr-review
          github-token: $

审查内容包括：

• TypeScript 类型安全
• 错误处理和边界情况
• React 最佳实践
• 性能和可访问性
• 测试覆盖率

定期维护任务

代码质量审查（每周日）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

name: Weekly Code Quality Check

on:
  schedule:
    - cron: '0 0 * * 0'  # 每周日午夜
  workflow_dispatch:

jobs:
  quality-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Random Directory Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic-api-key: $
          command: /code-quality

文档同步（每月 1 号）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

name: Monthly Docs Sync

on:
  schedule:
    - cron: '0 0 1 * *'  # 每月 1 号
  workflow_dispatch:

jobs:
  docs-sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Sync Documentation
        uses: anthropics/claude-code-action@v1
        with:
          anthropic-api-key: $
          command: /docs-sync

依赖审计（每两周）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

name: Dependency Audit

on:
  schedule:
    - cron: '0 0 1,15 * *'  # 每月 1 号和 15 号
  workflow_dispatch:

jobs:
  dependency-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Audit Dependencies
        uses: anthropics/claude-code-action@v1
        with:
          anthropic-api-key: $
          command: /dependency-audit

配置 API Key

在 GitHub 仓库中添加 Secret：

1. 进入仓库的 Settings → Secrets and variables → Actions
2. 添加 ANTHROPIC_API_KEY
3. 输入你的 Claude API Key

成本估算

月度总计： $10 - $50（取决于 PR 数量）

最佳实践：循序渐进的落地策略

第一阶段：基础配置（第 1 周）

目标： 让 Claude 了解你的项目基本情况

任务清单：

• 创建 CLAUDE.md，包含项目概述和技术栈
• 设置基础的 settings.json
• 配置自动格式化 Hook

为什么从这开始？ 这些是”投入产出比”最高的配置，立即就能看到效果。

第二阶段：核心技能（第 2-3 周）

目标： 教会 Claude 你最常用的模式

任务清单：

• 创建测试规范 Skill
• 创建组件库使用 Skill（如果有自研组件）
• 创建 API 调用规范 Skill

循序渐进策略：

1. 不要一次写 10 个 Skill
2. 从最痛的痛点开始（你最经常重复解释的东西）
3. 每个 Skill 保持专注（一个领域）
4. 逐步完善，不求一次完美

第三阶段：自动化提效（第 4-5 周）

目标： 让重复性工作自动化

任务清单：

• 配置自动运行测试的 Hook
• 配置类型检查 Hook
• 创建代码审查 Agent
• 设置 PR 自动审查 GitHub Action

实战建议：

• 从最烦人的重复工作开始自动化
• 每次只加一个自动化，观察效果
• 确保自动化不会拖慢开发速度

第四阶段：深度集成（第 6-8 周）

目标： 实现端到端的工作流自动化

任务清单：

• 配置 MCP 服务器（JIRA/Linear）
• 创建 /ticket 命令
• 启用 LSP 集成
• 配置智能技能推荐系统
• 设置定期维护 GitHub Actions

持续优化原则

1. 观察和迭代

• 注意 Claude 经常”做错”的地方
• 将这些规范加入对应的 Skill
• 不断完善 CLAUDE.md

2. 团队协作

• 将配置提交到 Git
• 团队成员共享相同的规范
• 定期 Review 和更新配置

3. 不要过度配置

• 80/20 法则：20% 的配置解决 80% 的问题
• 只配置真正有价值的东西
• 保持配置简洁易维护

Git 提交建议

应该提交到 Git：

• CLAUDE.md
• .claude/settings.json
• .claude/skills/
• .claude/commands/
• .claude/agents/
• .claude/hooks/（脚本文件）
• .mcp.json
• .lsp.json
• .github/workflows/（Claude 相关的 workflow）

不要提交：

• .env 文件（包含 API Key）
• .claude/chat-history/（对话历史）
• 临时日志文件

.gitignore 示例：

1
2
3
4

.env
.env.local
.claude/chat-history/
*.log

完整示例文件索引

Agents（智能助手）：

• code-reviewer.md - 全面的代码审查
• github-workflow.md - Git 工作流管理

Commands（快捷命令）：

• ticket.md - 工单全流程处理
• onboard.md - 深度任务探索
• pr-review.md - PR 审查工作流
• code-quality.md - 代码质量检查
• docs-sync.md - 文档同步

Hooks（自动化钩子）：

• skill-eval.sh - 技能评估包装器
• skill-eval.js - 技能匹配引擎
• skill-rules.json - 模式匹配规则

Skills（专业技能）：

• testing-patterns - TDD、工厂函数、Mock
• systematic-debugging - 四阶段调试法
• react-ui-patterns - Loading/Error/Empty 状态
• graphql-schema - Queries、Mutations、Codegen
• core-components - 设计系统和组件库
• formik-patterns - 表单处理和验证

GitHub Workflows：

• pr-claude-code-review.yml - PR 自动审查
• scheduled-claude-code-quality.yml - 每周代码质量检查
• scheduled-claude-code-docs-sync.yml - 每月文档同步
• scheduled-claude-code-dependency-audit.yml - 每两周依赖审计

优秀的开源项目和合集

• claude-code-showcase：一套较完整的 Claude Code 工程化落地样板，涵盖 hooks / skills / agents / commands / GitHub Actions，适合对照你的项目逐项迁移与裁剪。
• obsidian-skills：面向 Obsidian 的 Skills 集合，适合学习“如何把个人工作流写成可复用技能”，以及技能文件的组织方式。
• awesome-agent-skills：Agent Skills/工具/教程的精选列表，适合快速扫一遍生态版图，按“文档处理 / 开发工具 / 数据分析 / 安全”等方向补齐能力。
• awesome-claude-skills：偏实践向的 Claude Skills 汇总，适合按场景（测试、架构、自动化、集成等）挑选可直接复用的技能模板。

结语：开启你的 AI 驱动开发之旅

Claude Code 不仅仅是一个代码助手，它是你开发工作流的”操作系统升级”。通过合理的配置和使用，它能：

• ✅ 记住项目规范：不再需要每次都重复说明
• ✅ 自动执行检查：确保代码质量和一致性
• ✅ 智能推荐方案：基于项目历史和最佳实践
• ✅ 端到端自动化：从读取需求到提交代码
• ✅ 持续维护项目：处理那些”该做但总是拖延”的任务

记住核心原则：

• 从小处开始，循序渐进
• 专注于真正的痛点
• 让自动化为你服务，而不是被配置束缚
• 不断迭代优化

现在就开始你的第一个 CLAUDE.md 吧！你会惊讶地发现，配置好的 Claude Code 真的能成为你最得力的”虚拟队友”。

最后，最近很火的 OpenCode 项目，和 Claude Code 是完全兼容的，本文提到的所有配置和实践都可以直接应用在 OpenCode 上，欢迎大家一起探索更多可能性！

---

真诚邀请您走进我的知识小宇宙，关注我个人的公众号，在这里，我将不时为您献上独家原创且极具价值的技术内容分享。每一次推送，都倾注了我对技术领域的独特见解与实战心得，旨在与您共享成长过程中的每一份收获和感悟。您的关注和支持，是我持续提供优质内容的最大动力，让我们在学习的道路上并肩同行，共同进步，一起书写精彩的成长篇章!

---