# 开发者 · AI 转型操作手册

> 对应教程：[阶段2 全员赋能](../../pages/stage2.html)、[阶段4 闭环试点](../../pages/stage4.html)、[阶段3 基础设施](../../pages/stage3.html)
> 一句话：你是 AI 转型的主力执行者——用 AI 把重复劳动交出去，把精力放到架构、审查、定义问题上。

---

## 一、你的角色定位
AI 时代，开发者的价值从「写代码」转向「**定义问题 + 设计架构 + 审查验证 + 沉淀知识**」。代码大量由 AI 生成，但**你对业务的理解、对架构的判断、对产出的把关，AI 替代不了**。

> 人 + AI，人是根本。AI 扩展你的能力边界，但不替代你的判断。

## 二、核心任务
1. **精通 AI 编码工具**（Claude Code），把重复/模板代码交给 AI
2. **写好 CLAUDE.md / Skill**，把团队规范变成 AI 能读的资产
3. **改代码前先看影响**（代码图谱），避免盲改
4. **审查 AI 产出**，不让错误逻辑溜进去
5. **沉淀可复用能力**（Skill），从「自己快」变「团队快」

## 三、怎么做（按优先级）

### ⚡ 10 分钟快速上手（零基础起步）

先跑通这条最小闭环，再看下面的展开：

1. **装 Claude Code**：到 [官方文档](https://docs.claude.com/claude-code) 按系统装好。
2. **认证**：两种方式——有 Anthropic API Token 就用 Token，或用 Claude 订阅账号登录（首次运行 `claude` 会引导）。
3. **进项目根目录启动**：

   ```bash
   cd 你的项目目录
   claude            # 启动 Claude Code 交互
   ```

4. **写第一个 CLAUDE.md**（项目根目录，3-5 行就够，别多写）：

   ```bash
   code CLAUDE.md    # 或用任意编辑器
   ```

   内容举例（按你项目实际改）：

   ```markdown
   # 项目规范
   - 技术栈：Java 17 + Spring Boot 3 + MyBatis
   - 红线：禁止改 test/ 目录；Service 层必须有接口；提交走 Conventional Commits
   - 启动：mvn spring-boot:run
   ```

5. **让 AI 改一段代码**：在 Claude Code 里说「把 `XxxService.java` 的 `findById` 加个缓存」，让它改。
6. **人审**：`git diff` 看改动对不对，确认没问题再提交。**这一步绝不能省**——AI 写的代码必须人来过眼。

跑通这条链，你就拿到了 AI 编码的最小工作回路。后面所有的「精通」都是在这条链上叠配置、叠规范、叠自动化。

### 3.1 精通 Claude Code（决定数倍产出差距）
- 安装认证 → 四层配置 → 权限（deny 优先）
- **Effort Level**：复杂任务用 high
- **五大扩展组件**：CLAUDE.md（始终注入）/ Slash Commands / Subagents / Skills / MCP
- **上下文三件套**：`/clear`（修正两次后必用）/ `/btw` / `/rewind`
- 详见 [《Claude Code 完全手册》](../../assets/ref/Claude-Code-完全手册.html)

### 3.2 写好 CLAUDE.md（规范资产化）
- 技术栈、提交规范、禁止项写进 CLAUDE.md，提交 Git
- **检验标准**：对每行问「删掉这行，AI 会犯错吗？」不会就删
- 详细指令移进 Skill（按需加载），别堆 CLAUDE.md 烧上下文

### 3.3 改代码前必跑 impact（代码图谱）
- 改任何函数/类前，先跑 `impact` 看爆炸半径
- 提交前必跑 `detect_changes` 看受影响符号
- **铁律**：NEVER edit without impact；NEVER commit without detect_changes
- **无代码图谱时怎么办**：没建代码图谱（阶段 3 没做），上述 `impact` / `detect_changes` 跑不了——别硬跑、也别因此就不查影响了。用 **grep 搜上下游 + 人审** 替代：改一个函数前，先 `grep` 出所有调用它的地方，自己脑补调用链，确认改动不会把别的模块带崩；提交前用 `git diff` 逐行人审。能力降级（靠人补），但闭环仍能跑——见 [教程阶段 4 §3 的「无代码图谱」降级方案](../../pages/stage4.html)。

### 3.4 审查 AI 产出（质量把关）
- AI 生成代码 ≠ 正确代码，**必须人审**
- **不让 AI 同时写代码和测试**（会写出验证错误逻辑的测试，全绿但全错）
- 关键规则用 Hook 强制（CLAUDE.md 只是建议，Hook 是确定性的）

### 3.5 沉淀 Skill（从个体到团队）
- 把高频操作做成 Skill 共享（团队 Skill 仓库）
- 写清 description（决定是否自动调用）+ 触发/禁止条件

## 四、你的工具箱
| 工具 | 用途 | 出处 |
|---|---|---|
| Claude Code | 主力 AI 编码 | 阶段2 |
| CLAUDE.md / Skill / Hook | 规范资产化 | 阶段2 |
| 代码图谱（[code-lens](https://gitlab.21tb.com/eln/code-lens)） | 改代码前看影响 | 阶段3 |
| OpenSpec + Superpowers | 规范驱动闭环 | 阶段4 |

## 五、检查清单
- [ ] Claude Code 已精通（Effort / 扩展组件 / 上下文管理）
- [ ] CLAUDE.md 已提交 Git，每行经「删掉会犯错吗」检验
- [ ] 改代码前必跑 impact，提交前必跑 detect_changes
- [ ] AI 产出必经人审，不让 AI 同时写代码和测试
- [ ] 高频操作已沉淀成 Skill

## 六、常见坑
- ❌ 全员开全权限（`--dangerously-skip-permissions`）当入门配置
- ❌ 跳过探索直接编码（= 重写 bug）
- ❌ 信任 AI 不验证（尤其测试，会被偷改）
- ❌ CLAUDE.md 越写越臃肿（烧上下文）