Framework OpenAgentsControl 先规划后执行的AI编程框架

多数 AI agent 像雇了个不了解你代码库的开发者：写出来的代码很泛，你花几小时重写、重构、修不一致。token 烧了、时间废了、活没干完。问题根子是 agent 不知道你的模式——你的校验方式、你的 ORM、你的响应格式。
理想形态：agent 动手前就理解你的标准与架构，先提案、你批准、再增量执行并校验；同一套模式，全队复用。

项目基本信息

一、项目介绍

darrenhinde/OpenAgentsControl（OAC）是一个 MIT 协议的 AI agent 框架，主打“先规划、后批准执行”的开发流程，面向 OpenCode 构建。它让 agent 在生成代码前先加载你的编码模式（通过 .oac 配置、.claude/context、.opencode/context 等来源发现），支持 TypeScript、Python、Go、Rust、C# 等多语言，并内置自动测试、代码审查与校验。框架由 7 个子代理（task-manager、context-scout、context-manager、coder-agent、test-engineer、code-reviewer、external-scout）与 9 个工作流技能组成，所有 agent 行为都是可直接编辑的 markdown，无编译、无厂商锁定。

二、核心优势

1. 模式感知：agent 先加载你的编码标准/架构/安全要求，代码从一开始就贴合项目。
2. 批准门：agent 执行前永远先提案，你批准才动手，杜绝“AI 刚干了啥”的惊吓。
3. 可编辑 agent：行为写在 markdown，改流程/加约束无需编译。
4. Token 高效：MVI 原则，上下文文件 <200 行、按需懒加载。
5. 模型无关：Claude、GPT、Gemini、MiniMax、本地模型都能用，无锁定。

三、适用场景

• 你已有稳定的编码模式，希望 agent 产出即贴合、无需大量重构。
• 需要批准门做质量控制的团队开发。
• 关心 token 效率与成本、想减少全量上下文加载。
• 希望全队共享同一套工程标准（提交 context 到仓库即可继承）。

四、安装教程

前提：OpenCode CLI（免费开源）、Bash 3.2+、Git。一键安装（会自动装好 OpenCode）：

curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer

更新：curl -fsSL .../update.sh | bash（自定义目录加 --install-dir PATH）。也可作为 Claude Code 插件：

/plugin marketplace add darrenhinde/OpenAgentsControl
/plugin install oac
/oac:setup --core

常见报错：安装脚本执行策略被拦时先 chmod +x 再运行；OpenCode 未装时安装器会代为安装。

五、使用示例

启动并用自然语言派活：

opencode --agent OpenAgent
> "Create a user authentication system"

真实流程：agent 分析请求 → 提案（你批准）→ 带校验逐步执行 → 必要时委派专家 → 产出可上线代码。也可加自己的模式：

/add-context
# 回答 6 个问题：技术栈、API 示例、目录约定……（10–15 分钟）

之后 agent 每次都自动加载这些标准。

六、常见问题

Q：OAC 和 Cursor/Copilot 的核心差异？
A：OAC 内置模式学习、强制批准门、MVI token 效率与团队共享 context；Cursor/Copilot 默认不学模式、批准门可选或默认关。
Q：一定要用 OpenCode 吗？
A：主线为 OpenCode v1；也提供 Claude Code 插件（BETA），未来版本将大幅替换现有实现。
Q：协议能商用吗？
A：采用 MIT License，可商用与修改，需保留版权与许可声明。

七、总结

OpenAgentsControl 用“先学你的模式、再提案、你批准、再执行”的范式，把 AI 产出从泛用代码变成贴合项目的生产级代码，并用批准门守住质量。对已有成熟工程标准、又想让 agent 少返工的团队，它是 MIT 协议、可编辑、模型无关的务实框架。