编写智能体自动派发模式 PRD 文档

[black-pwq]

问题

当前 HALF 平台缺少一份清晰的 PRD 文档，用于定义智能体自动派发（Auto-Dispatch）功能的产品需求与技术边界。

现有任务派发完全依赖人工操作：系统生成 prompt 后，由操作人手动复制、粘贴给 agent，再等待 agent 将结果写回 git 仓库。对于支持 API 调用的 agent，每次手动介入显著降低效率，无法实现无人值守的连续执行。在没有统一文档的情况下，后续实现容易出现执行模式边界不清、凭证管理方式不统一、自动与手动流程耦合等问题。

建议改动

新增一份 PRD 文档，描述智能体自动派发功能，至少覆盖：

• 智能体执行模式的定义（手动 / 自动）及各层级职责
• 执行模式配置在 agent 类型层，API 凭证（api_key、base_url）存储在 agent 实例层
• Agent 自动模式的配置流程与界面变更（类型层切换模式，实例层填写凭证）
• 自动派发的触发条件与 DAG 依赖执行顺序
• 项目与 agent 执行模式的匹配规则（纯手动 / 纯自动项目）
• API 凭证的安全存储与脱敏要求
• 自动派发失败的处理行为（任务进入 needs_attention、错误记录）
• 向后兼容策略（存量 agent 和项目不受影响，默认手动模式）
• 可观测性要求（TaskEvent 日志记录，不含 API Key）

验收标准

• 新增 PRD 文档，明确描述智能体自动派发的完整功能需求
• 文档中区分执行模式（类型层）与 API 凭证（实例层）的存储职责
• 文档中定义自动派发触发条件、DAG 顺序执行逻辑和失败处理策略
• 文档中包含安全性要求（API Key 加密存储、响应脱敏）
• 文档中明确项目执行模式匹配规则及混合模式限制
• 文档内容足够指导后续代码实现

前置 Discussion

待补充。如该流程涉及 API 凭证管理、agent 执行隔离或任务调度模型，应先补充相关 Discussion 链接。

为什么重要

该 PRD 可以为后续实现提供统一的产品和技术边界，避免直接编码后出现执行模式不一致、凭证共享风险、自动与手动流程相互干扰等问题。

它也有助于维护者评估该能力是否符合项目方向，并提前确认安全边界（API Key 存储与脱敏）和人工介入机制（自动失败后的 needs_attention 处理）。

补充信息

新功能目标流程：

1. 用户在智能体类型配置中开启自动模式
2. 用户在智能体实例配置中填写专属 API 凭证
3. 将自动模式 agent 实例加入自动模式项目
4. 计划 finalize 后，系统按 DAG 依赖顺序自动触发就绪任务
5. 系统调用外部 AI API 执行任务
6. 执行成功后任务状态变为 completed，触发下游任务；失败则进入 needs_attention