# 多代理锁严格遵循此协议。 ## 需求政策在第一次编辑之前确定需求状态。状况 |需要“多代理锁” ---|--- 分支是“主”，而不是链接的工作树 |是的分支不是“主” |可选的链接的工作树（`/.git/worktrees/` 路径）|可选的分离的 HEAD（空分支输出）|可选的检测命令： * 分支：`git -C 分支 --show-current` * Git 目录：`git -C rev-parse --absolute-git-dir` * 链接的工作树：git dir 路径包含 `/.git/worktrees/` 如果回购政策比此表更严格，则遵循回购政策。 ## 所需的工作流程 1. 在第一次编辑之前映射候选文件。 2. 获取映射文件的锁。 3. 仅继续处理获取的文件。 4. 跳过锁定的文件并继续处理解锁的文件。 5. 编辑过程中的心跳。 6. 在正常完成和“EXIT”/“INT”/“TERM”时释放所有持有的锁。 ## 锁定默认值 * 锁定方式：硬 * 冲突行为：跳过锁定的文件 * 范围：仅限文件级 * 租用 TTL：180 秒 * 心跳节奏：30秒 * 所有者格式：`<代理名称>::<会话 ID>` * 强制解锁：不支持 ## 捆绑 CLI 使用“scripts/multi_agent_locks.mjs”。默认从技能目录（`skills/multi-agent-locks`）执行 npm： * `npm run locks -- <命令> [选项]` SQLite 数据库路径被硬编码为： * `assets/multi_agent_locks.db` (相对于该技能目录) ### 命令 * `获取 --owner <所有者> [--task-id ] [--repo-root <路径>] [--ttl 180] <文件...>` * `heartbeat --owner <所有者> [--ttl 180] <文件...>` * `release --owner <所有者> <文件...>` * `状态[文件...]` 当命令输出需要自动解析时传递`--json`。 ## 最小外壳图案 OWNER="codex:$$:${SESSION_ID}" 清理（）{ npm run locks --release --owner "$OWNER" -- "${LOCKED_FILES[@]}" } 陷阱清除 EXIT INT TERM # 获取，然后仅继续返回获取的文件。 npm run locks -- acquire --owner "$OWNER" --json -- path/a.ts path/b.ts ## 行为要求 * 使用标准化绝对实路径作为锁定密钥。 * 在获取期间将过期的租约视为可回收。 * 保持锁所有权严格：只有所有者可以检测或释放其锁。

多代理锁

包含技能