快速修复
# 一键:在正确的项目根目录重跑 /omc-setup,再检查规则是否加载
/omc-setup
在项目根目录执行(CLAUDE.md 按项目生成)。
你会遇到什么
配置了多 Agent,但会话里任务没有被自动委托/认领。多智能体配好了,却不干活。
本文路径:快速修复(30 秒一段命令)→ 一步步排查(可跳读)→ 原理与变体(症状/原因/证据)。赶时间直接跳到「快速修复」。
为什么会这样
| 原因 | 说明 |
|---|---|
| CLAUDE.md 没加载 | 委托规则在 CLAUDE.md 里,Claude Code 没加载它 |
| 插件装错目录 | 装到了别的项目目录,规则不在当前项目 |
自动委托不是"常驻进程",而是会话启动时读一次规则:Claude Code 启动时会按项目根目录加载 CLAUDE.md,把里面的委托规则(哪些任务交给哪个子 Agent)注册进会话。这个加载是静默的——失败了不会报错,只会表现为"规则没生效"。所以"配了不干活"的排查方向只有两个:规则文件在不在当前项目、内容有没有被识别。
这也解释了为什么"在别的目录跑过 setup"等于没配:规则是按项目生成的,换目录就换了一套。
一步步来
1. 检查 CLAUDE.md 是否加载 — 排查
会话里看 /context 是否包含 OMC 委托规则。
2. 在正确的项目根目录重跑 /omc-setup — 必做
/omc-setup
CLAUDE.md 按项目生成,必须在目标项目根目录跑。
3. 确认委托规则写法 — 必做
与 v5 文档一致(guidance schema contract,见 AGENTS.md)。
怎么确认修好了
会话上下文包含委托规则(预期形态):
/context → 输出包含 OMC 委托规则
任务提交 → 自动委托/认领正常其它环境的表现
| 环境 | 说明 |
|---|---|
| CLAUDE.md 未加载 | 项目根目录重跑 /omc-setup(CSDN 2026-03) |
| 插件装错目录 | 装到目标项目 |
| 规则写法 | 与 v5 guidance schema 一致 |
| 未实测项 | 插件形态需 Claude Code 会话,本市场未实测(CLI 形态纯命令面,) |
症状
配置了多 Agent,但会话里任务没有被自动委托/认领。
原因
Claude Code 没加载 OMC 的 CLAUDE.md(委托规则在 CLAUDE.md 里);或插件装到了别的项目目录。
解法
- 检查 CLAUDE.md 是否加载:会话里问/看
/context是否包含 OMC 委托规则。 - 在正确的项目根目录重跑
/omc-setup(CLAUDE.md 按项目生成)。 - 确认委托规则写法与 v5 文档一致(guidance schema contract,见 AGENTS.md)。
验证证据
- 网页案例:CSDN(智能体未自动委托 → CLAUDE.md 未加载检查,2026-03)。
- 本市场实测:CLI 形态不依赖 CLAUDE.md(纯命令面,);插件形态需 Claude Code 会话,未实测。
适用工具 (1)
本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。
oh-my-claudecode来源与证据
收录 验证 ✓ 实测验证适用 1 工具
方案含本地实测或来源可复核的解法;未实测项已在文中如实标注。
← 多智能体编排 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