OpenCode Onboard：一键式 AI 智能体工作流脚手架工具，让代码库秒变 Agent 友好型项目

OpenCode Onboard是一款命令行工具，通过一条命令即可为任意代码库配置完整的AI智能体工作流。它能自动安装通用智能体团队、配置多模型策略、初始化OpenSpec变更管理，并集成Ensemble并行执行框架，解决代码库对AI智能体不友好的问题，为团队协作和自动化开发提供标准化解决方案。

传统代码库缺乏针对AI设计的文档（如AGENTS.md）、清晰的任务分配机制和智能体可读的上下文信息，导致AI工具仅能完成简单代码补全，难以承担复杂开发任务。OpenCode Onboard的核心理念是主动将代码库改造成智能体友好形态，如同为新人开发者准备入职培训材料。

通过交互式命令行向导完成十步配置：1.定义源码范围；2.清理旧AI配置；3.选择代码托管平台（GitHub/Azure DevOps）；4.验证平台CLI；5.复制脚手架文件（核心步骤）；6.初始化OpenSpec；7.选择AI模型（规划/构建/快速三类）；8. Token优化工具；9.安装浏览器插件；10.写入配置元数据。

采用智能体（定义"如何工作"）与技能（定义"知道什么"）分离架构。默认智能体团队包含devops-manager（协调者）和basic-engineer（执行者）；技能系统自动发现.agents/skills/下的SKILL.md，内置ob-global、ob-default等技能，支持自定义技能。

模型按角色分工：规划模型用于复杂推理，构建模型用于代码实现，快速模型用于辅助任务。所有模型标注成本等级（[$]经济型、[$$]标准/高端型），提供成本透明度，帮助团队做出经济合理选择。

输入工作项URL后，流程为：加载ob-global规则→解析工作项→生成提案/规格/任务→并行执行（基于Ensemble框架，每个智能体在独立git worktree）→验证→PR创建。可通过localhost:4747实时监控任务状态。

提供自定义斜杠命令：/init（初始化项目）、/plan （生成任务列表）、/main （快速实现）。支持增量更新：clean（重置旧配置）、copy（更新模板/技能）、optimization（配置优化）、metadata（刷新快照）。

适用于希望系统性引入AI智能体的团队、多项目组织、成本敏感开发者及DevOps集成需求企业。未来将成为软件开发基础设施的重要组成部分，助力团队高效利用AI能力并保持流程可控性。