智能体循环与任务分发指南
这是一种基于 GitHub Issue,通过智能体循环 (run_agent_loop.bat) 执行任务的便捷方法。
工作流程
- 登记问题:在 GitHub 上将需要解决的问题或待办事项登记为 Issue。(例如:
#123 登录错误分析) - 请求创建任务:向正在对话的 AI 智能体提出如下请求:
"请根据 GitHub Issue #123 的内容,在
giipdb/dispatch中创建任务文档。角色请设为 Developer。" - 智能体处理:智能体读取 Issue 内容并生成
giipdb/dispatch/TASK_[日期]_[ID].md文件。 - 自动执行:当前正在运行的智能体循环 (
run_agent_loop.bat) 会检测到新文件并开始工作。
批量任务分发(利用编排器 Orchestrator)
当有多个 Issue 时,可以将整体管理交给编排器 (Orchestrator)。
- 请求示例:
"编排器,请检查 GitHub 目前所有打开的 Issue,并将其作为
giipdb/dispatch任务文件分发给合适的负责人(Developer, Error Analyst 等)。" - 效果:编排器分析各个 Issue,将其拆分为独立的任务文件,并指定最合适的角色来创建文件。
核心变更
- 任务路径:
.agent/dispatch(隐藏) →giipdb/dispatch(可直接访问的上级文件夹) - 同步方式:从复杂的自动脚本简化为用户根据需要向智能体请求的方式。
帮助
您也可以参考 giipdb/dispatch/TASK_TEMPLATE.md 文件手动编写任务。当任务文件的 Status 为 Pending 时,智能体会接手任务。
故障排除
| 症状 | 原因 | 解决 |
|---|---|---|
| 创建了任务文件但智能体未接手 | 任务的 Status 不是 Pending | 将任务文件的 Status 设为 Pending |
| 新任务未被检测到 | run_agent_loop.bat 循环未在运行 | 先启动智能体循环,再创建任务 |
| 创建的任务未被识别 | 文件放在了旧路径 .agent/dispatch(隐藏) | 在 giipdb/dispatch 路径下创建任务文件 |
| 编排器分配了不合适的角色 | Issue 内容含糊,难以判断角色 | 请求时明确指定负责角色(Developer、Error Analyst 等) |