SuperAPI AI 工具集

workspace-orchestration

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:在基于 docko 的持久槽位(slot)工作区中协调多会话协作,适用于工作涉及 slots/ 目录文件或用户询问工作区协调时。

主要能力:查看状态、认领与释放槽位、维持长任务心跳、在多个应用间选择槽位池、按偏好指定槽位、槽位繁忙时创建托管克隆、以及把独立启动的会话委派给槽位所有者。

使用方式:先运行 /dock-status 或 docko status --brief(docko 会自动向上寻找工作区根目录,在槽位内也可用;仅在工作区外才需 --root <workspace>)。每次认领、心跳、释放都要传 --session "$DOCKO_SESSION_ID",该变量由 SessionStart 钩子导出。让 docko 选槽位时用 docko slot acquire --session "$DOCKO_SESSION_ID" --branch <branch> --task "<task>" --brief,选择为轮询,从该应用上次认领的槽位之后开始;多应用工作区加 --application <id>,指定槽位加 --prefer <slot-id>。已知确切槽位时用 docko claim --session "$DOCKO_SESSION_ID" --resource slot --id <slot> --branch <branch> --task "<task>"。长任务用 docko heartbeat --session "$DOCKO_SESSION_ID" --resource slot --id <slot> 保持认领,完成后用 docko release --session "$DOCKO_SESSION_ID" --resource slot --id <slot> 释放。已安装斜杠命令时优先使用 /dock-status、/dock-claim、/dock-heartbeat、/dock-release、/dock-doctor。

规则与限制:从根目录工作,代码编辑在 slots/* 内进行。若 $DOCKO_SESSION_ID 为空,须先通过 docko session list --brief 或 docko session current 取得真实会话 id,绝不能用空 --session 或编造 id 执行认领或心跳。branch 仅为认领元数据,docko 不会执行 git checkout。认领以槽位为范围,两个会话不能共享同一槽位,一次认领不保留分支、PR 或文件。父会话已拥有槽位时应复用其权限。用 Agent 工具启动的子代理共享父会话 id,自动继承认领;单独启动的 claude 进程需用 docko delegate --session <owner> --child-session <child> --resource slot --id <slot> 委派。遇到 AMBIGUOUS_SESSION 时按错误提示的 suggested_command 处理,或用显式 --session <id> 重试,不要擅自结束已有会话。写入被阻止时阅读拒绝信息,其中会给出槽位、原因和修复命令。所有槽位繁忙且用户已同意回退时,可在 docko slot acquire 加 --clone-when-busy。docko 无法运行时检查 DOCKO_BIN,仍失败则停止并告知用户。日常工作中不要逐个检查槽位,也不要用 docko/registry.json 替代 CLI,应使用 docko status --brief --claimed。