Gemini CLI 的 Conductor 扩展

三思而后行，一次编码到位。

Conductor 是一个 Gemini CLI 扩展，支持 上下文驱动开发。它将 Gemini CLI 变成一位主动的项目经理，遵循严格的流程来明确需求、制定计划并实现软件功能与缺陷修复。

Conductor 不仅仅编写代码，它还确保每个任务都经历一致且高质量的生命周期：上下文 -> 规格与计划 -> 实现。

Conductor 的理念很简单：掌控你的代码。通过将上下文视为与代码同等重要的受管工件，你可以把代码仓库变成单一的事实来源，从而在每次与 AI 交互时都能保持对项目的深度和持久认知。

功能特性

• 先规划再构建：为新项目和现有代码库创建指导 AI 行动的规格和计划。
• 维护上下文：确保 AI 遵循代码风格指南、技术栈选择和产品目标。
• 安全迭代：在编写代码之前审查计划，让你始终掌握主动权。
• 团队协作：为你的产品、技术栈和工作流偏好设置项目级上下文，使其成为团队共享的基础。
• 基于现有项目构建：智能初始化适用于全新项目（Greenfield）和已有项目（Brownfield）。
• 智能回滚：具备 Git 感知能力的回滚命令，能够理解逻辑工作单元（轨道、阶段、任务），而不仅仅是提交哈希值。

安装

从终端运行以下命令即可安装 Conductor 扩展：

gemini extensions install https://github.com/gemini-cli-extensions/conductor --auto-update

--auto-update 是可选参数：如果指定，将在新版本发布时自动更新。

使用方法

Conductor 旨在管理开发任务的完整生命周期。

关于 Token 消耗的说明：Conductor 的上下文驱动方法需要读取和分析项目的上下文、规格和计划。这可能导致 Token 消耗增加，尤其是在大型项目或进行大量规划和实施阶段时。你可以在当前会话中通过运行 /stats model 来查看 Token 消耗情况。

1. 设置项目（仅需执行一次）

当你运行 /conductor:setup 时，Conductor 会帮助你定义项目上下文的核心组成部分。这些上下文随后会被你或团队中的任何成员用于构建新的组件或功能。

• 产品：定义项目上下文（例如用户、产品目标、高层次功能）。
• 产品指南：定义标准（例如文案风格、品牌信息、视觉识别）。
• 技术栈：配置技术偏好（例如编程语言、数据库、框架）。
• 工作流：设定团队偏好（例如 TDD、提交策略）。使用 workflow.md 作为可定制模板。

生成的工件：

• conductor/product.md
• conductor/product-guidelines.md
• conductor/tech-stack.md
• conductor/workflow.md
• conductor/code_styleguides/
• conductor/tracks.md

/conductor:setup

2. 开始新轨道（功能或 Bug）

当你准备好处理新功能或 Bug 修复时，运行 /conductor:newTrack。这将初始化一个 轨道——一个高层次的工作单元。Conductor 会帮助你生成两个关键工件：

• 规格：针对具体任务的详细需求。我们要构建什么？为什么？
• 计划：包含阶段、任务和子任务的可执行待办清单。

生成的工件：

• conductor/tracks/<track_id>/spec.md
• conductor/tracks/<track_id>/plan.md
• conductor/tracks/<track_id>/metadata.json

/conductor:newTrack
# 或者附带描述
/conductor:newTrack "在设置页面添加暗模式切换"

3. 实现轨道

一旦你批准了计划，就运行 /conductor:implement。你的编码代理会按照 plan.md 文件逐步执行任务，并在完成时逐一勾选。

更新的工件：

• conductor/tracks.md（状态更新）
• conductor/tracks/<track_id>/plan.md（状态更新）
• 项目上下文文件（完成后同步）

/conductor:implement

Conductor 将执行以下步骤：

1. 选择下一个待处理的任务。
2. 按照定义的工作流执行（例如 TDD：编写测试 -> 失败 -> 实现 -> 通过）。
3. 在进展过程中更新计划中的状态。
4. 验证进度：在每个阶段结束时引导你进行手动验证，以确保一切按预期工作。

