用途:为共享任务目录提供通用协调机制,防止 Manager 与 Worker 同时访问或修改同一任务工作区时发生冲突。典型场景是 Worker 将 git 等操作委派给 Manager,Manager 修改 Worker 工作区期间 Worker 也可能在改文件。
主要能力:任务目录结构为 tasks/{task-id}/,含 workspace/(共享代码工作区)、notes/(Worker 笔记、plan.md、memory,不同步)、meta.json(元数据)和 .processing(处理中标记)。标记为 JSON,字段包括 processor(manager 或 worker 名称)、started_at、expires_at(默认 15 分钟,可配置)和可选的 operation。标记到期自动失效,避免进程崩溃后死锁。
使用方式:修改任务目录前先同步,再检查标记,安全则创建标记、执行修改、移除标记、最后回传同步。命令保持原样: mc mirror "${HICLAW_STORAGE_PREFIX}/shared/tasks/${task_id}/" "/root/hiclaw-fs/shared/tasks/${task_id}/" bash /opt/hiclaw/agent/skills/task-coordination/scripts/check-processing-marker.sh "$task_id" bash /opt/hiclaw/agent/skills/task-coordination/scripts/create-processing-marker.sh "$task_id" "manager" bash /opt/hiclaw/agent/skills/task-coordination/scripts/remove-processing-marker.sh "$task_id" mc mirror "/root/hiclaw-fs/shared/tasks/${task_id}/" "${HICLAW_STORAGE_PREFIX}/shared/tasks/${task_id}/" --overwrite 检查脚本退出码 0 表示无标记或已过期可继续,1 表示处理中不可修改。创建脚本参数为 task-id、processor-name 和可选 timeout-mins。
集成与限制:被 git-delegation-management 和 git-delegation 使用。最佳实践包括先同步、先检查再创建、完成后及时移除、依赖过期机制处理崩溃、绝不修改有活动标记的目录。其他平台或收费信息暂未提供。