Conductor：为 Gemini CLI 引入上下文驱动开发
Source: Google Developers Blog
请提供您需要翻译的正文内容，我将为您翻译成简体中文。
2025年12月17日
- Jay Kornder – 高级产品经理，开发者与体验
- Sherzat Aitbayev – 高级软件工程师，开发者与体验
量两次，写一次代码
本杰明·富兰克林说：“不计划就是在计划失败。” 然而，在 AI 时代，我们常常在没有清晰了解要构建什么的情况下直接投入实现。Conductor——Gemini CLI 的全新预览扩展——通过上下文驱动开发改变了这一工作流程。Conductor 不再依赖短暂的聊天记录，而是让你创建正式的规格和计划，这些文件与代码并存于持久的 Markdown 文件中。这使你能够：
- 在构建之前进行规划 – 创建规格和计划，以指导新旧代码库的代理。
- 保持上下文 – 确保 AI 遵循风格指南、技术栈选择和产品目标。
- 安全迭代 – 在任何代码编写之前审查计划，让你始终掌握全局。
- 团队协作 – 为你的 AI 代理提供相同的项目和最佳实践上下文。
- 基于现有项目构建 – 利用当前代码来指导设计决策。
Conductor 背后的理念很简单：控制你的代码。将上下文视为与代码并存的受管制工件，你就可以将代码库转变为唯一的真实来源，为每次代理交互提供深度、持久的项目感知。
对“棕地”项目的支持
我们的大部分工作都涉及已有的代码库（棕地）。AI 工具在这方面常常表现不佳，因为它们缺乏对项目历史和架构的细致了解。
Conductor 的方法
- 上下文驱动：当你将 Conductor 引入现有项目时，它会启动交互式会话，帮助你创建一套涵盖架构、指南和目标的基础文档。
- 持续更新：在你开发新功能和承担任务的过程中，Conductor 会更新这些共享上下文，确保其知识与项目同步增长。
这只是第一步。随着我们继续让 Conductor 成为您现有项目的不可或缺的合作伙伴，未来几个月将会有显著的改进。
团队指挥者
Conductor 让你只需一次性定义 项目级上下文——包括产品目标、技术栈和工作流偏好——并在整个团队中共享。这一共享的基础会自动应用到团队构建的每个功能，例如：
- 测试策略 – 定义一个已建立的测试方法，Gemini 将开箱即用。
- 技术约束 – 集中管理编码规范、Lint 规则和依赖版本。
- 工作流偏好 – 设置默认分支策略、CI/CD 流水线和代码审查指南。
为什么使用 Conductor？
- 一致性 – 每一次 AI 生成的贡献都遵循相同的指南，无论是谁执行命令。
- 更快的入职 – 新成员能够立即继承完整配置，缩短上手时间。
- 统一的代码库 – 由不同人员构建的功能看起来像是同一个统一的工程团队编写的。
通过集中管理技术约束和编码规范，Conductor 确保所有贡献都符合团队标准，加速开发并提升整体代码质量。
Conductor 工作原理
Conductor 是一种面向代理式开发的结构化工作流，适用于比单纯代码编辑更复杂的任务。不同于仅限一次交互的普通聊天会话，Conductor 使用一组 Markdown 文件来随时间规划和跟踪进度。这些文件会保存在你的代码库中，使你能够无缝地暂停、恢复以及切换机器。
1. 建立上下文
运行 /conductor:setup 来定义项目的核心组件。捕获的上下文可以在以后构建新组件或新功能时重复使用。
- 产品 – 定义你的用户、产品目标和高级功能。
- 技术栈 – 选择你偏好的语言、数据库和框架。
- 工作流 – 设置团队偏好（例如，测试驱动开发）。
2. 指定并规划
当你准备开始一个新功能或修复 bug 时，运行 /conductor:newTrack。这会创建一个 track——Conductor 用来指代高级工作单元的术语。Conductor 不会让你直接跳入代码，而是帮助你生成两个关键产出物：
| 产出物 | 目的 |
|---|---|
| Specs | 详细需求：我们在构建 什么 以及 为什么。 |
| Plan | 可执行的待办列表，组织为 阶段 → 任务 → 子任务。 |
Conductor 会引导你完成每个产出物的创建，并根据已有的上下文提供建议，帮助你快速产出高质量的规格说明和计划。
3. 实现
在批准计划后，运行 /conductor:implement。你的编码代理会按照 plan.md 文件逐项完成任务，并在完成后勾选。由于状态保存在文件中，你可以：
- 随时停止并在以后继续，而不会丢失进度。
- 通过内置检查点回滚到之前的版本。
- 如果优先级变化，可在进行中编辑计划。
开始使用
我们相信，基于上下文的开发能够为复杂项目带来更高质量的成果。通过将文档视为真实来源，您可以让 Gemini 成为您工程团队的真正延伸。
安装扩展
您可以通过以下两种方式之一安装 Conductor：
- 通过仓库链接：
gemini extensions install https://github.com/gemini-cli-extensions/conductor- 通过 Gemini CLI：
gemini extensions install https://github.com/gemini-cli-extensions/conductor