# @cliangdev/conductor 中文文档

规范地址：https://npmcn.com/package/%40cliangdev/conductor/

版本：0\.53\.2
npm 元数据更新时间：2026-11-08T02:18:49.665Z
中文译文更新时间：2026-11-10T01:27:11.485Z
软件包许可：SEE LICENSE IN \.\./LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cliangdev/conductor
原文对照：https://npmcn.com/package/%40cliangdev/conductor/?lang=original
项目主页：https://github.com/cliangdev/conductor#readme
源码仓库：https://github.com/cliangdev/conductor

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.1 MB，497 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.14\.0
- 运行依赖：12 个
- 首次发布：2026-04-19T21:53:27.951Z
- 最新版本发布：2026-11-08T02:18:49.352Z
- 近 30 天下载量：7521（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：88（近 12 个月 88 个）

## 中文简介

Agentic软件开发平台——AI驱动的PRD,执行等

## 安装

```sh
npm install @cliangdev/conductor
```

也可以使用：`pnpm add @cliangdev/conductor`、`yarn add @cliangdev/conductor`、`bun add @cliangdev/conductor`

## README

# 指挥员

**代理软件开发——从思想到推出,由AI和人来循环.**

[![npm](https://img.shields.io/npm/v/@cliangdev/conductor)](https://www.npmjs.com/package/@cliangdev/conductor)

## 什么是指挥家?

指挥者是代理组织的协调层:AI代理进行工作——作者规格,写出代码,运行自动化,维护知识库——以及人类审查,批准,指导. 该平台将工作项目与审查闸门,生命周期+自动化工作流程,命名代理,一个知识中心,以及第三方整合相结合.

这个软件包是本地工具包:一个用于 auth/sync 的 CLI 和一个MCP 服务器,可以让 Claude Code(或任何MCP 客户端)完全访问该平台.

## 如何运作

```
1. Write a PRD     →   /conductor:prd in Claude Code
2. Team reviews    →   Conductor web app — comment, approve, request changes
3. Implement       →   /conductor:implement in Claude Code
4. PR opens        →   Claude commits, pushes, and creates the pull request
5. Fix & iterate   →   /conductor:fix — address review feedback on the open PR
6. Merge           →   Work item closes automatically
```

特工负责行刑 人类设定意图并签字.

## 快速启动

```bash
# Install
npm install -g @cliangdev/conductor

# Authenticate (opens browser for Google sign-in)
conductor login

# Connect to a project and configure Claude Code integration
conductor init

# Start the background sync daemon
conductor start
```

然后在您的项目中打开 Claude 代码并运行 `/conductor:prd` 创建您的第一个 PRD.

## Claude 代码命令

| 命令 | 它会做什么 |
| --- | --- |
| `/conductor:prd` | 引导您使用 AI 编写 PRD —— 发现、 研究、 结构化输出 |
| `/conductor:implement` | 使用一个经核准的PRD并执行它——任务分解,平行子代理,PR创建 |
| `/conductor:fix` | 修复错误并审查公开公关的反馈——结构化摄取,调查,构建验证,并推进 |
| `/conductor:workflow` | 通过有指导的发现设计并创建导师工作流程——YAML自动化或生命周期状态图 |

这些命令在运行时自动安装 `conductor init` (项目级别)或在全球安装期间(用户级别,至 `~/.claude/`) (中文(简体) ).

## CLI 命令

| 命令 | 说明 |
| --- | --- |
| `conductor login` | 通过浏览器认证( Google OAuth) |
| `conductor logout` | 清除存储的证书 |
| `conductor init` | 连接到一个项目并设置 Claude Code MCP 集成 |
| `conductor start` | 启动背景同步守护进程 |
| `conductor stop` | 停止同步守护进程 |
| `conductor status` | 显示守护进程状态并同步队列 |
| `conductor doctor` | 请检查access-date=中的日期值 (帮助) Claude Code 集成 |
| `conductor config show` | 打印当前配置( API 密钥已编辑) |
| `conductor config set-url <url>` | 未重拍的 hot- swap API URL |
| `conductor dashboard` | 守护进程现场终端视图, 同步队列, 活动工作流程运行 |
| `conductor lint [issueId]` | 验证本地工作项目文件 |
| `conductor mcp` | 运行 MCP 服务器( stdio) —— 连接到 Claude 代码 `conductor init` |

## MCP 工具

一次 `conductor init` claude Code通过导电器MCP服务器访问40个工具

| 区域 | 工具 |
| --- | --- |
| 工作项目 | `create_work_item`, (中文(简体) ), `update_work_item`, (中文(简体) ), `get_work_item`, (中文(简体) ), `list_work_items`, (中文(简体) ), `set_work_item_status`, (中文(简体) ), `get_available_transitions`, (中文(简体) ), `transition_work_item`, (中文(简体) ), `list_work_item_comments`, (中文(简体) ), `record_asset` |
| 文档 | `write_document` (无头而起), `scaffold_document` (本地文件,需要守护进程), `delete_document` |
| 工作流量 | `list_workflows`, (中文(简体) ), `create_workflow`, (中文(简体) ), `get_workflow`, (中文(简体) ), `update_workflow`, (中文(简体) ), `publish_workflow`, (中文(简体) ), `delete_workflow`, (中文(简体) ), `dispatch_workflow`, (中文(简体) ), `cancel_workflow_run`, (中文(简体) ), `get_workflow_run`, (中文(简体) ), `list_workflow_runs`, (中文(简体) ), `list_workflow_secrets`, (中文(简体) ), `get_workflow_step_schema`, (中文(简体) ), `report_step_run` |
| 整合和发现 | `list_integration_tools`, (中文(简体) ), `list_connector_catalog`, (中文(简体) ), `list_agents`, (中文(简体) ), `create_agent`, (中文(简体) ), `update_agent`, (中文(简体) ), `delete_agent`, (中文(简体) ), `list_skills`, (中文(简体) ), `register_skill` |
| 知识 | `submit_knowledge_source`, (中文(简体) ), `read_knowledge_sources`, (中文(简体) ), `search_knowledge`, (中文(简体) ), `read_knowledge_pages`, (中文(简体) ), `write_knowledge_pages`, (中文(简体) ), `list_knowledge_domains`, (中文(简体) ), `suggest_knowledge_domain` |

工具描述嵌入了使用合同(发现时创建,动作-验证)——见 [文件/mcp-工具-指南](https://npmcn.com/package/%40cliangdev/docs/mcp-tool-guidelines.md)。 。 。 .

## 链接

-   **GitHub 图像**数字 : [github.com/cliangdev/导体](https://github.com/cliangdev/conductor)
-   **网络应用**数字 : [指挥-前端 199707291514.us-central1.run.app](https://conductor-frontend-199707291514.us-central1.run.app/)

* * *

## 贡献者和地方发展

### 本地编程

本地堆栈运行于 `http://localhost:8090` (后端)和 `http://localhost:3000` (前端)带有电子邮件/密码认证——不需要Firebase.

```bash
# First-time login against local stack
CONDUCTOR_API_URL=http://localhost:8090 conductor login --local
# Default credentials: dev@example.com / conductor

# Verify
conductor config show
conductor doctor
```

本地和 prod 之间的切换 :

```bash
conductor config set-url http://localhost:8090   # local
conductor config set-url <prod-url>              # prod
```

### 从源头构建

```bash
cd conductor-tools
npm install
npm run build
npm link          # makes `conductor` available globally
```

### 配置

`~/.conductor/config.json`数字 :

```json
{
  "apiUrl": "https://...",
  "apiKey": "...",
  "email": "user@example.com",
  "projectId": "...",
  "localPath": "/path/to/project"
}
```

覆盖 API URL : `CONDUCTOR_API_URL=http://localhost:8090 conductor login --local`

### 测试

见 [试验. md](https://npmcn.com/package/%40cliangdev/conductor/TESTING.md) 用于CLI和MCP对活体的端到端测试程序.

## 常见问题

### @cliangdev/conductor 是什么？

Agentic软件开发平台——AI驱动的PRD,执行等

### 如何安装 @cliangdev/conductor？

在项目目录运行 npm install @cliangdev/conductor，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 conductor，可以用 npx conductor 直接运行。

### @cliangdev/conductor 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cliangdev/conductor 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cliangdev/conductor 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.14\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cliangdev/conductor 可以商用吗？

@cliangdev/conductor 使用 SEE LICENSE IN \.\./LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @cliangdev/conductor 的下载量有多少？

根据 npm 官方下载统计，@cliangdev/conductor 在 2026/10/10 – 2026/11/08 这 30 天内被下载 7,521 次，日均约 251 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cliangdev/conductor 还在维护吗？

最新版本 0\.53\.2 发布于 2026/11/08（1 天前）；至今共发布 88 个版本，其中过去 12 个月发布了 88 个；首次发布于 2026/04/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。