大佬操作手册（最优用法 · 快速学）

本页职责：标准答案——同场景大佬怎么用。要按优先级练 → 学习路径；要看自己历史哪句没做到 → 案例档案。

想"学得最快"就看这页。它把官方最佳实践 + Anthropic 团队真实用法浓缩成可照抄的操作流，而不是散在 773 条点评里。三块：

• A · 七类工作的端到端操作流——遇到某类任务，照大佬的完整流程走。
• B · 实战贯穿——用你真实项目的 blade-auth 鉴权打通，演示从 0 到验证的完整 Claude Code 操作。
• C · 大佬习惯速查——10+ 条肌肉记忆，照抄即用。

每条都带依据库代号（如 验证-1/计划-2），原文与出处见 逐条处理页·依据库。全部有官方出处，无编造。 配套：你自己的真实差距诊断见 改进清单、按类型复盘、逐条处理。

---

A · 七类工作的大佬端到端操作流

每类给：大佬完整操作流（可照抄的 prompt/命令/模式）→ 依据（代号）→ 你的真实差距（来自你历史的真实数据）。

A1 · 排错 / bug

操作流

1. 第一句就给齐"现象 + 复现命令 + 怀疑层"，并让它先复现再改：

我跑 `pnpm test` 报这个错：<贴完整 stack trace>。
先用这个命令复现确认，定位到大概是 src/auth/ 这层；
写一个能复现该 bug 的失败测试，再改，最后跑测试验证。根因优先，别只压症状。

2. UI/前端 bug 贴截图或真实输出（容器里它看不到你的浏览器）：

这是报错截图 <粘贴>。控制台还打了这些 <贴日志>。先据此定位是哪一层。

3. 大代码库别让它满仓库读——交子代理探索，只要结论：

use a subagent to investigate 登录失败时 token 刷新走哪条路径，回报结论就行

4. 失败 2 次就止损：/rewind 或 /clear，带更尖的线索重开，别在脏上下文里硬磕。

依据：工作流-先复现（给复现命令+stack trace）、症状-1（症状+likely location+先写失败测试）、团队-排错（喂 stack trace 追控制流，快 3 倍）、图像-粘贴、委派-隔离+上下文-2（探索交子代理免烧上下文）、纠偏-2（纠正超 2 次就 /clear）。

你的真实差距：你常只给"没反应 / 先帮我定位一下"——会话 4 那次模型 Read×19 大海捞针；还有"还是不行"反复循环。开局把三件套给齐能省掉大半空转。

A2 · 质量审查（你最大的"仪式化模糊"重灾区）

操作流

1. 把"确保没问题"换成可勾选清单 + 只报正确性：

逐项给"通过/不通过 + 证据"，别给风格建议：
1. <功能点是否达成、怎么验证>
2. <边界：空值/异常/并发 是否不崩>
3. <是否复用同一套逻辑、有无不一致>
贴出 type-check/测试结果；你没法验证、需我手点的单独列出来。

2. 让一个 fresh 子代理审 diff（没参与写的模型更客观）：

用一个子代理审查当前 git diff，对照需求检查每条是否实现、边界有没有测；
只报影响正确性/需求的 gap，不要风格偏好。

或直接用内置 /code-review。 3. 要证据不要口头保证——别接受"我确认没问题了"，要它贴出跑过的命令和输出。

依据：验证-3（要证据非口头保证）、验证-4（只报影响正确性的 gap，否则过度工程）、委派-隔离（fresh 子代理审 diff）。

你的真实差距：你"确保没问题/确定吗/完成了吗"累计追问类 65 次，且大多是 0 调用空转——模型没核对就答"是"。给清单后它逐条带证据，一次就够。

A3 · 新需求 / 功能

操作流

• 小功能：一句话带"用户故事 + 验收 + 边界"。
• 大功能：先让它采访你产出 SPEC，再新开会话实现：

我要做 X。用 AskUserQuestion 工具采访我（技术实现/UI/边界/取舍），
别问显而易见的，挖我没想到的硬骨头；问完写一份完整 spec 到 SPEC.md。

确认 SPEC 后新开一个干净会话执行（上下文专注于实现）。

依据：采访-1（大功能先 interview→SPEC.md，新会话实现）、具体-1（it can't read your mind）。

你的真实差距：你报具体 bug 很专业，但提需求偶尔一句"帮我做一下登陆功能"——模型只能猜鉴权方式/多租户/记住登录。下面 B 节就用 blade-auth 演示正确做法。

A4 · 审美 / 设计

操作流

参考 <figma 源稿 / 原型 URL / 截图> 重做这页：
组件库用 ant-design-vue，主色 #1677ff，8px 栅格。
改完截图，和参照逐项对比差异、列出来再修。

