跳到主要内容

专业工作流与高手操作

高级
What you'll learn
  • 编排并行子代理——并知道何时该升级为脚本驱动的动态工作流
  • 把钩子当作确定性的粘合剂：保存时 lint、为停止设关卡、阻止被禁止的写入
  • 把你反复使用的提示词变成自定义斜杠命令、技能和一种输出风格
  • 构建一套 MCP 组合，以及可在 CI 中无人值守运行的无头流水线（claude -p）
  • 有纪律地运行 探索 → 计划 → 执行 → 审查 循环，并保持上下文精简
  • 把 CLAUDE.md 当作代码对待：简短、修剪过、信噪比高

这是各种原语不再是孤立功能、而开始组成工作流的页面。如果你已经知道子代理或钩子是什么，那么杠杆就在于你如何堆叠它们：一个斜杠命令启动一轮计划模式，子代理把工作扇出，一个钩子在测试通过前不让本轮结束，再用一次无头调用把整件事在 CI 里跑起来。我们来把它们连起来。

心智模型：谁掌握着计划？​

下面的每个高手操作，都是对同一个问题的不同回答——谁掌握着计划和中间结果？ Anthropic 自己对全新的动态工作流功能的阐述把它讲得很清楚：

工具由谁决定接下来运行什么结果存放在哪里规模
子代理Claude，逐轮决定Claude 的上下文窗口每轮几个
技能Claude，遵循提示词Claude 的上下文窗口与子代理相同
代理团队一个主导代理，逐轮决定一份共享的任务清单少数几个长期协作者
动态工作流脚本脚本变量数十到数百

这种递进本身就是全部要义：先从一个 Claude 开始，委派给子代理来保护上下文，只有当某个任务需要的代理数量超出一次对话所能协调的范围时，才把计划搬进代码。

操作 1 — 并行子代理，然后升级为工作流​

一个子代理是独立的 Claude，拥有自己的上下文窗口和受限的工具集；它返回的是结果，而非它的完整对话记录。高手的习惯是把彼此独立的工作扇出：

把审查扇出到多个模块

Review the changes in auth/, billing/, and api/ — use the code-reviewer
subagent on each, in parallel. Report only correctness bugs and missing tests.

三个审查者同时运行，每个都在差异上消耗自己的上下文，于是你的主会话看到的是三份整洁的报告，而不是三段原始差异。需要注意的是：并行只在子任务彼此独立时才有帮助。如果步骤 B 需要步骤 A 的输出，就按顺序运行；如果它们写入相同的文件，就用 git worktree 把它们隔离开。

当任务超出一次对话的承载范围时——比如一次涉及 500 个文件的迁移、一次覆盖整个代码库的 bug 排查、需要跨多个来源交叉核对的研究——就升级为**动态工作流**。Claude 会写一段 JavaScript 编排脚本（扇出 → 归约 → 综合），由运行时在后台执行，最多并发 16 个代理，而进入你上下文的只有最终答案。用 ultracode 关键字触发它，或者干脆用大白话提出请求：

启动一个动态工作流

ultracode: audit every API endpoint under src/routes/ for missing auth checks,
then cross-check each finding with a second agent before reporting

真正的杀手锏不只是更多代理——而是脚本可以套用一种可复用的质量模式，比如让相互独立的代理在任何结论被汇报之前先对抗式地审查彼此的发现。试试内置的 /deep-research <question> 来现场看看这种模式：它会对每条主张投票，并过滤掉那些经不起交叉核对的。

Pro tip
  • 把一次好的工作流运行保存为命令：打开 /workflows，选中那次运行，按 s。它会在未来每个会话里变成 /你的名字。
  • 先在一个切片上估算成本——一个目录，而不是整个仓库。一次运行可能比一次对话多出多得多的代理（以及 token）。

操作 2 — 钩子：确定性的粘合剂​

CLAUDE.md 里的指令是建议性的——Claude 通常会照做。钩子是确定性的——它们在循环中的固定节点运行一段脚本，每次都保证执行。当某件事必须毫无例外地发生时，就用钩子。

三种杠杆最高的钩子模式：

Guided walkthrough1 of 3
  1. 在 Claude 编辑文件之后，自动运行你的格式化工具或 linter，让代码库永远不会跑偏。反馈也会回流给 Claude，于是它会自我纠正。

