配置
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 的关键字段如下:
| 字段 | 值 | 用途 |
|---|---|---|
$schema | https://opencode.ai/config.json | 配置校验 schema |
version | 0.6.1 | 配置版本号 |
default_agent | men | 默认(primary)对话 Agent |
instructions | AGENTS.md | 注入的全局说明文件 |
agent | 6 个角色模型映射 | 每个 Agent 的运行时模型(见下节) |
agent.men.permissions | V2 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 | 技能包搜索路径 |
mcp | 7 个服务 | 外部工具服务(见 MCP 节) |
模型分配
六个角色各自挂载不同模型,通过 opencode.json 的 agent 字段配置。运行时权威配置以该字段为准,agent 定义文件 frontmatter 中的 model 仅为声明。 men 是唯一 primary 角色,其余五个均为 subagent。
| 角色 | 中文名 | 模式 | 模型 |
|---|---|---|---|
| men | 门 | primary | sensenova/deepseek-v4-flash |
| si | 思 | subagent | sensenova/deepseek-v4-flash |
| ji | 记 | subagent | sensenova/sensenova-6.8-flash-lite |
| chi | 持 | subagent | sensenova/deepseek-v4-flash |
| yi | 艺 | subagent | sensenova/sensenova-6.8-flash-lite |
| xun | 寻 | subagent | sensenova/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。
技能与命令路径
skills.paths 指向 .opencode/skills(15 个技能包), 自定义命令位于 .opencode/command/(3 个命令)。技能按角色分配,对应专项工作流:
| 类型 | 路径 | 数量 | 内容 |
|---|---|---|---|
| 技能包 | .opencode/skills/ | 15 | ji ×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字段为准
标准模板结构:
# .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 一键安装。