• 有 Figma 就喂 Figma 让它写+自测+迭代；有喜欢的产品就给 URL/截图。永远给"参照物"，不给形容词。

依据：视觉-1（贴截图实现+截图对比原图）、团队-设计（喂 Figma 自跑测试迭代）、具体-1（审美尤其要给参照物）。

你的真实差距：你说过"太 AI 化 / 一点也不高级 / 没有眼前一亮"——纯形容词不可验证，来回三五轮还是"不对"。给锚（图/组件库/色值）一次到位。

A5 · 放行 / 推进（你最高频，最该改）

操作流

• 大改前先看清规模再放行：

开始前先列：要改哪些文件、各自改什么、有没有动到公共逻辑。我看完再决定。

或 Shift+Tab 进 plan 模式让它先出计划，Ctrl+G 可改计划，批了再跑。

• 真想放手就给可验证目标让它自停，而不是手动"继续"：

实现 X，跑通 pnpm type-check 和这条测试再停；中途别问我，跑完给我证据。

依据：计划-切换（Shift+Tab / --permission-mode plan）、计划-2（多文件修改最该 plan）、验证-1（给可跑的检查让它自停）。

你的真实差距：你放行类 185 次（可以/继续/同意），其中一句"我同意"驱动了 151 次调用 / 改 16 文件而你没看过计划。大改前看一眼文件清单，30 秒拦下方向错误。

A6 · 探索 / 理解代码（这类你做得好，重在保持 + 加锚）

操作流

1. 从粗到细：先 give me an overview of this codebase，再 explain the main architecture patterns / how is authentication handled?。
2. 直接 @ 文件别让它自己找：解释 @src/utils/auth.ts 的登录逻辑。
3. 探索交子代理，结论回主线程，主上下文保持干净。

依据：工作流-探索递进（broad→narrow）、具体-3（@文件直接读）、委派-隔离（子代理探索回报摘要）。

你的真实差距：你这类开局质量不错，唯一缺点是常不给文件锚点，让模型自己找=读一堆无关文件烧上下文。

A7 · 部署 / 运维（你常交 codex 接力——合理，但别外包"验证"）

操作流

• 容器内能验的先让 Claude 自验再交付：mvn compile / pnpm type-check / vitest / 起 dev。
• 给 codex 的提示词附"已在容器内验证通过"的证据，别把验证也外包出去。
• CI/批处理用管道：git log --oneline -20 | claude -p "summarize these recent commits"。
• 定时/自治任务必须写清成功标准（它不能反问你）。

依据：验证-1（先给可验证证据）、自动化-管道（claude -p 管道）、调度-明确成功（自治任务明确成功标准）。

你的真实差距：你把命令交 codex 是对的（容器碰不到你 Mac），但有时把"验证"也一起外包了——容器内能验的先验，能省一来回。

---

B · 实战贯穿：blade-auth 鉴权打通（Explore → Plan → Implement → Verify → Commit）

