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

Claude Agent Dispatch 是一个可复用的智能体调度系统，通过 GitHub Actions 和标签驱动的状态机，实现从问题分类到代码实现、PR 创建的全自动工作流。它解决了将 Claude Code 能力从个人开发扩展到团队协作、临时会话转为自动化流程的工程问题，核心特性包括标签驱动状态机、两阶段审批、工作树隔离、多层安全机制等，代表了 AI 辅助开发从工具到工作流的演进方向。

AI编程助手已从简单代码补全工具发展到能执行复杂任务的智能体，Claude Code 作为 Anthropic 推出的命令行AI助手，可在终端与开发者协作理解代码库、执行命令、修改文件。但将其能力扩展到团队协作和自动化工作流仍需大量工程工作，Claude Agent Dispatch 项目正是为解决这一问题而生。

Claude Agent Dispatch 是可复用的智能体调度系统，将 Claude Code 能力封装为标签驱动的 GitHub Actions 工作流。核心特性包括：

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

系统工作流程由GitHub Issue标签触发，完整生命周期为：agent:triage → agent:plan-review → agent:plan-approved → agent:in-progress → agent:pr-open。

• Triage阶段：智能体读取CLAUDE.md文件，探索代码库，若需更多信息则添加agent:needs-info标签提问。
• Plan Review阶段：制定详细实现计划并发布评论，标记为agent:plan-review等待人工审核。
• In Progress阶段：计划批准后，遵循TDD原则，每周期提交代码、运行测试，完成后推送分支并创建PR。
• PR Revision阶段：读取PR评论反馈，自动推送修复，循环至PR被接受。

为确保自主智能体操作安全，系统设计了多层防护：

• 熔断器机制：每个Issue每小时最多8条机器人评论（可配置），防止无限循环。
• 工具限制：仅允许明确工具，禁用sudo、网络访问等危险操作，通过AGENT_ALLOWED_TOOLS精细控制。
• 行为者过滤：机器人自身操作不触发工作流，避免循环。
• 并发控制：每个Issue/PR同时仅运行一个任务。
• 超时保护：任务超时时间可配置（默认3600秒），防止资源占用。

系统提供两种部署模式：

• 引用模式：工作流文件调用上游可复用工作流，自动获得更新，适合开箱即用。
• 独立模式：所有脚本、提示词复制到项目.agent-dispatch/目录，完全控制无依赖，适合深度定制。 适配机制包括：
• CLAUDE.md：项目约定文件，智能体处理Issue前读取，确保符合规范。
• 自定义提示词：通过AGENT_PROMPT覆盖默认提示，添加项目特定指令。
• 测试门禁：设置AGENT_TEST_COMMAND，要求智能体创建PR前通过测试。

Anthropic官方的claude-code-action是轻量级GitHub Action，响应@claude提及或简单PR交互；Claude Agent Dispatch则是完整的自主智能体生命周期系统，具备标签驱动状态机、两阶段流程、并发处理、多层安全机制等特性。两者互补：前者适合快速交互，后者适合完整自动化工作流。

实践建议：

1. 从CLAUDE.md开始，整理项目约定；
2. 小规模试点，选择合适Issue类型；
3. 重视计划审核，平衡安全与效率；
4. 设置测试门禁，防止代码回归；
5. 持续优化提示词，调整智能体行为。

项目意义：代表AI辅助开发从工具到工作流的重要方向，展示人机协作新模式——AI处理繁琐实现，人类专注需求澄清、计划审核和质量把关，助力团队提升效率、减少重复劳动。