用途：Minions 让当前代理变成协调者，只做元工作（协调、简报、综合），把实现、探索乃至一行修改等实际工作全部委派给后台 Codex minion（codex:codex-rescue 子代理）。git 流程与实时验证由协调者负责，minion 负责改文件并运行检查。
主要能力与机制：模式激活时由两个钩子强制执行——UserPromptSubmit 在每条提示注入协调指令（references/directive.md）；PreToolUse（Edit|Write|NotebookEdit）拒绝在协调文件（plans、memory、scratchpad、.claude）之外直接编辑，促使委派。第三个 SessionStart 钩子运行仅报告的僵尸任务清扫；等待辅助脚本 scripts/minions-wait.mjs 取代手写的“等待 minion”循环，约 1 分钟即可发现死掉的 worker，而不是卡在过期任务上。模式按项目生效，由标记文件 <project-root>/.claude/minions.on 切换（旧名 .claude/orchestrator.on 仍作为别名被接受）。
安装：skills CLI 只复制技能，不会接入 Claude Code 钩子。需运行一次安装脚本（幂等，并保留已有钩子如 ai-memory）：bash scripts/install-claude-code.sh。它会把钩子脚本、指令文本和等待辅助脚本复制到 ~/.claude/hooks/，并向 ~/.claude/settings.json 添加三个钩子注册。新加的钩子只对之后启动的会话生效。
命令：/minions [on|off|status]，$ARGUMENTS 为 on、off、status（留空表示 status），这些步骤只用 Bash 工具，不要手动编辑文件。on：解析项目根（git rev-parse --show-toplevel，回退到当前工作目录），mkdir -p <root>/.claude && touch <root>/.claude/minions.on；若为 git 仓库且未忽略该文件，则把 .claude/minions.on 追加到 <root>/.gitignore；做健康检查（只报告不修复），确认 ~/.claude/hooks/ 下 minions-directive.sh、minions-directive.md、minions-guard.sh、minions-sessionstart-sweep.sh、minions-wait.mjs 存在（.sh 可执行），且 settings.json 引用了指令与守卫脚本，缺失则提示运行安装脚本；若为 git 仓库，确保 .worktrees/ 在 <root>/.git/info/exclude 中（minion 工作树位于仓库内 .worktrees/<slug>，因为 Codex 沙箱只能写仓库根下）；确认下一条提示起模式为 ON，同一仓库的两个并行会话共享该开关。off：删除标记文件（及旧别名），若 git worktree list 显示 <root>/.worktrees/ 下有条目，仅列出为遗留 minion 工作树，不要删除（可能含未合并工作），确认下一条提示起模式为 OFF；当需要对 minions 机制本身（其钩子或沙箱无法访问的兄弟技能仓库）做元工作时关闭。status（或留空）：报告标记是否存在及 <root>/.worktrees/ 下的活动 minion 工作树，可选运行 node ~/.claude/hooks/minions-wait.mjs --sweep 暴露疑似僵尸任务。
限制：该技能只管理当前项目根下的标记文件与 .git/info/exclude 条目，从不自行创建或删除工作树。恢复失联 minion：node ~/.claude/hooks/minions-wait.mjs <jobId> 会阻塞直到任务完成（打印结果，退出 0）或 worker 疑似死亡（日志过期/pid 缺失），打印僵尸报告并以退出码 2 结束且不取消任务；--sweep 报告所有运行中任务的疑似僵尸。底层使用 Codex companion：node ~/.claude/plugins/cache/openai-codex/codex/*/scripts/codex-companion.mjs status|result <jobId>|cancel <jobId>。若健康检查发现钩子缺失，应明确说明并指向安装脚本，不要默默当作强制已生效。