Conductor for Gemini CLI 入门指南

Conductor 是 Gemini CLI 的一个扩展，于 2025 年 12 月 17 日以预览版形式发布，旨在解决 AI 编码中的上下文缺失问题。它引入了上下文驱动开发（CDD）工作流，通过在仓库中维护 Markdown 文件来持久化项目上下文，包括编码标准、技术栈决策和产品目标。自发布以来，Conductor 的 GitHub 仓库已获得超过 3600 颗星和 284 个分支。

Conductor 的工作原理分为三层：命令层（Gemini CLI 中的六个斜杠命令）、工件层（仓库中的 conductor/ 目录，包含 Markdown 和 JSON 文件）和版本控制层（Git，用于创建每个任务的提交并支持回滚）。这种设计适用于全新项目和现有项目。对于现有项目，/conductor:setup 命令会分析代码库，推断技术栈和架构，并自动填充上下文。

安装 Conductor 前需要确保 Gemini CLI 已安装并正常工作，拥有 Google API 密钥或 Vertex AI 设置，并在项目目录中初始化 Git。安装命令为：gemini extensions install https://github.com/gemini-cli-extensions/conductor，建议使用 --auto-update 标志以自动更新。

设置项目时，运行 /conductor:setup，Conductor 会通过引导式问答创建 conductor/ 目录，内含 product.md、product-guidelines.md、tech-stack.md、workflow.md、代码风格指南和 tracks.md 等文件。这些文件定义了产品愿景、用户、技术栈、工作流等关键上下文。提交该目录后，任何克隆仓库的团队成员都能立即获取项目上下文。

功能开发使用 /conductor:newTrack 命令创建一个轨道，每个轨道代表一个工作单元。Conductor 会生成 spec.md（规格）、plan.md（实施计划）和 metadata.json。plan.md 按阶段列出任务，每个任务对应一个 Git 提交。在实施前，用户应审查 plan.md，并在需要时调整。

实施阶段运行 /conductor:implement，Conductor 按 plan.md 逐任务执行，每个任务完成后自动创建提交。每个阶段结束后会暂停，等待用户手动验证，确认后才进入下一阶段。这种机制确保 AI 生成代码与项目架构一致。

Conductor 的六个月预览期已在 2026 年 4 月结束，Google 推出了一个 Codelab 来演示完整的新项目流程。总体而言，Conductor 通过将上下文作为管理工件，有效减少了 AI 生成代码与项目实际结构之间的偏差。