你不必手写 JSON。让 Claude 替你撰写钩子：

让 Claude 写一个钩子

Write a hook that runs eslint --fix after every file edit, and a second hook
that blocks any Write or Edit to the db/migrations/ folder. Add them to
.claude/settings.json and show me the config.
Watch out
  • 一个不停拦截的 Stop 钩子，在连续拦截若干次后会被覆盖，这样会话才不会死锁——你的关卡是一道安全护栏，而不是一个无限循环。
  • 钩子以你 shell 的权限运行。在提交任何钩子脚本之前先审查它，就像你审查 CI 配置一样。

操作 3 — 自定义斜杠命令、技能与输出风格​

任何你提示两次的东西都应该变成一个原语。决策很简单：技能是知识，钩子是保证，MCP 是动作，斜杠命令是入口。

一个斜杠命令（或者一个设了 disable-model-invocation: true 的技能）封装了一段你手动触发的可复用工作流。$ARGUMENTS 让它可以参数化：

.claude/skills/fix-issue/SKILL.md

---
name: fix-issue
description: Triage and fix a GitHub issue end-to-end
disable-model-invocation: true
---
Fix GitHub issue $ARGUMENTS:
1. gh issue view to read the issue
2. Search the codebase for the relevant files
3. Write a failing test that reproduces the bug
4. Implement the fix, then run tests and lint until green
5. Commit with a descriptive message and open a PR

用 /fix-issue 1234 来运行它。对于任何带有副作用、你想刻意手动触发而不是让 Claude 自行调用的东西，使用 disable-model-invocation: true。

输出风格改变 Claude 在整个会话中如何沟通——对专家可以简洁，用于教学时可以详尽并附带解释，或者采用一种你的工具链能解析的结构化格式。把一个自定义斜杠命令（做什么）与一种输出风格（怎么做）配对，你就同时塑造了这次交互的两端。

官方文档里最被低估的高手操作：在做一个大功能之前，让 Claude 来面试你，然后开一个全新的会话、依据写好的规格去构建。

用面试产出规格，再在干净的上下文里构建

I want to build [brief description]. Interview me in detail using the
AskUserQuestion tool — technical implementation, UI/UX, edge cases, tradeoffs.
Dig into the hard parts I might not have considered. When we've covered
everything, write a complete, self-contained spec to SPEC.md.

操作 4 — 构建一套 MCP 组合​

MCP 服务器是 Claude 通过 JSON-RPC 调用、用来真正做事的可执行进程——查询你的数据库、读取 Sentry、拉取一份 Figma 设计、提交一个 Linear issue。高手的“组合”是一小套经过深思熟虑的服务器，而不是你能找到的所有东西：

往你的组合里添加服务器

claude mcp add --transport stdio sentry -- npx -y @sentry/mcp-server
claude mcp add --transport http linear https://mcp.linear.app/sse

有两条原则能让一套 MCP 组合保持高效：

  • 有 CLI 时优先用 CLI。 gh、aws、gcloud 和 sentry-cli 是与一项服务对话最节省上下文的方式——Claude 已经熟悉它们，而且它们不会在每一轮都往上下文里加载一套工具 schema。把 MCP 留给那些没有好用 CLI 的服务，或者你想要结构化、带类型访问的场景。
  • 让服务器列表保持精简。 每个已连接服务器的工具定义都会预先占用上下文。把你没在积极使用的服务器修剪掉；臃肿的工具列表会挤占你真正的指令。

想了解更深层的原因，参见上下文工程——治理 CLAUDE.md 的那套注意力预算逻辑，同样治理着你的工具列表。

操作 5 — 无头与 Agent SDK 流水线​

claude -p "prompt" 以非交互方式运行 Claude——没有会话、输出可解析——这是通往 CI、预提交钩子和批处理作业的大门。这就是无头 / Agent SDK 的表面。

来自官方最佳实践指南的经典“跨文件扇出”模式：

无头批量迁移

# 1. Have Claude generate the work list first, then loop:
for file in $(cat files.txt); do
claude -p "Migrate $file from React to Vue. Return OK or FAIL." \
  --allowedTools "Edit,Bash(git commit *)"
done

