opencode-architect

OpenCode 多代理协作工作流 —— 以 Architect 为主代理，调度 Developer、Reviewer、Tester、Docwriter、Designer 子代理完成开发任务。

目录结构

opencode-architect/
├── install.sh          # 安装脚本（渲染模板并写入目标目录）
├── README.md           # 本文件
├── .gitignore
└── agents/
    ├── architect.md    # 主代理模板
    ├── developer.md    # 代码执行代理
    ├── reviewer.md     # 代码审查代理
    ├── designer.md     # 界面设计代理
    ├── docwriter.md    # 文档代理
    └── tester.md       # 测试代理

• agents/*.md 为模板文件，安装脚本不会修改它们。
• 安装时脚本读取模板，渲染模型配置后写入 ~/.config/opencode/agents/。

安装

# 克隆仓库
git clone https://github.com/OXeu/opencode-architect.git
cd opencode-architect

# 安装（使用模板默认模型）
./install.sh

指定模型

支持通过 环境变量 或 CLI 参数 自定义 agent 模型。 CLI 参数优先级高于环境变量。

配置项	影响文件	默认值
ARCHITECT_MODEL	architect.md	openai/gpt-5.4
SUBAGENT_MODEL	所有子代理（可被细粒度覆盖）	—
DEVELOPER_MODEL	developer.md	deepseek/deepseek-v4-flash
REVIEWER_MODEL	reviewer.md	deepseek/deepseek-v4-flash
DESIGNER_MODEL	designer.md	deepseek/deepseek-v4-flash
DOCWRITER_MODEL	docwriter.md	deepseek/deepseek-v4-flash
TESTER_MODEL	tester.md	deepseek/deepseek-v4-flash

优先级规则：

1. 若 ARCHITECT_MODEL 为空，architect 保持模板默认值 openai/gpt-5.4
2. 若 SUBAGENT_MODEL 不为空，作为所有子代理的默认模型
3. 细粒度变量（如 DEVELOPER_MODEL）覆盖 SUBAGENT_MODEL
4. 若某个子代理的对应变量和 SUBAGENT_MODEL 均为空，保持模板默认值

环境变量示例

# 仅修改 architect 模型
ARCHITECT_MODEL=openai/gpt-5-preview ./install.sh

# 统一设置所有子代理，再单独覆盖 developer
SUBAGENT_MODEL=anthropic/claude-sonnet-4-20250514 \
DEVELOPER_MODEL=deepseek/deepseek-v4-flash \
./install.sh

CLI 参数示例

# 查看帮助
./install.sh --help

# 指定 architect 模型
./install.sh --architect-model openai/gpt-5-preview

# 设置子代理默认 + 覆盖 developer
./install.sh \
  --subagent-model anthropic/claude-sonnet-4-20250514 \
  --developer-model deepseek/deepseek-v4-flash

注意：CLI 选项缺少参数会报错退出。例如 ./install.sh --architect-model（未指定模型值）会输出清晰的错误信息并终止。

使用

安装完成后启动 OpenCode：

opencode

按 <Tab> 键切换 agent，选择 architect 即可使用本工作流。

子代理（developer、reviewer、tester、docwriter、designer）由 architect 自动调度，无需手动切换。

卸载

# 删除安装的目标文件
rm -rf ~/.config/opencode/agents/architect.md \
       ~/.config/opencode/agents/developer.md \
       ~/.config/opencode/agents/reviewer.md \
       ~/.config/opencode/agents/designer.md \
       ~/.config/opencode/agents/docwriter.md \
       ~/.config/opencode/agents/tester.md

默认模型策略

• 模板中 model: 字段为出厂默认值，安装脚本不会直接修改模板。
• 安装时若未通过环境变量或 CLI 参数指定模型，则保留模板中的默认值。
• 若指定了模型，脚本使用 awk 仅替换 frontmatter（--- 块内）中首个 model: 行，不影响正文内容。