Playbook：让Claude Code自主处理GitHub Issues的轻量级编排器

Playbook是基于Claude Code CLI的AI Agent编排系统，通过标签驱动的工作流自动分配编码、测试、审查任务，实现GitHub Issues的端到端自动化处理。它作为编排层调度多个Claude Code实例协作，解决传统人工驱动模式无法充分利用AI 24/7可用性的问题，让开发者只需审查累积变更即可完成开发流程。

随着Claude Code等AI编程助手的成熟，开发者开始探索将其从交互式会话扩展到自主工作流程。传统人工驱动模式（打开IDE、启动AI助手、描述需求、审查代码）虽有效，但无法充分利用AI的全天候可用性。Playbook作为编排层诞生，负责调度、协调、监控多个Claude Code实例，让它们像团队一样协作处理软件开发任务。

Playbook以GitHub标签为触发器，状态标签为工作流引擎。流程如下：开发者为Issue添加ai-ready标签→定时任务（每10分钟）检测并启动编码Agent→编码Agent从ai/dev分支创建功能分支，实现需求后提交Draft PR并标记ai-testing→测试Agent运行测试套件，通过后标记ai-review-needed→审查Agent进行代码审查，确认后标记ai-pr-ready并自动合并到ai/dev→开发者审查ai/dev分支的累积变更，一键合并到main分支。全程无需人工干预。

Playbook采用专门化Agent分工模式，权限分层确保安全：

• 编码Agent：拥有完整写权限，负责理解需求、设计实现、编写代码、创建PR（能力最强、风险最高）；
• 测试Agent：受限权限（只读代码、执行测试、修改测试文件），验证实现是否符合需求；
• 审查Agent：只读权限，审查PR质量，防止自我审查偏见。 权限分层设计可捕获编码Agent的错误，保障流程安全性。

技术实现：基于Python架构，核心组件包括：

• 编排器（定时扫描GitHub Issues，调度Agent）；
• 配置系统（支持多仓库、并发限制等灵活配置）；
• GitHub客户端（封装API处理标签、PR等操作）；
• Agent模块（提示词模板与命令构建逻辑）；
• 状态管理（记录Agent状态防止重复启动）；
• 通知系统（Slack集成发送关键事件）。 安全防护：分支隔离（工作在ai/dev分支）、并发控制、超时机制（编码60分钟/测试30分钟/审查30分钟）、重试上限（3次循环）、文件变更限制（单次最多10个文件）、工具权限限制（通过--allowedTools参数）。

部署条件：Python 3.11+、已认证的Claude Code CLI、GitHub个人访问令牌、可选Slack webhook。 配置步骤：克隆仓库→设置环境变量→编辑config.yaml添加目标仓库→创建ai/dev分支→配置GitHub标签→添加CLAUDE.md项目说明→设置GitHub Actions。 运行方式：通过crontab设置定时任务（每10分钟运行编排器，早晚发送活动摘要）。 使用体验：实现异步开发，开发者可睡前添加ai-ready标签，夜间系统自动完成编码/测试/审查/合并；次日审查ai/dev到main的PR并合并。适合跨时区团队、批量标准化任务、快速原型开发。

局限：适合边界清晰、需求明确、测试覆盖良好的任务；复杂任务（设计决策、架构变更、外部协调）需人工介入；需接受AI代码审查负担，建立团队信任机制与合并标准。 展望：代表AI辅助开发从交互式助手到自主工作流的方向，未来类似编排工具将更普遍。项目处于早期阶段，但架构清晰实用，是探索AI自主开发工作流的值得关注的起点。