external-task-management 是一套工作流技能,要求在智能体执行过程中优先使用外部任务管理 CLI 跟踪工作项,而不是内置 todo 系统。当前默认工具为 bd。
用途与主要能力:用外部 CLI 统一记录每个有意义的工作项,保持状态可被外部查询。技能定义了规范状态映射:todo(已识别未开始)、in_progress(进行中)、blocked(因依赖受阻)、done(完成并验证),即使 CLI 实际标签不同也按此逻辑对应。
使用方式:先检查工具是否可用,命令为 command -v bd;缺失时安装,macOS(Homebrew)用 brew install beads,Linux(Cargo)用 cargo install beads;随后运行 bd --help 与 bd ready 初始化并验证。工作开始时、每个重要里程碑后以及最终回复前都要创建或更新外部任务;任务标题简短且以行动为导向;交接说明尽量写入任务条目而非临时对话上下文。
规格溯源:实现规格产物的任务须用 --external-ref <ID> 标记来源规格(不可变,如 --external-ref PRD-003),并用 --labels spec:<ID> 打可变标签,跨规格影响时用 bd label add <task-id> spec:PRD-007 追加;不同计划间的任务用 bd dep relate 建立双向链接;可用 bd list --label spec:PRD-003 查询某规格的全部工作。有效前缀包括 VISION-NNN、EPIC-NNN、PRD-NNN、SPIKE-NNN、ADR-NNN。
观察者模式:维护可外部查询的紧凑状态视图,明确标出阻塞项及其所需下一步动作,用一致的标签便于按流、负责人或阶段过滤。
限制与回退:若无法安装或环境中不可用 bd,应在工作笔记中记录失败原因,回退到工作目录下中立的文本任务台账(JSONL 或 Markdown 清单),继续使用同一状态模型并保持外部可见性,并标注一旦 SPIKE-001 选定首选 CLI 即替换该回退方案。默认 CLI 可能在 SPIKE-001 外部任务 CLI 评估完成后变更。其他收费、平台或效果信息暂未提供。