Claude Code 工作流指南

Claude Code 的价值不只是帮你写代码，而是用文件系统、Sub-agents、Slash Commands、MCP 和 Skills 搭建可执行的工作流。

很多人第一次理解 Claude Code，是把它当作 AI 编程工具。

这没有错，但太窄了。

Claude Code 真正重要的地方在于：它是一个通用 Agent 工作环境。只要你的任务可以被文件、命令、规则和工具描述，它就不只适合编程，也可以用于研究、写作、知识管理和个人 AI OS。

Claude Code 工作流的基本组件

Claude Code 工作流通常由五个组件组成。

第一是项目文件夹。Claude Code 需要进入一个真实目录，读取文件、理解结构、写入结果。

第二是规则文件。比如 CLAUDE.md 或项目说明，用来告诉 Agent 项目背景、输出标准和注意事项。

第三是 Slash Commands。它们把重复任务封装成命令，比如周报、文章拆解、观点审查、资料整理。

第四是 Sub-agents。它们把复杂任务拆给不同角色处理。

第五是 MCP 和 Skills。MCP 负责外部工具，Skills 负责专业 SOP。

最小工作流示例

一个最小 Claude Code 工作流可以这样设计：

project/
  CLAUDE.md
  commands/
    weekly-report.md
    new-angle.md
  agents/
    researcher.md
    reviewer.md
  input/
  output/

CLAUDE.md 说明项目是什么、文件夹如何使用、输出标准是什么。

commands/ 存放重复任务。

agents/ 存放特定角色。

input/ 存原始资料。

output/ 存最终结果。

这个结构不复杂，但已经能让 Claude Code 从聊天工具变成工作流引擎。

Slash Commands 适合做什么

Slash Commands 适合封装高频、重复、边界清晰的任务。

比如：

• 总结一周剪藏资料。
• 从一篇文章中提炼新观点。
• 对当前选题做反方审查。
• 把一组笔记整理成文章大纲。
• 根据指定格式生成发布草稿。

它的价值不是省几个字，而是把流程标准化。每次你输入同一个命令，Claude Code 都按同一套 SOP 工作。

Sub-agents 适合做什么

Sub-agents 适合把复杂任务拆成角色。

例如写作工作流可以拆成：

• researcher：搜集资料。
• writer：生成初稿。
• reviewer：审查逻辑和事实。
• editor：优化表达。

在 Claude Code 中，Sub-agents 更适合轻量委托。它可以显著提升复杂任务的组织性，但还不完全等同于独立的多 Agent 编排系统。

真正复杂的多 Agent 工作流，通常还需要更明确的主 Agent、验收标准、任务状态和结果回收机制。

MCP 的位置

MCP 让 Claude Code 调用外部工具。

比如：

• 访问 Obsidian。
• 调用搜索工具。
• 读取文件系统。
• 使用浏览器。
• 查询数据库。
• 调用 Prompt House 或其他工具。

没有 MCP，Claude Code 主要在项目文件夹里工作。有了 MCP，它能接入更大的外部环境。

Skills 的位置

Skills 适合封装专业能力。

如果 Slash Commands 是「做某件重复任务」，Skills 更像「掌握某种专业方法」。

比如 Super Writer 不是一个命令，而是一套写作 SOP。Super Analyst 也不是一次提示，而是一套分析方法、框架和工具组合。

在 Claude Code 工作流里，Skills 可以让 Agent 在需要时加载专业能力，而不是每次都把方法论写进提示词。

推荐工作流：生成、审核、修改

一个常见模式是：

1. 主 Agent 理解目标。
2. researcher 补充资料。
3. writer 生成初稿。
4. reviewer 打分并指出问题。
5. writer 根据反馈修改。
6. 达到标准后写入输出文件。

这个流程的关键是「验收标准」。

如果没有标准，Agent 很容易产出看似完整但其实松散的内容。你必须告诉它：什么叫好，什么叫不合格，失败时如何修正。

Claude Code 和 AI OS

Claude Code 可以成为个人 AI OS 的执行框架。

在这个结构里：

• 文件夹是内存和硬盘。
• Slash Commands 是应用。
• Skills 是专业能力包。
• MCP 是外设接口。
• Sub-agents 是任务分工。
• Claude Code 是运行环境。

这就是为什么 Claude Code 不应该只被理解为编程工具。

常见误区

第一个误区是把 Claude Code 当聊天框使用。

如果你只是不断对话，而不把规则、命令、结果写进文件，系统就不会积累。

第二个误区是让一个 Agent 一口气做完所有事。

复杂任务应该拆成流程，让 Agent 有明确中间结果和检查点。

第三个误区是只写提示，不设计环境。

真正稳定的 Claude Code 工作流，靠的是文件结构、命令、工具、Skills 和验收机制，而不是某一句神奇提示词。