配置

men(门)的运行时配置以 opencode.json 为唯一入口:它定义默认 Agent、六个角色的模型分配、七个 MCP 服务与技能搜索路径,角色行为则由 .opencode/agent/*.md 承载。仓库 opencode.json 在仓库目录内启动 OpenCode 即生效;模型与密钥由 CC Switch 在本地统一托管。

配置文件结构

men 采用两层配置体系:根目录的 opencode.json 负责运行时装配(默认 Agent、模型、MCP、技能路径),.opencode/agent/*.md 负责角色行为(frontmatter + CHARTER_CHECK + 全员红线)。opencode.json 的关键字段如下:

字段值用途
$schemahttps://opencode.ai/config.json配置校验 schema
version0.6.1配置版本号
default_agentmen默认(primary)对话 Agent
instructionsAGENTS.md注入的全局说明文件
agent6 个角色模型映射每个 Agent 的运行时模型(见下节)
agent.men.permissionsV2 native 数组men 权限:[{ action: "question", resource: "*", effect: "allow" }](V2 有序数组,最后匹配胜出;非 V1 permission 对象)
插件发现V2 自动发现.opencode/plugins/men-sidebar/{index,tui}.js 自动加载,不再需要 tui.json(V1 机制已废弃;V1 配置形态见 v1-compat 分支)
skills.paths.opencode/skills技能包搜索路径
mcp7 个服务外部工具服务(见 MCP 节)

来源:opencode.json

模型分配

六个角色各自挂载不同模型,通过 opencode.json 的 agent 字段配置。运行时权威配置以该字段为准,agent 定义文件 frontmatter 中的 model 仅为声明。 men 是唯一 primary 角色,其余五个均为 subagent。

角色中文名模式模型
men门primarysensenova/deepseek-v4-flash
si思subagentsensenova/deepseek-v4-flash
ji记subagentsensenova/sensenova-6.8-flash-lite
chi持subagentsensenova/deepseek-v4-flash
yi艺subagentsensenova/sensenova-6.8-flash-lite
xun寻subagentsensenova/sensenova-6.8-flash-lite

来源:opencode.json · AGENTS.md

MCP 服务

Men 不携带任何 MCP 配置——MCP 由 CC Switch 统一管理(模型 / 密钥 / MCP 均本地托管),opencode.json 不含 mcp 字段。这样 Men 保持"纯 Agent + 协作代码"定位,MCP 工具集由你的运行环境按需提供。

若需要在 OpenCode 中启用 MCP(如 Exa / Context7 / grep.app / GitHub / memory / sequential-thinking), 请在 CC Switch 中配置并确保其注入到 OpenCode 的全局配置;仓库不会也不应声明 MCP。

来源:opencode.json

技能与命令路径

skills.paths 指向 .opencode/skills(15 个技能包), 自定义命令位于 .opencode/command/(3 个命令)。技能按角色分配,对应专项工作流:

类型路径数量内容
技能包.opencode/skills/15ji ×4(frontend-design / github / l1-verify / content-write)、si ×2(knowledge / plan-compose)、xun ×3(search / factcheck / rss-scan)、chi ×2(invest / judge)、yi ×2(design / imagegen)、men ×2(status / update)
自定义命令.opencode/command/3/ultrawork · /verify · /hyperplan

来源:opencode.json · AGENTS.md

编辑 Agent 定义规则

.opencode/agent/*.md 是 6 个 agent 定义的唯一源代码。新增或修改 agent 时,必须遵守AGENTS.md 的「编辑 agent 定义时必须遵守」一节:

  • 先 read 再 edit — 每次编辑必须先读取文件
  • YAML frontmatter 三字段必须保留:description / mode / model
  • CHARTER_CHECK 字段:每个 agent 必须有,含 Clarification level / Task domain / Must NOT do / Success criteria
  • 全员红线:6 个 agent 必须逐字一致(复制粘贴,不修改)
  • model 值:运行时以 opencode.json 的 agent 字段为准

标准模板结构:

yaml
# .opencode/agent/agent-name.md
---
description: Agent 简短描述
mode: subagent            # 或 primary
model: <model-id>
---

## 身份
你是 agent-name(中文名)的完整介绍...

## 核心职责
1. 职责一
2. 职责二

## CHARTER_CHECK
- Clarification level: HIGH / MEDIUM / LOW
- Task domain: 任务领域
- Must NOT do:
  - 禁止项
- Success criteria:
  - 验收标准

## 全员红线
(6 个 agent 必须逐字一致的 7 条红线)

来源:AGENTS.md · .opencode/agent/si.md · .opencode/agent/chi.md

全局配置

全局模型与密钥由 CC Switch(或本机 ~/.config/opencode/opencode.json)统一管理; 仓库 opencode.json 在仓库目录内启动即自动加载。 若要在任意目录使用整支团队,运行 npx @cgartlab/men 一键安装。

来源:opencode.json

参见