conductor-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Conductor Setup

Conductor 搭建流程

Overview

概述

This skill transforms a standard repository into a Conductor-managed project. It establishes the "Source of Truth" by creating structured documentation for the product vision, technical standards, and development workflows.
该技能可将标准代码仓库转换为Conductor管理的项目。它通过创建产品愿景、技术标准和开发工作流的结构化文档,确立项目的「单一可信来源」。

Workflow Overview

工作流概述

The setup process follows these sequential phases:
  1. Project Discovery: Determines if the project is New (Greenfield) or Existing (Brownfield).
  2. Product Definition: Collaborative creation of
    product.md
    and
    product-guidelines.md
    .
  3. Tech Stack: Definition of the project's technical foundation in
    tech-stack.md
    .
  4. Configuration: Selection of code style guides and customization of
    workflow.md
    .
  5. Track Generation: Creation of the first unit of work (Track) with a
    spec.md
    and
    plan.md
    .
搭建流程遵循以下连续阶段:
  1. 项目调研: 判断项目属于新项目(全新开发)还是现有项目(遗留系统)。
  2. 产品定义: 协作创建
    product.md
    product-guidelines.md
    文档。
  3. 技术栈配置:
    tech-stack.md
    中定义项目的技术基础。
  4. 环境配置: 选择代码风格指南并自定义
    workflow.md
  5. 任务追踪创建: 创建首个工作单元(Track),包含
    spec.md
    plan.md
    文档。

State Management

状态管理

Conductor tracks setup progress in
conductor/setup_state.json
. If the session is interrupted, you MUST check this file to resume from the
last_successful_step
.
  • 2.1_product_guide
    → Resume at Product Guidelines.
  • 2.2_product_guidelines
    → Resume at Tech Stack.
  • 2.3_tech_stack
    → Resume at Code Styleguides.
  • 2.4_code_styleguides
    → Resume at Workflow.
  • 2.5_workflow
    → Resume at Initial Track Generation.
  • 3.3_initial_track_generated
    → Setup complete.
Conductor会在
conductor/setup_state.json
文件中追踪搭建进度。如果会话中断,必须检查该文件以从
last_successful_step
(上一个成功步骤)恢复流程。
  • 2.1_product_guide
    → 从产品指南阶段恢复。
  • 2.2_product_guidelines
    → 从技术栈配置阶段恢复。
  • 2.3_tech_stack
    → 从代码风格指南阶段恢复。
  • 2.4_code_styleguides
    → 从工作流配置阶段恢复。
  • 2.5_workflow
    → 从初始任务追踪创建阶段恢复。
  • 3.3_initial_track_generated
    → 搭建完成。

Implementation Details

实现细节

Refer to the following protocols for detailed procedural instructions:
如需详细的流程说明,请参考以下协议文档:

1. Initialization and Resolution

1. 初始化与资源定位

  • Resolution Protocol: references/resolution-protocol.md - How to find Conductor artifacts.
  • Project Discovery: references/project-discovery.md - Brownfield vs Greenfield detection logic.
  • 资源定位协议: references/resolution-protocol.md - 如何查找Conductor相关资源。
  • 项目调研: references/project-discovery.md - 遗留系统与全新开发项目的判断逻辑。

2. Product Documentation

2. 产品文档

  • Product and Tech Stack: references/product-setup.md - Interactive questioning and document generation.
  • 产品与技术栈: references/product-setup.md - 交互式提问与文档生成流程。

3. Standards and Workflow

3. 标准与工作流

  • Configuration: references/configuration.md - Copying templates and customizing the development cycle.
  • 配置: references/configuration.md - 模板复制与开发周期自定义。

4. Planning the First Track

4. 首个任务追踪规划

  • Track Generation: references/track-generation.md - Creating the first
    spec.md
    and
    plan.md
    .
  • 任务追踪创建: references/track-generation.md - 创建首个
    spec.md
    plan.md
    文档。

Mandatory Constraints

强制约束

  • TDD Integration: When generating
    plan.md
    , you MUST adhere to the TDD principles defined in
    workflow.md
    (Red/Green/Refactor tasks).
  • Universal File Resolution: ALWAYS use the protocol in
    references/resolution-protocol.md
    to find or verify files.
  • Git Hygiene: Setup concludes with a commit of all
    conductor/
    files.
  • TDD 集成: 生成
    plan.md
    时,必须遵循
    workflow.md
    中定义的TDD原则(红/绿/重构任务流程)。
  • 统一文件定位: 必须始终使用
    references/resolution-protocol.md
    中的协议来查找或验证文件。
  • Git 规范: 搭建完成后必须提交所有
    conductor/
    目录下的文件。

Assets

资源文件

Templates used during setup are located in
assets/templates/
:
  • workflow.md
    : The base development workflow.
  • code_styleguides/
    : Language-specific style guides (Python, TypeScript, Go, etc.).
搭建过程中使用的模板位于
assets/templates/
目录下:
  • workflow.md
    : 基础开发工作流模板。
  • code_styleguides/
    : 各语言专属的代码风格指南(Python、TypeScript、Go等)。