JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 346
  • Score
    100M100P100Q122916F
  • License UNLICENSED

pm-workflow 的可发布 OpenCode 插件包实现（server + tui + shared package-first implementation）。

Package Exports

  • @walke/opencode-pm-workflow
  • @walke/opencode-pm-workflow/index
  • @walke/opencode-pm-workflow/server
  • @walke/opencode-pm-workflow/shared
  • @walke/opencode-pm-workflow/tui

Readme

opencode-pm-workflow

当前状态：已完成包内化、模块化拆分，并已具备独立 npm 插件运行、dist 构建与发布前校验能力。

目的

为 pm-workflow 提供一个可发布、可迁移、可独立安装的 OpenCode 插件包实现。

当前状态

当前包已经完成核心运行逻辑的包内化与模块化拆分，且已具备 dist 构建能力；运行时不再依赖本机 skills/pm-workflow 目录或其中的 Python 脚本：

  • src/server.ts → 兼容转发入口，真实装配位于 src/server/plugin.ts
  • src/tui.ts → 兼容转发入口，真实装配位于 src/tui/plugin.ts
  • src/shared.ts → 纯 re-export 入口，真实逻辑已分散到 core/* 与 orchestrator/*

这样做的目标是固定 npm 包边界，让插件可以通过 @walke/opencode-pm-workflow@latest 独立安装与运行。

当前进度：

  • server：已完成模块化（runtime/hooks/tools/plugin）
  • tui：已完成模块化（plugin/toasts/commands）
  • shared：已收敛为纯导出入口
  • dist：已可本地构建
  • 当前推荐运行入口：OpenCode plugin 配置中的 @walke/opencode-pm-workflow@latest
  • legacy plugins/pm-workflow-*.ts 兼容壳仅用于旧环境迁移，推荐停用以避免重复加载

当前源码结构

当前源码已经按职责分层，后续排查时建议优先按下面的目录定位：

src/
├─ core/
│  ├─ config.ts
│  ├─ doctor.ts
│  ├─ gates.ts
│  ├─ history.ts
│  ├─ migration.ts
│  ├─ project.ts
│  ├─ receipts.ts
│  ├─ recovery.ts
│  ├─ state.ts
│  └─ types.ts
├─ orchestrator/
│  ├─ plan.ts
│  ├─ prompts.ts
│  └─ safety.ts
├─ server/
│  ├─ plugin.ts
│  ├─ runtime.ts
│  ├─ hooks.ts
│  └─ tools/
│     ├─ admin-tools.ts
│     ├─ diagnostic-tools.ts
│     ├─ dispatch-tools.ts
│     ├─ execution-tools.ts
│     └─ state-tools.ts
├─ tui/
│  ├─ plugin.ts
│  ├─ toasts.ts
│  └─ commands.ts
├─ index.ts
├─ server.ts
├─ shared.ts
└─ tui.ts

说明：

  • src/server.ts / src/tui.ts 现在是兼容转发入口
  • src/server/plugin.ts / src/tui/plugin.ts 是实际装配入口
  • src/shared.ts 是集中导出入口，不再承载内联实现

导出约定

当前包同时提供：

  • 发布主入口：dist/index.js
  • 发布子路径入口：./server、./tui、./shared
  • 开发源码入口：src/index.ts
  • 兼容导出：default

根入口会：

  • 命名导出 pmWorkflowServerPlugin
  • 命名导出 pmWorkflowTuiPlugin
  • 保留 default 指向 server 入口，便于当前阶段兼容已有加载习惯

发布时实际暴露的是：

  • package.json#main -> ./dist/index.js
  • package.json#exports -> ./dist/*

因此：

  • src/* 仅用于开发与本地调试
  • dist/* 才是发布与消费入口

预期使用方式

未来可以按三种方式接入：

1. 当前开发态：源码入口

{
  "plugin": [
    "./packages/opencode-pm-workflow/src/index.ts"
  ]
}

适用场景：

  • 本地开发
  • 调试包内源码
  • 不依赖 dist 产物时

2. 本地构建态：dist 入口

先构建：

npm run --prefix packages/opencode-pm-workflow prepare-publish

然后使用构建产物：

{
  "plugin": [
    "./packages/opencode-pm-workflow/dist/index.js"
  ]
}

3. 发布后按包名接入

{
  "plugin": [
    "@walke/opencode-pm-workflow@latest"
  ]
}

也可以在 OpenCode opencode.json 中传入可选初始配置。该配置只用于首次生成项目内 .pm-workflow/config.json，后续项目自己的 .pm-workflow/config.json 仍是运行时事实来源：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    [
      "@walke/opencode-pm-workflow@latest",
      {
        "config": {
          "automation": {
            "mode": "observe"
          },
          "permissions": {
            "allow_execute_tools": false,
            "allow_repair_tools": true,
            "allow_release_actions": false
          },
          "confirm": {
            "require_confirm_for_execute": true
          },
          "agents": {
            "enabled": true,
            "default_mode": "primary",
            "dispatch_map": {
              "pm": "pm_workflow_pm",
              "plan": "plan",
              "build": "build",
              "qa_engineer": "pm_workflow_qa",
              "writer": "pm_workflow_writer"
            },
            "definitions": {
              "pm_workflow_pm": {
                "model": "openai/gpt-5.5",
                "fallback_models": ["openai/gpt-5.4"],
                "temperature": 0.2
              },
              "plan": {
                "model": "openai/gpt-5.4",
                "fallback_models": ["openai/gpt-5.4-mini"],
                "temperature": 0.1
              },
              "build": {
                "model": "openai/gpt-5.4",
                "fallback_models": ["openai/gpt-5.4-mini"],
                "temperature": 0.2
              },
              "pm_workflow_qa": {
                "model": "openai/gpt-5.4",
                "fallback_models": ["openai/gpt-5.4-mini"],
                "temperature": 0.1
              },
              "pm_workflow_writer": {
                "model": "openai/gpt-5.4-mini",
                "fallback_models": ["openai/gpt-5.4"],
                "temperature": 0.3
              }
            }
          },
          "docs": {
            "storage_mode": "project_scoped",
            "read_legacy": true,
            "write_legacy": false
          }
        }
      }
    ]
  ]
}

项目配置 schema 随包发布：

  • pm-workflow.schema.json
  • pm-workflow.config.example.json

插件会通过 OpenCode config hook 自动注入 workflow agents：

  • pm_workflow_pm
  • plan
  • build
  • pm_workflow_qa
  • pm_workflow_writer

其中 pm_workflow_pm、pm_workflow_qa、pm_workflow_writer 会带默认 prompt 与权限；plan、build 默认沿用 OpenCode 内置 agent，只有当你在 agents.definitions 中配置模型或权限时才覆盖。agents.dispatch_map 负责把内部角色 pm / qa_engineer / writer 映射到这些 namespaced agent，避免覆盖用户已有的同名 agent。fallback_models 会生成 pm_workflow_pm_fallback_1、build_fallback_1 这类 fallback agent，并接入 pm-workflow 的 fallback 执行策略。

构建命令

npm run --prefix packages/opencode-pm-workflow typecheck
npm run --prefix packages/opencode-pm-workflow build
npm run --prefix packages/opencode-pm-workflow prepare-publish
npm run --prefix packages/opencode-pm-workflow verify-release
npm run --prefix packages/opencode-pm-workflow check-auth

如果未来执行真正的：

npm publish

当前包还会自动触发：

prepublishOnly -> npm run verify-release

这样可以避免在发布前跳过本地校验。

发布前自检

当前已验证通过：

npm run --prefix packages/opencode-pm-workflow typecheck
npm run --prefix packages/opencode-pm-workflow build
npm pack --dry-run --prefix packages/opencode-pm-workflow

当前与第二阶段演进相关的只读能力也已具备：

  • pm-get-execution-plan：返回 ExecutionPlan v2 草案（只读，不执行）
  • pm-dry-run-dispatch：当前 dry-run 输出会附带 ExecutionPlan v2 预览
  • pm-dry-run-loop：当前 dry-run loop 输出会附带 ExecutionPlan v2 预览

真正执行发布前，还应先检查当前机器的 npm 登录态：

npm run --prefix packages/opencode-pm-workflow check-auth

npm pack --dry-run 当前包含：

  • dist/index.js
  • dist/server.js
  • dist/shared.js
  • dist/tui.js
  • README.md
  • package.json
  • tsconfig.json
  • tsconfig.build.json

这说明当前包已经具备本地发布前的基本面貌。

后续迁移建议

  1. 推荐在 OpenCode opencode.json 中只保留 @walke/opencode-pm-workflow@latest。
  2. 如果旧环境还存在 plugins/pm-workflow-*.ts 兼容壳，应停用或删除，避免和 npm 包重复加载。
  3. 本包运行时不依赖 skills/pm-workflow；review gate、pre-commit check、feedback signal 检测均为包内实现。
  4. 当前包已经具备本地 dist 构建能力，并已完成 typecheck、verify-release 与 npm pack --dry-run 验证。

第二阶段预览

当前已经开始第二阶段的低风险演进，但仍然保持“只读预览，不接管执行”：

  • 已补齐 DispatchPlan / DispatchCommand / ExecutionPlan 显式类型
  • 已提供 buildExecutionPlan(projectDir, prompt?)
  • 已支持按 action 输出不同 step 模板：
    • create-dev-plan
    • start-development
    • continue-development
    • run-code-review
    • prepare-release
  • 现阶段这些能力仅用于预览与 dry-run 展示，不会替换当前真实执行链路