men （门）

快速上手

本文介绍从克隆仓库到完成第一个任务的完整流程：配置运行环境、启动本地站点，并通过 /ultrawork、/verify、/hyperplan 三个命令驱动 men（门）Agent 团队完成一键编排、独立验收与复杂项目规划。

前置条件

协议计数说明：ultrawork.md 共 10 步：第 1–9 步为编排闭环，第 10 步 LEARN 触发学习回路（M7 加入）。

克隆与启动

前置：Node.js ≥ 18、已安装 OpenCode。推荐用 npm 一步安装，无需 clone 仓库：

bash
npx @cgartlab/men
opencode
  • 方式 A：npm 一步安装（首选） — 在任意目录运行 npx @cgartlab/men，自动 scaffold 运行时资产（opencode.json / .opencode/ / scripts/ / config/ / knowledge/）→ 安装 .opencode/ 依赖 → 从 .env.example 生成 .env → 端到端验证。首次 npx 会询问 Ok to proceed? (y)，输入 y（或 npx -y 跳过确认）。当前目录若已是 men 仓库根则幂等跳过复制，就地安装。
  • 方式 B：Git 仓库（备选） — cd 进入 men 仓库目录后直接运行 opencode，会自动读取 opencode.json 并把 men 设为默认 agent；首次或修改配置后需重启 OpenCode（/quit 后重开）。
  • 任意目录生效 — 加 --global 将 agents/commands/skills/plugins 部署到 ~/.config/opencode/，合并全局 opencode.json 仅设置 default_agent: men（不触碰 mcp 与 plugin，由 CC Switch 统一管理）；--global-remove 幂等还原原配置。
  • .env 说明 — 安装器生成的 .env 内全是占位符，仅用于知识检索（Embedding）与内网数据源，基础对话不需要填写。

来源：scripts/install.mjs · docs/guide/quickstart.md

第一个任务

日常绝大多数任务用 /ultrawork 一键编排，men 自动完成意图分诊 → 拆分 → 分发 → 验证 → 汇总：

text
/ultrawork 查一下本周 AI 领域最新发布的开源模型有哪些
  • search 类（单路执行） — 例：查最新开源模型 → men 判定 search 意图，直接 spawn xun 搜索并整理报告。
  • analyze 类（需 chi judge） — 例：评估某模型定价对行业的影响 → spawn xun 搜集资料 → 再 spawn chi 做 fresh-context 独立复核 → 输出四段报告。
  • team 类（多路 Wave 并行 + 汇总） — 例：写周报需查最新新闻和配图概念 → spawn si 规划 → Wave 1 xun 查新闻 + yi 出配图概念（并行）→ Wave 2 si 撰写正文 → chi 独立复核全部产物。
  • 三命令速查 — /ultrawork <任务> 一键编排（men 是唯一 spawner）· /verify <角色或路径> 双层验证（chi，fresh-context Judge）· /hyperplan <项目> 访谈式规划产出 plan envelope（men → si，只规划不执行）。

来源：.opencode/command/ultrawork.md · docs/guide/quickstart.md

验收产物

/verify <角色名或路径> [附加标准] 用于独立验收某个角色的产物，由 chi 以 fresh-context Judge 身份执行双层验证：

text
/verify ji -- 验证 ji 的代码产物
  • 第 1 层 机械检查 — 执行 node scripts/verify.mjs <目标> --json --sid <sid>，五项检查：output-exists / secrets / todo-scan / structure / gate-exit-code，任一 FAIL 即记机械失败。
  • 第 2 层 语义复核 — 机械检查全 PASS 后，chi 对内容匹配度、来源真实性、逻辑完整性、代码质量做独立判断，输出 Verdict：PASS / FAIL / BLOCKED。
  • 报告落盘 — Judge 报告写入 .agents/state/sessions/<sid>/judge-<角色>.md（best-effort）。
  • 自主学习 — 验证完成后触发 node scripts/eval-metrics.mjs --sid <sid> --json，计算 8 项 KPI（通过率、平均耗时、回归次数等，覆盖最近 10 次任务窗口）。

来源：.opencode/command/verify.md · scripts/verify.mjs · scripts/eval-metrics.mjs

规划复杂项目

/hyperplan <项目> 用于复杂项目的深度思考与多角度方案拆解，产出可执行项目计划但不执行：

text
/hyperplan 设计一个多 Agent 协作系统
  • 六项访谈 — 逐项确认目标 / 范围 / 阶段 / 涉及角色 / 约束 / 验收，六项全部明确前不进入规划环节。
  • 产出 plan envelope — 包含项目目标、范围与边界、阶段划分、任务依赖图、并行波次、涉及角色、验收标准总表、TODO List；验收标准必须机械可验证。
  • 只规划不执行 — 计划经用户确认后，再用 /ultrawork 按 plan 的 Wave 顺序分发执行。

来源：.opencode/command/hyperplan.md · site/src/data/content.json（commands）

下一步

跑通第一个任务后，建议继续阅读：

  • 协议规范 — 10 步编排协议、5 项机械验证、事件类型与自主学习回路的完整说明（docs/protocols）。
  • 架构设计 — 系统拓扑、编排流程与验证体系全景（docs/architecture）。
  • 自主学习回路 — 每次 /ultrawork（第 10 步）与 /verify（第 5 步）完成后自动触发 learn.mjs / eval-metrics.mjs，经验写入 knowledge/errors/ 与 knowledge/patterns/（best-effort，不阻塞主流程）。

来源：AGENTS.md · docs/guide/quickstart.md

参见