AI LABS 出品：探索 Claude Code 全新智能代理框架

在AI领域，开发节奏从未停止。Anthropic 几乎每月都会发布新的模型，这些新模型带来的新特性和新质量正在彻底改变我们对AI编码的认知。最近，Claude Code 发布了一项新功能，催生了一个全新的智能代理框架，极大地提升了开发者的工作效率，实现了 AI 驱动工作流的自动化。

这个被称为“Claude Code 工作流：子代理与自动化编码”的视频深入探讨了如何利用子代理（sub-agents）、斜线命令（slash commands）和插件（plugins）来自动化 AI 编码。通过 AI 代理和 Cursor，这个系统能够通过 工作树（worktrees） 和 GitHub 集成来处理任务规划、代码审查和问题解决。

一、核心理念与架构：让每一次工作都更轻松

这个新框架的核心理念非常简单：每一个工程工作单元都应该让下一个单元变得更加容易。

这个工作流利用了 Claude Code 刚发布的新功能：可定制的插件。插件本质上是斜线命令、子代理、MCP 服务器和钩子的集合。开发者可以创建插件并与团队或其他人共享，这提供了一种标准化共享配置的方式。

安装步骤 安装该框架只需两步：首先运行 Claude 并添加 Marketplace 插件，然后运行特定命令安装实际的插件。

该框架的智能代理结构严重依赖子代理，并利用 Claude Code 的知识持久性功能来记录经验教训，以便后续使用。

二、详细工作流解析：四大阶段实现闭环迭代

整个工作流由多个步骤和工具构成。以下是关键的阶段划分：

1. 计划阶段 (Plan Stage)

在计划阶段，您需要提供产品需求文档（PRD）和您希望构建的详细信息。

• 执行命令： 使用 plan 斜线命令。
• 输入内容： 提供项目概览（例如，作者希望构建一个 GitHub 仓库研究管理器）和所需的技术栈（例如 Next.js 和 Fast API）。
• 子代理启动： plan 命令会启动多个子代理，包括研究代理（research agent）、最佳实践代理（best practices agent）和框架代理（framework agent）。
• 研究示例： 框架研究代理运行了 6 分钟，使用了大约 50k tokens 来研究框架。
• 成果产出： 代理会创建一个新的 工作树，并在其中创建一个新的 GitHub Issue 和 Markdown 文件，汇编所有研究细节，并详细说明需要创建哪些文件。它还会根据文档和概述的功能，创建分阶段的执行计划（例如，一个项目被分成了六个阶段）。

值得注意的是，规划完成后，它不会将所有细节写入 Markdown 文件，而是将其写入 代理的待办事项（to-do）工具中，并将其设置为任务。

2. 委托/执行阶段 (Delegate/Work Stage)

此阶段用于执行规划好的任务。

• 执行命令： 使用 delegate 命令，并通过 work 命令逐一执行创建的任务。
• 隔离执行： 当运行 work 命令时，它会为仓库管理器创建一个独立的 Git 工作树，并在其中开始工作。
• 任务管理： 它会逐一执行所有阶段（例如，设置数据库、后端和前端）。一旦一个阶段完成，它会暂停并展示成果，允许用户在继续之前进行审查。
• 上下文持久性： 一个有趣的发现是，即使在会话被压缩（compacting）之后，待办事项（to-dos）仍然会跨会话持久存在。任务列表被存储在待办事项工具中，而不是分散的 Markdown 文件中，而 GitHub Issue 文件则作为上下文基础，并随着每个阶段的完成而不断更新。
• 上下文维护： 在实施新阶段之前，运行 context 命令来检查上下文剩余量非常重要，这有助于避免在中途需要压缩会话，从而维持连续性。

3. 评估/审查阶段 (Assess/Review Stage)

此阶段主要用于审查所编写的代码是否正确。

• 执行命令： 运行 review 命令，这会触发另一个带有自定义上下文的命令。
• 子代理并行审查： 它会启动多个子代理并行运行，审查代码库的特定方面，例如：Python、TypeScript、甚至 Rails 代理。
• 审查范围： 这些代理会验证语言特定的正确性、安全性、性能、架构和数据完整性。
• 问题列表： 审查完成后，代理会根据优先级列出所有发现的关键问题。

4. 分类/解决与代码化阶段 (Triage/Resolve/Codify)

这是框架实现持续迭代和学习的关键。

• 分类 (Triage)： 运行 triage 命令，询问用户是否希望实施这些已识别的问题修复。如果选择修复，这些问题会被添加到 to-dos 文件夹中，每个问题都作为单独的 Markdown 文件列出。这些 Issue 文件详细记录了哪里出了问题以及如何修复。
• 解决 (Resolve)： 运行 resolve 命令可以实现并行执行。它会分析所有待办事项，自动构建依赖关系图，以确定哪些任务可以同时完成。
• 代码化与循环 (Codify & Loop)： 完成审查后，框架进入 codify 步骤，将所有经验教训记录到 Issue 文件中。随后，工作流会循环回 计划 和 委托 阶段，从而实现持续迭代和新功能的添加。
• 最终提交： 一旦所有工作完成，框架会将您的更改提交到在线的 GitHub 仓库。

三、深入分析与洞察

1. 工作树：隔离与安全是现代编码的基石

该框架的一个突出优势是所有工作都在工作树中进行，这意味着一切都在隔离的环境中运行。您添加的每一个新功能都会创建一个新的工作树，并同时提出一个新的 GitHub Issue。这对于向现有代码库添加新功能特别有用，前提是您对代码库有充分整合的上下文。

2. 上下文工程的挑战与辅助工具

即使是智能代理框架，对需求（requirements）的清晰定义仍然至关重要。视频中提到，由于需求不明确，导致某些功能（如导出按钮）未能正确实现，这是一个需求错误。

为了更好地管理和理解上下文，作者还探索了使用 Git Ingest Library。这是一个开源工具，可以将 Git 仓库转换为 LLM 可读格式，从而能够向 Claude 提出关于代码库如何运作的详细问题。

此外，在处理多个组件和页面时，清晰且一致的命名约定变得极其重要。

3. 与 BMAD 方法的对比分析

该框架与 BMAD 方法（一种专注于详细规划的开发方法）存在差异。BMAD 方法在规划上更为彻底，可以避免因需求不当而导致的错误。然而，BMAD 对于小型项目来说可能过于详细且耗时。

相比之下，Claude Code 的新框架效率更高，部分原因在于其内置的待办事项系统。虽然它并没有提供“彻底革新或开创性”的新东西，但其最大的优势在于它是一个插件，设置简单且使用方便。它有效地将先进的代理结构和工作流程整合到开发者日常使用的工具中。

总而言之，这个新的 Claude Code 智能代理框架通过子代理的并行执行、知识的持久化记录以及工作树的隔离环境，为开发者提供了一个更智能、更快速、且具有更深上下文持久性的 AI 驱动工作流。

---

原始视频：https://youtu.be/xhrqmAWI_cw?si=5VS3Jp4KlkKvuZbf

中音文字幕：