用你科技专题项目的真实参数，演示大佬把一个真实任务从 0 做到验证的完整 Claude Code 操作流。对照你曾经的一句"帮我做一下登陆功能"，看差别。 真实参数（端口来自 CLAUDE.md，契约读 kj-frontend 源码坐实）：Gateway 15800 / blade-auth 8100 / blade-system 8106；登录 POST /api/blade-auth/token（Query 传 grantType=password&tenantId=000000&account&password，密码 SM2 加密）；业务请求头 Blade-Auth: Bearer <token> + Tenant-Id: 000000（登录换 token 那一个用 Authorization: Basic）；前端 dev 起 :8000，proxy /api/* → Gateway。 注意：此登录功能在 kj-frontend 里已实现（src/api/module/auth.ts + src/views/Login/index.vue + src/stores/user.ts + src/api/http.ts 拦截器）。下面用它演示标准 E→P→I→V→C 流程；真要改先读这几个文件。

第 1 步：开局把上下文喂够（一次）

项目根 CLAUDE.md / kj-frontend/AGENTS.md 已有契约，开局直接引用，别让它猜：

@CLAUDE.md @kj-frontend/AGENTS.md 我们要打通 blade-auth 登录。以这两份里的端口/契约为准。

第 2 步：Explore（Shift+Tab 进 plan 模式，只读不改）

（plan 模式）先只读不改，搞清三件事，给我现状和接入点，先别写代码：
1. 前端现在登录请求怎么发的、token 存在哪、axios 拦截器在哪加 header；
2. 后端 blade-auth 的 /blade-auth/token 契约（参数、返回结构）；
3. 路由守卫/401 现在怎么处理。

大代码库可改成：use a subagent to investigate 前端现有鉴权现状，回报结论（委派-隔离）。 计划-切换、工作流-探索递进、具体-3、委派-隔离。

第 3 步：Plan（让它出方案，你批准）

（plan 模式）给 blade-auth 登录打通方案：
- 登录页调 POST /api/blade-auth/token（grantType=password&tenantId=000000&account&password）；
- 拿 access_token 存 Pinia store（src/stores/user.ts，pinia-persist 落 localStorage）；
- axios 请求拦截器（src/api/http.ts）业务请求统一加 Blade-Auth: Bearer <token> 和 Tenant-Id: 000000；
- 401 统一跳登录页。
列出要改哪些文件、各自改什么、风险点。先别写代码，我看完计划再批。

计划出来用 Ctrl+G 可在编辑器里改，满意再退出 plan 模式。 计划-1、计划-2（多文件改最该 plan）。

第 4 步：Implement（退出 plan，让它写 + 自验证）

按计划实现。写完：
1. 自己跑 pnpm type-check 修到过；
2. 给 token 存取 / 拦截器加 header 写一个单测（覆盖 401 跳转）；
3. 列一张"我需要在浏览器手验的步骤"清单（我起 dev :8000）。

验证-1（给可跑的检查自停）、工作流-测试匹配（照现有测试风格写）。

第 5 步：Verify（分清谁验什么）

• 它能验：pnpm type-check + 拦截器/401 单测——让它贴结果。
• 你手验：起 :8000 → 登录 → 看 Network 请求是否带 Authorization/Tenant-Id → 故意过期 token 看是否 401 跳转。有问题就截图回贴：

登录后这个请求 401 了 <贴 Network 截图>。按截图定位拦截器哪里没加上 header。

• 后端起不来：把起服务/部署交 codex，但前端契约对不对先在容器里确认。 图像-粘贴、验证-3、团队-排错。

第 6 步：Commit

commit，写清楚改动信息；先别 push，我来 push。

（项目约定：git push 需你确认。）

对照：你以前怎么做 vs 上面

• 你以前：一句"帮我做一下登陆功能"→ 模型得猜鉴权方式、要不要多租户、token 存哪、记不记住登录 → 方向/边界对不上、返工。
• 上面六步：把契约、验收、边界一开始就钉死，plan 阶段你掌控方向，implement 阶段它自验证，一次做对。

---

C · 大佬习惯速查（照抄即用）

习惯	机制（为什么有效）	你的真实差距	照抄话术 / 操作
给可跑的检查，让它自停	没检查时"看起来完成"是唯一信号，你就成了验证回路（验证-2）	追问类 65 次、352 条 0 调用空转	"跑通 type-check 和这条测试再停，给我证据"
大改前先看计划	多文件改一步跑偏会顺错误方向改一片（计划-2）	一句"我同意"=151 次调用/16 文件	Shift+Tab 进 plan，或"先列要改哪些文件我再批"
报 bug 给复现+stack trace	有真实数据模型才能锚到出错层，快 3 倍（工作流-先复现/团队-排错）	你常"没反应/定位一下"→Read×19	"报这个错〈贴 stack trace〉，先复现再写失败测试再改"
@文件 而不是描述位置	直接读目标、不满仓库找、不烧上下文（具体-3）	你常让它自己找页面	"解释 @src/xxx 的逻辑"
探索交子代理	在独立上下文读文件、只回摘要（委派-隔离）	同一文件 Read 多遍污染主上下文	"use a subagent to investigate X"
审查给清单 + 要证据	形容词无法验证，清单可逐条核（验证-3/验证-4）	"确保没问题"反复追问	"逐条给通过/不通过+证据，只报正确性问题"
审美给参照物	"it can't read your mind"，形容词不可验证（视觉-1/具体-1）	"太AI化/不高级"形容词	"参考〈figma/截图〉重做，截图对比差异再修"
大需求先 SPEC	自包含 spec 把边界/验收前置（采访-1）	"帮我做登录"一句话	"用 AskUserQuestion 采访我，写 SPEC.md"
失败 2 次就 /clear 重开	脏上下文里纠正越多越乱（纠偏-2）	"还是不行"循环	/rewind 或 /clear + 更尖的 prompt
CLAUDE.md 沉淀规则	每会话自动加载，不必每次口头说（规则-1）	"说中文"占了一整轮	把"回复用中文"等写进项目 CLAUDE.md
跨多次用 --resume/--continue	不重述上下文接着干（续接-会话）	—	claude --continue / --resume
并行任务用 worktree	独立分支并行不打架（并行-worktree）	—	claude --worktree feature-x

---

用法建议：遇到任务先在 A 节找到对应类型照抄操作流；做完整功能照 B 节六步走；平时把 C 节当肌肉记忆。想看自己历史上具体哪句没做到，回 逐条处理。