OpenCode 配置仓库

AI 编程助手配置，提供统一的 Adapt 工作流：评估 → 分类 → 规划 → 执行 → 交付。

安装

curl -fsSL https://raw.githubusercontent.com/huyusong10/opencode-config/main/install.sh | bash

---

架构概览

┌─────────────────────────────────────────────────────────────────────────────┐
│                              Architecture                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│                              ┌─────────┐                                    │
│                              │  User   │                                    │
│                              └────┬────┘                                    │
│                                   │                                         │
│                                   ▼                                         │
│                         ┌───────────────┐                                   │
│                         │    Adapt      │  <-- Single Entry Point           │
│                         │ (Chief Eng.)  │                                   │
│                         └───────┬───────┘                                   │
│                                 │                                           │
│              ┌──────────────────┼──────────────────┐                        │
│              │                  │                  │                        │
│              ▼                  ▼                  ▼                        │
│     ┌─────────────┐    ┌─────────────┐    ┌─────────────┐                   │
│     │adapt-worker │    │adapt-worker │    │adapt-worker │  <-- Executors    │
│     │  (Worker)   │    │  (Worker)   │    │  (Worker)   │                   │
│     └─────────────┘    └─────────────┘    └─────────────┘                   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

设计原则： 用户只与 Adapt 对话。Adapt 负责评估、分类、规划，并将具体工作分派给 adapt-worker 执行。

---

Adapt 工作流

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Adapt Workflow                                    │
├───────────┬───────────┬───────────┬───────────┬─────────────────────────────┤
│ Evaluate  │ Classify  │   Plan    │  Execute  │          Deliver            │
├───────────┼───────────┼───────────┼───────────┼─────────────────────────────┤
│Constraint │  Simple   │ Research  │   Split   │  Gate 1: Review             │
│  Intent   │ Evaluate  │  Design   │ Dispatch  │  Gate 2: Reflect            │
│ Implicit  │ Execute   │   Test    │ Coordinate│  Gate 3: Output             │
│   Gap     │ Compound  │ Iterate   │  Adjust   │                             │
│ Capacity  │           │           │ Escalate  │                             │
└───────────┴───────────┴───────────┴───────────┴─────────────────────────────┘

阶段 1：评估

在动手之前先看清局势。误解问题是最昂贵的错误。

• 约束条件： 时间限制、技术约束、环境限制
• 核心意图： 用户真正关心什么？速度？质量？原型？
• 隐含期望： 用户没说但明显期望什么
• 知识缺口： 是否有足够信息继续
• 能力检查： 任务是否在系统能力范围内

阶段 2：分类

类型	特征	示例
简单任务	目标明确、路径清晰、范围小	修复 typo、编写工具函数
评估任务	需要调查、比较或分析	评估技术栈、分析架构
执行任务	目标明确，需要大量实现	构建功能模块、编写测试
复合任务	模糊或大规模，需先分解	"建一个博客系统"

阶段 3：规划

Research -> Design -> Execute -> Test

调研原则： 充分且有效。针对每个维度分派 subagent 深度调查。

设计原则： 给出宏观设计（数据结构、功能架构、模块划分），不让执行者自行决定。

测试原则： 测试在实现前或并行开发，不是事后想法。

阶段 4：执行

任务类型	subagent 数量	说明
简单	1	直接分派
评估	3-10	每个维度一个
执行	2-5	至少实现 + 测试
复合	3+	分阶段进行
硬上限	20	超过则重新分解

失败升级链： 重试 → 重想 → 降级 → 通知

阶段 5：交付

三道门：审查 → 反思 → 输出

任何测试失败必须返回执行迭代。

---

Adapt-Worker

Adapt 总工指挥下的执行者，使用 OODA 循环执行任务：

Observe -> Orient -> Decide -> Act
    ^                         |
    +-------------------------+

输出结构：

1. 任务确认
2. 执行摘要
3. 核心交付物
4. 置信度评估
5. 范围外发现（如有）

---

规则系统

rules/ 目录下的规则自动加载，为所有 agent 提供行为约束：

规则文件	用途
ascii-diagrams.md	ASCII 图表规范
codeact.md	代码脚本优先原则

---

目录结构

opencode-config/
├── opencode.jsonc              # Provider, model, plugins 配置
├── AGENTS.md                   # 全局规则（语言、缩进等）
├── agent/
│   ├── adapt.md                # Adapt — 唯一主代理
│   ├── adapt-worker.md         # Adapt-Worker — 执行代理
│   └── build.md                # 构建流程文档
├── rules/                      # 自动加载的行为规则
├── plugin/                     # Opencode 插件
└── .planning/                  # 运行时：项目计划（生成）

---

变更历史

2026-03: 架构统一

重大变更： 将分散的多 agent 架构统一为 Adapt 体系。

变更前	变更后
多个主代理 (janus, maestro, architect, maker)	单一主代理 (Adapt)
多个设计代理 (arch/ux/risk/impl-designer)	Adapt 内部规划
多个执行代理 (coder, tester, debugger)	单一执行代理 (adapt-worker)
多个审查代理 (system-reviewer + specialists)	Adapt 内部交付验证

原因：

• 简化用户交互模型
• 减少上下文切换开销
• 提高角色定位清晰度
• Adapt 作为"总工程师"统筹全局，adapt-worker 作为"执行者"专注落地