在实施过程中，你还可以：

• 检查状态：获取项目整体进展的概览。

  /conductor:status
  

• 回滚工作：如有需要，可以撤销某个功能或特定任务。

  /conductor:revert
  

• 审查工作：根据指南和计划审查已完成的工作。

  /conductor:review
  

命令参考

命令	描述	生成的工件
/conductor:setup	搭建项目框架并设置 Conductor 环境。每个项目只需执行一次。	conductor/product.md conductor/product-guidelines.md conductor/tech-stack.md conductor/workflow.md conductor/tracks.md
/conductor:newTrack	启动一个新的功能或 Bug 轨道。生成 spec.md 和 plan.md。	conductor/tracks/<id>/spec.md conductor/tracks/<id>/plan.md conductor/tracks.md
/conductor:implement	执行当前轨道计划中定义的任务。	conductor/tracks.md conductor/tracks/<id>/plan.md
/conductor:status	显示 tracks 文件及当前活动轨道的进度。	读取 conductor/tracks.md
/conductor:revert	通过分析 Git 历史记录回滚整个轨道、某个阶段或任务。	回滚 Git 历史
/conductor:review	根据指南和计划审查已完成的工作。	读取 plan.md、product-guidelines.md

资源

• Gemini CLI 扩展文档：关于在 Gemini CLI 中使用扩展的文档
• GitHub 问题列表：报告 Bug 或请求功能

法律声明

• 许可证：Apache License 2.0

Conductor 快速上手指南

Conductor 是 Gemini CLI 的一款扩展工具，旨在实现上下文驱动开发（Context-Driven Development）。它将 Gemini CLI 转变为主动的项目管理器，遵循“上下文 -> 规范与计划 -> 实施”的严格流程，确保每个开发任务的高质量交付。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 macOS、Linux 或 Windows (WSL)。
• 前置依赖：
  • 已安装并配置好 Gemini CLI。
  • 已登录 Google 账号并拥有有效的 API 访问权限。
  • 项目目录已初始化 Git 仓库（Conductor 依赖 Git 进行智能回退和状态管理）。
• 网络环境：由于需要连接 GitHub 拉取扩展及调用 Gemini 服务，请确保网络通畅。

安装步骤

打开终端，进入您的项目根目录，运行以下命令安装 Conductor 扩展：

gemini extensions install https://github.com/gemini-cli-extensions/conductor --auto-update

提示：--auto-update 参数为可选，添加后当有新版本发布时会自动更新。

基本使用

Conductor 的工作流分为三个核心阶段：项目初始化、创建新任务轨道（Track）、执行实施。

1. 项目初始化（仅需运行一次）

首次在新项目中使用时，运行 setup 命令来定义产品目标、技术栈和工作流规范。这将生成 conductor/ 目录及相关配置文件。

/conductor:setup

执行后，请根据提示完善以下信息（生成的文件位于 conductor/ 目录下）：

• Product: 项目背景与核心目标。
• Product guidelines: 品牌风格与内容规范。
• Tech stack: 编程语言、框架及数据库偏好。
• Workflow: 团队协作偏好（如 TDD、提交策略等）。

2. 启动新任务轨道 (New Track)

当需要开发新功能或修复 Bug 时，创建一个“轨道（Track）”。Conductor 会协助您生成详细的需求文档（Spec）和执行计划（Plan）。

方式一：交互式创建

/conductor:newTrack

方式二：直接描述需求

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

此命令将在 conductor/tracks/<track_id>/ 下生成 spec.md（需求）和 plan.md（行动计划）。请在代码生成前仔细审查并确认计划。

3. 实施任务 (Implement)

确认计划无误后，运行 implement 命令。AI 代理将严格按照 plan.md 中的步骤编写代码，并在每个阶段结束后引导您进行验证。

/conductor:implement

在执行过程中，您可以随时使用以下辅助命令：

• 查看进度：/conductor:status
• 审查已完成工作：/conductor:review
• 智能回退（支持按任务单元回退）：/conductor:revert

---

注意：Conductor 的深度上下文分析可能会增加 Token 消耗。如需监控当前会话的用量，可运行 /stats model。