# Claude Agent Dispatch：基于标签驱动的 Claude Code 自主工作流系统

> Claude Agent Dispatch 是一个可复用的智能体调度系统，通过 GitHub Actions 和标签驱动的状态机，实现从问题分类到代码实现、PR 创建的全自动工作流。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-03-30T06:15:55.000Z
- 最近活动: 2026-03-30T06:30:17.456Z
- 热度: 159.8
- 关键词: Claude Code, GitHub Actions, 自动化工作流, AI辅助开发, 智能体, CI/CD, 代码审查, DevOps
- 页面链接: https://www.zingnex.cn/forum/thread/claude-agent-dispatch-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/claude-agent-dispatch-claude-code
- Markdown 来源: ingested_event

---

# Claude Agent Dispatch：基于标签驱动的 Claude Code 自主工作流系统

## AI 辅助开发的演进

AI 编程助手已经从简单的代码补全工具，发展到能够理解和执行复杂任务的智能体。Claude Code 是 Anthropic 推出的命令行 AI 助手，可以直接在终端中与开发者协作，理解代码库、执行命令、修改文件。

然而，将 Claude Code 的能力从个人开发扩展到团队协作，从临时会话扩展到自动化工作流，仍然需要大量的工程工作。Claude Agent Dispatch 项目正是为解决这一问题而生。

## 项目概述

Claude Agent Dispatch 是一个**可复用的智能体调度系统**，它将 Claude Code 的能力封装成标签驱动的 GitHub Actions 工作流，实现从问题分类到代码实现、PR 创建的全自动流程。

核心特性包括：

- **标签驱动状态机**：通过 GitHub 标签控制智能体的工作流程
- **两阶段审批**：计划阶段需要人工审核，实现安全与效率的平衡
- **工作树隔离**：支持并发处理多个问题
- **内置安全机制**：熔断器、工具限制、并发控制
- **52 个 BATS 测试**：确保系统可靠性

## 工作流程详解

### 完整生命周期

当开发者为 GitHub Issue 添加 agent 标签时，系统启动以下流程：

agent:triage -> agent:plan-review -> agent:plan-approved -> agent:in-progress -> agent:pr-open

每个阶段都有对应的状态标签，系统根据标签变化触发相应的 Actions 工作流。

### 阶段一：问题分类（Triage）

智能体首先读取项目的 CLAUDE.md 文件（项目约定文档），探索代码库结构，理解问题背景。如果需要更多信息，它会通过添加 agent:needs-info 标签并提问来澄清需求。

### 阶段二：计划制定与审核（Plan Review）

一旦问题足够清晰，智能体制定详细的实现计划，并以评论形式发布。此时 Issue 被标记为 agent:plan-review，等待人工审核。这个阶段的设计至关重要——它确保在代码被修改之前，人类开发者有机会审查和反馈计划。

### 阶段三：计划实施（In Progress）

计划获得批准后（通过添加 agent:plan-approved 标签），智能体进入实施阶段：遵循测试驱动开发（TDD）原则；每个开发周期提交一次代码；运行测试确保不破坏现有功能；完成后推送分支并创建 PR。

### 阶段四：PR 审核反馈（Revision）

当审查者请求修改时，智能体可以读取 PR 评论中的反馈，自动推送修复。这一循环可以重复直到 PR 被接受。

## 安全机制设计

自主智能体在代码库中执行操作，安全性是首要考虑。Claude Agent Dispatch 实现了多层防护：

### 熔断器机制

每个 Issue 每小时最多 8 条机器人评论（可配置），防止智能体陷入无限循环或过度活跃。

### 工具限制

智能体只能使用明确允许的工具。默认禁用 sudo、网络访问、强制推送等危险操作。通过 AGENT_ALLOWED_TOOLS 和 AGENT_EXTRA_TOOLS 精细控制。

### 行为者过滤

机器人自身的操作不会重新触发工作流，防止循环触发导致的资源浪费。

### 并发控制

每个 Issue/PR 同时只能运行一个智能体任务，通过 GitHub Actions 的并发组实现。

### 超时保护

每个任务都有可配置的超时时间（默认 3600 秒），防止卡住的会话无限占用资源。

## 部署模式

Claude Agent Dispatch 提供两种部署模式，适应不同需求：

### 引用模式（Reference）

项目中的工作流文件很薄，通过 @v1 标签调用上游可复用工作流。自动获得更新和改进，适合希望开箱即用的团队。

### 独立模式（Standalone）

所有脚本、提示词和工作流都复制到项目仓库的 .agent-dispatch/ 目录。完全控制，无上游依赖，适合需要深度定制的团队。

## 项目适配机制

Claude Agent Dispatch 通过以下机制适应不同项目：

### CLAUDE.md

项目的约定文件，包含代码风格指南、架构概述、测试策略、特殊注意事项。智能体在处理任何 Issue 之前都会读取这个文件，确保其行为符合项目规范。

### 自定义提示词

通过 AGENT_PROMPT 配置项，可以覆盖默认提示词，添加项目特定的指令。

### 测试门禁

设置 AGENT_TEST_COMMAND（如 npm test），要求智能体在创建 PR 之前必须通过测试。这是防止回归的重要防线。

## 与官方方案的对比

Anthropic 官方提供了 claude-code-action，这是一个轻量级的 GitHub Action，用于响应 @claude 提及或简单的 PR 交互。

Claude Agent Dispatch 则是一个**完整的自主智能体生命周期系统**：标签驱动的完整状态机、两阶段计划/实施流程、支持并发 Issue 处理、预获取 Gist 和附件、熔断器/工具限制/超时等安全机制、可配置提示词/工具/测试门禁、定期清理分支/Gist/工作流运行。

两者并非竞争关系，而是互补：claude-code-action 适合快速交互，Claude Agent Dispatch 适合完整的自动化工作流。

## 实践建议

对于希望引入 AI 辅助开发的团队，建议：

1. **从 CLAUDE.md 开始**：即使没有使用智能体，整理项目约定也是有益的
2. **小规模试点**：选择几个合适的 Issue 类型进行试点
3. **重视计划审核**：这是安全与效率平衡的关键
4. **设置测试门禁**：确保 AI 生成的代码不破坏现有功能
5. **持续优化提示词**：根据实际使用情况调整智能体行为

## 项目意义

Claude Agent Dispatch 代表了 AI 辅助开发的一个重要方向：**从工具到工作流**。它不仅提供了一个技术方案，更展示了一种人机协作的新模式——AI 处理繁琐的实现工作，人类专注于需求澄清、计划审核和质量把关。

对于希望提升开发效率、减少重复劳动的团队，这是一个值得深入研究和尝试的项目。