task-conductor-plugin

在 Pi、dsh、Claude Code 和 Codex 中安装、配置并通过原生 MCP 工具使用 Task Conductor

Packages

Package details

extensionskill

Install task-conductor-plugin from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:task-conductor-plugin

Package: task-conductor-plugin
Version: 0.2.0
Published: Nov 8, 2026
Downloads: 1,466/mo · 961/wk
Author: realqiyan
License: MIT
Types: extension, skill
Size: 170.1 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./pi-extension.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Task Conductor 宿主接入

为 Pi、dsh、Claude Code 和 Codex 提供 using-task-conductor 技能、启动检查及 MCP 接入。服务包 task-conductor 与插件包 task-conductor-plugin 分别安装。

安装接入包

服务及非 dsh 接入要求 Linux/macOS、Node.js 22.19+ 与 npm。dsh 要求 Node.js 24.9+，插件安装命令还需要 pnpm；最低宿主版本见 package.json。

Pi、Claude Code 和 Codex 的安装入口：

pi install npm:task-conductor-plugin

claude plugin marketplace add https://raw.githubusercontent.com/realqiyan/task-conductor/master/.claude-plugin/marketplace.json
claude plugin install task-conductor@task-conductor --scope user

codex plugin marketplace add realqiyan/task-conductor --sparse .agents/plugins
codex plugin add task-conductor@task-conductor

dsh 使用本地插件 tarball。在源码仓库根目录打包，输出目录须已存在；将 existing-profile 换成已有目标 profile：

node scripts/pack-plugin.mjs /absolute/artifacts
dsh plugin --profile existing-profile add /absolute/artifacts/task-conductor-plugin-0.2.0.tgz

从目标项目目录重开 profile。服务本地构建、源码插件安装及开发 marketplace 见宿主接入说明。

使用入口

宿主	调用技能
Pi	`/skill:using-task-conductor`
dsh	`/using-task-conductor` 或原生 `skill` 工具
Claude Code	`/task-conductor:using-task-conductor`
Codex	`$using-task-conductor` 或 `/skills`

技能沿用已有安装与配置约定，指导 setup 和连接。凭据在用户终端或私有文件中处理。Pi 在 setup 后注册 MCP；Claude/Codex 使用插件声明的连接；dsh 为根会话建立 MCP，使用 /task-conductor status 查看、/task-conductor connect 重连。服务尚未准备时仍可调用技能。

启动检查读取初始化状态和后台版本，异常时提供技能入口。Codex 的 hook 需先在 /hooks 中审查并信任。自定义程序、home 及各宿主连接步骤见安装与连接。

dsh Web 侧栏的“任务控制台”面板（位于“期权工作台”下方）提供同一套任务、执行端与服务配置页面。管理员 API 须已启用；首次进入粘贴 task-conductor console token 输出的令牌。浏览器请求经 dsh 宿主转发到本机服务，令牌可保存到本机 dsh 凭据，刷新页面后自动连接；取消“记住令牌”或断开连接即清除。插件配置可选 console.command 与 console.home，默认沿用 TASK_CONDUCTOR_PREFLIGHT_COMMAND 与 TASK_CONDUCTOR_PREFLIGHT_HOME。

任务与通知

Pi TUI/RPC 持久会话和 dsh 根会话自动接收任务通知，忙碌时排队，关闭后恢复原会话可补读。首次提交在项目目录保存 .task-conductor/project.json，fork 使用独立归属。Claude/Codex 当前使用 MCP 主动查询进度。

通知配置见安装参考，投递机制见通知说明。

使用引导

卸载插件后，共享服务和已提交任务继续运行，历史数据保留。后台管理使用 setup 时的同一 home。