🎯 OpenCode插件系列: opencode-conductor-plugin

类型：Workflow / Process Plugin

1. 这个插件是什么？

Conductor 是一个强制 OpenCode 遵循名为 Context-Driven Development（上下文驱动开发）严格方法的插件。其理念很简单：

“Measure twice, code once” —— 量两次，切一刀。

插件不是让 AI agent 在您要求时立即编写代码，而是强制它遵循严格的协议：

上下文 → 规范 → 计划 → 实现

即：

1. 首先完全理解项目上下文
2. 编写清晰规范（规范文档）
3. 制定详细计划
4. 然后才开始编写代码

组件：

• 🎭 @conductor* Agent*—— 作为 “项目架构师” 和 “技术负责人” 的专业 agent
• ⚡ Slash Commands —— /conductor:setup, /conductor:newTrack, /conductor:implement 等
• 🔁 智能回滚 —— 在 Tracks/Phases/Tasks 层面理解 Git 的回滚系统，而不是 commits
• 📚 19+ 风格模板 —— Rust, Solidity, Zig, Julia, Kotlin, Swift 等

2. 它的用途是什么？

在以下情况下使用它：

• ✅ 防止 AI 在理解之前直接跳转到实现
• ✅ 通过 spec.md 和 plan.md 自动记录项目
• ✅ 将工作组织成 “Tracks”，每个都有 spec 和 plan
• ✅ 语义化的自动提交，每个 task 后都会产生
• ✅ 智能回滚 到逻辑单元级别（而非 commit hash）
• ✅ 项目章程 —— 记录项目规则（测试标准、提交策略等）
• ✅ 与 Oh My OpenCode 协同作用 —— 两者配合良好

3. 如何使用？

安装

在 ~/.config/opencode/opencode.json 中：

{
  "plugin": [
    "opencode-conductor-plugin"
  ]
}

⚠️ 重要：第一次后需要重启 OpenCode 才能使 slash commands 全局工作。

模型设置（推荐）

@conductor 最适合使用快速模型，如 Gemini Flash。在配置中添加：

{
  "agent": {
    "conductor": {
      "model": "google/gemini-3-flash"
    }
  }
}

与 Oh My OpenCode 配合：

在 ~/.config/opencode/oh-my-opencode.json 中：

{
  "agents": {
    "conductor": {
      "model": "google/gemini-3-flash"
    }
  }
}

基础工作流

1️⃣ 每个项目只需一次：/conductor:setup

/conductor:setup

Conductor 会与您进行访谈，询问：

• 产品愿景：用户、目标、功能
• 技术栈：语言、框架、数据库
• 工作流规则：测试标准（TDD/BDD）、提交策略、文档模式 这将创建 “项目章程” 文件。

2️⃣ 每个新功能/修复：/conductor:newTrack

/conductor:newTrack "为设置页面添加暗色模式切换"

Conductor 会：

• spec.md—— 询问 3-5 个具体问题以理解 “做什么” 和 “为什么”
• plan.md—— 根据项目规则列出分步任务

3️⃣ 实现：/conductor:implement

/conductor:implement

Conductor 会处理 plan.md 并执行：

• 执行每个 task
• 运行测试
• 自动进行语义化提交
• 直到 Track 完成才会停止

完整命令列表

4. 何时使用？

在以下情况使用：

• ✅ 处理大型或长期项目
• ✅ 需要自动记录项目（为团队或自己）
• ✅ 喜欢结构化工作流（注重细节的性格）
• ✅ 处理功能多的项目，需要组织
• ✅ 与团队合作，需要统一方法论
• ✅ 处理复杂的 bug 修复，需要先计划再编码
• ✅ 在 Nanosoft 做基础层架构 —— 这非常适合您的工作

不要在以下情况使用：

• ❌ 编写小脚本或快速任务
• ❌ 进行快速原型设计，不需要形式化
• ❌ 喜欢敏捷/迭代工作流，无需提前计划
• ❌ 不想为每个功能编写 specs 和 plans

⚠️ 重要注意事项

与 Oh My OpenCode 的循环保护：

Conductor 内置 “循环保护”，以免在问答阶段与 OmO 的 continuation enforcers 冲突。

Conductor 与 Oh My OpenCode：

• Sisyphus（在 OmO 中）= 全局协调器和对话管理
• @conductor*（在此插件中）= 架构和计划的技术负责人 Sisyphus 可以在需要精确计划时委托给 @conductor。

Agent 通用性：

Conductor 命令可以从任何其他 agent 使用，不限于 @conductor。这给您选择主要界面的自由。

版本控制：

遵循 Conventional Commits + Semantic Release：

• feat: → minor version
• fix: → patch version
• BREAKING CHANGE: → major version

许可证：Apache-2.0

🔗 有用链接

• README：https://github.com/derekbar90/opencode-conductor
• INSTALL.md：https://github.com/derekbar90/opencode-conductor/blob/main/INSTALL.md
• CHANGELOG：https://github.com/derekbar90/opencode-conductor/blob/main/CHANGELOG.md