有两个标志承担了重活：--output-format json（或 stream-json --verbose）让结果可被机器读取，而 --allowedTools 在无人监督时精确限定 Claude 能碰什么。把它接到任何地方：

把 Claude 当作流水线中的一环

cat error.log | claude -p "Cluster these errors by root cause, output JSON" \
--output-format json | jq '.[] | select(.severity=="high")'
Watch out
  • 在把循环放到 2,000 个条目上跑之前，永远先在 2–3 个条目上测试提示词。先打磨，再放量。
  • 无人值守的运行需要把验证内建进去——一个 Stop 钩子，或者提示词里的一个测试步骤——否则你只是把“大规模产出看似合理却错误的输出”这件事自动化了。

操作 6 — 计划模式的纪律与上下文工程​

最可靠的单一质量杠杆，是把研究与执行分开。来自 Anthropic 最佳实践指南的四阶段循环：

Guided walkthrough1 of 4
  1. 进入计划模式。Claude 读取文件并回答问题，但不做任何更改。把它指向确切的目录：“读取 /src/auth 并解释会话是如何工作的。”

关于这套纪律参见计划模式，并且当差异一句话就能说清时就跳过它——计划是有开销的。它之所以管用，原因在于上下文经济：随着窗口被填满，性能会下降，所以在一个 2,000 token 的上下文里，一条 50 token 的指令，远比同样一条指令埋在 50,000 token 里更有分量。一些实用习惯：

  • 在不相关的任务之间用 /clear；一个带着更好提示词的干净会话，胜过一段又长又被污染的会话。
  • 在两次纠正都失败之后，停止纠正——/clear 然后用你学到的东西重写提示词。
  • 把研究委派给子代理，让读文件这件事发生在它们的上下文里，而不是你的。

“升级你的配置”路线​

如果你别的都不做，那就按这个顺序做这些：

Guided walkthrough1 of 6
  1. 运行 /init 得到一个起点，然后砍掉每一行通不过这个测试的内容：“删掉这行会导致 Claude 犯错吗？”一个臃肿的文件会让 Claude 忽略真正重要的规则。

精通 CLAUDE.md​

CLAUDE.md 在每次对话开始时都会加载，所以它是你能控制的频率最高的上下文——也因此最容易因塞得过满而毁掉。

放进 CLAUDE.md别放进去
Claude 猜不到的 Bash 命令任何 Claude 读代码就能找到的东西
与默认值不同的代码风格规则Claude 已经知道的标准约定
测试运行器 + 如何跑单个测试完整的 API 文档（改成放链接）
仓库礼仪（分支/PR 命名）频繁变化的信息
不显而易见的坑和环境怪癖“写干净的代码”这类空话

把它当作代码对待：当行为出错时审查它，定期修剪，并使用 @path/to/file 导入加上每个目录各自的 CLAUDE.md 文件，让 monorepo 的每一部分都只拿到与自己相关的内容。把有时才相关的知识挪进技能，让它按需加载，而不是给每一轮都增加负担。

自我检测

0/4
  1. 你需要协调一次涉及 500 个文件、并带有对抗式交叉核对的迁移。哪个工具最合适？
  2. 钩子和 CLAUDE.md 指令之间的关键区别是什么？
  3. 在无人值守的 `claude -p` 批处理运行中，哪个标志限定了 Claude 能做什么？
  4. 为什么修剪 CLAUDE.md 能改善遵循度？
高手操作回忆——翻转每张卡片
Term shown.
1 / 5
Key takeaways
  • 这种递进本身就是技能：一个 Claude → 并行子代理 → 脚本驱动的动态工作流，依据谁需要掌握计划来选择。
  • 钩子是确定性的粘合剂——保存时 lint、为停止设关卡、阻止被禁止的写入——用于那些每次都必须发生的事。
  • 把反复使用的提示词打包成斜杠命令/技能，用输出风格塑造交付方式，并让 MCP 组合保持精简（优先用 CLI）。
  • 带 --allowedTools 的无头 claude -p 把 Claude 变成 CI/流水线中的一环；对无人值守的运行务必内建验证。
  • 计划模式的纪律，加上激进的上下文经济（/clear、子代理研究、一份修剪过的 CLAUDE.md），是你拥有的最高可靠性的杠杆。

来源与延伸阅读​