@mzzsfy/dsh-rs-workflow 0.2.4 → 1.0.0

package/lib/preset-sync.mjs

@@ -1,227 +0,0 @@
-/**
- * preset-sync — 把包内 preset/rs-workflow 幂等同步到用户 preset 根。
- *
- * 职责:
- *   - sync:递归拷贝包内 preset/rs-workflow → <dsh-home>/.agent-presets/rs-workflow,
- *     并写入来源标记(marker),供排查"选择器里 broken 的 preset 来自哪个包"。
- *   - 所有权防线:目标目录存在但 marker 缺失或归属他人时拒绝覆盖(可能是用户手工
- *     安装或本地定制的同名 preset),告警后原样保留。
- *   - 仅在插件 apply 时运行:dsh 每次启动同步一次,升级包后重启即更新。
- *     卸载场景受 pnpm 限制(依赖的 preuninstall 脚本一律不执行,实验证实),
- *     无法自动删除,残留 preset 因 tool 行 import 失败在选择器显示 broken;
- *     手动清理命令见包 README。
- */
-import { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
-const PRESET_SRC = join(PKG_ROOT, 'preset', 'rs-workflow')
-const USER_PRESET_DIR = '.agent-presets'
-const PRESET_ID = 'rs-workflow'
-const MARKER_NAME = '.dsh-rs-workflow-source.json'
-const PACKAGE_NAME = '@mzzsfy/dsh-rs-workflow'
-// slots.json5 是文档引导的用户后备编辑点:rewrite 前若其内容异于包内模板,
-// 备份到 home 根的该文件名,重写后恢复,升级不再静默吞掉手工定制
-const SLOTS_REL = join('skills', 'rs-workflow', 'slots.json5')
-const USER_SLOTS_BACKUP = 'rs-workflow.slots.user.json5'
-// 完整性清单:任一缺失即视为残缺,走重写自愈(与 PRESET_SRC 产物对齐)
-const MANAGED_FILES = [
-  'preset.yml',
-  'agent.cordis.yml',
-  join('skills', 'rs-workflow', 'SKILL.md'),
-  SLOTS_REL,
-  join('skills', 'rs-workflow', 'references', 'engine.js'),
-  join('skills', 'rs-workflow', 'references', 'templates.md'),
-]
-
-/** dsh home:CLI 配置层可显式指定,插件环境只见 $DSH_HOME;空串视同未设 */
-function dshHome() {
-  const fromEnv = process.env.DSH_HOME
-  return fromEnv && fromEnv.trim().length > 0 ? resolve(fromEnv) : join(homedir(), '.dsh')
-}
-
-/** 释放目标绝对路径(诊断用:home 错位时可直接从日志/测试定位) */
-export function presetDest() {
-  return join(dshHome(), USER_PRESET_DIR, PRESET_ID)
-}
-
-// 版本读取容错:package.json 恰逢包管理器替换窗口或损坏时不让包整体加载失败,
-// marker 的 version 字段恒有确定语义(缺失/非字符串归一 unknown)
-let PKG_VERSION = 'unknown'
-try {
-  const parsed = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8')).version
-  if (typeof parsed === 'string' && parsed.length > 0) PKG_VERSION = parsed
-} catch { /* 保留 unknown */ }
-
-/** 源目录内容指纹:文件名集合 + 逐文件 size 与 mtime 的聚合。粒度足够感知
- *  同版本内容改动与产物残缺,不引入 hash 依赖 */
-function sourceFingerprint() {
-  const parts = []
-  const walk = (dir, rel) => {
-    for (const name of readdirSync(dir)) {
-      const full = join(dir, name)
-      const relPath = rel ? `${rel}/${name}` : name
-      const st = statSync(full)
-      if (st.isDirectory()) walk(full, relPath)
-      else parts.push(`${relPath}:${st.size}:${st.mtimeMs}`)
-    }
-  }
-  walk(PRESET_SRC, '')
-  return parts.sort().join('|')
-}
-
-/** 读 marker;缺失或损坏返回 null(损坏与缺失同义:无法证明归属) */
-function readMarker(dest) {
-  const markerPath = join(dest, MARKER_NAME)
-  if (!existsSync(markerPath)) return null
-  try {
-    return JSON.parse(readFileSync(markerPath, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/** 完整性校验:受管文件任一缺失即残缺 */
-function isComplete(dest) {
-  return MANAGED_FILES.every((rel) => existsSync(join(dest, rel)))
-}
-
-/** 同步释放;返回 'created' | 'updated' | 'unchanged' | 'skipped-foreign' */
-export function syncPreset() {
-  if (!existsSync(PRESET_SRC)) throw new Error(`包内 preset 缺失: ${PRESET_SRC}`)
-  const dest = presetDest()
-  // staging 残留清理与快慢路径无关:硬崩溃后仅 rewrite 清理会让残留长期滞留
-  cleanStaleStaging(dirname(dest))
-  if (!existsSync(dest)) return rewrite(dest, false)
-  const marker = readMarker(dest)
-  if (marker === null || marker.package !== PACKAGE_NAME) return 'skipped-foreign'
-  // 内容指纹一致即视为最新:双副本 root 交替不再触发整目录重写,
-  // 仅 marker.root 归属不同时原地改写 marker 一个文件
-  if (marker.fingerprint === sourceFingerprint() && isComplete(dest)) {
-    if (marker.root !== PKG_ROOT) {
-      writeFileSync(join(dest, MARKER_NAME), JSON.stringify({ ...marker, root: PKG_ROOT }, null, 2) + '\n')
-    }
-    return 'unchanged'
-  }
-  return rewrite(dest, true)
-}
-
-/** 已确认归属本包后的重写。换入式原子替换:旧目录先 rename 到备份名,新目录
- *  rename 入位成功后才删备份;换入失败时尽力还原,还原也失败则把旧副本改名为
- *  orphan 前缀(不匹配清理规则,永不被自动删除)并告警,绝不静默销毁。 */
-function rewrite(dest, existed) {
-  mkdirSync(dirname(dest), { recursive: true })
-  const staging = mkdtempSync(join(dirname(dest), '.rs-workflow-staging-'))
-  const backup = join(dirname(dest), `.rs-workflow-old-${Date.now()}`)
-  let orphan = null
-  try {
-    cpSync(PRESET_SRC, join(staging, 'out'), { recursive: true })
-    writeFileSync(join(staging, 'out', MARKER_NAME), JSON.stringify({
-      package: PACKAGE_NAME,
-      version: PKG_VERSION,
-      root: PKG_ROOT,
-      fingerprint: sourceFingerprint(),
-    }, null, 2) + '\n')
-    backupUserSlots(dest)
-    restoreUserSlots(join(staging, 'out'))
-    const hasDest = existsSync(dest)
-    if (hasDest) renameSync(dest, backup)
-    try {
-      renameSync(join(staging, 'out'), dest)
-    } catch (error) {
-      if (hasDest) {
-        try {
-          renameSync(backup, dest)
-        } catch (restoreError) {
-          // dest 缺失且旧副本留存:改用清理规则不匹配的 orphan 前缀,保留待人工处置
-          orphan = join(dirname(backup), `.rs-workflow-orphan-${Date.now()}`)
-          try {
-            renameSync(backup, orphan)
-          } catch {
-            orphan = backup
-          }
-          console.warn(`[rs-workflow] preset 换入失败且还原失败,旧目录保留在 ${orphan}(不会被自动清理,需人工处置)`)
-        }
-      }
-      throw error
-    }
-  } finally {
-    rmSync(staging, { recursive: true, force: true })
-    if (orphan === null) rmSync(backup, { recursive: true, force: true })
-  }
-  return existed ? 'updated' : 'created'
-}
-
-/** 用户改过的 slots.json5 在重写前备份;已回退到模板内容时清除旧备份,防陈旧定制复活 */
-function backupUserSlots(dest) {
-  const userSlots = join(dest, SLOTS_REL)
-  const template = join(PRESET_SRC, SLOTS_REL)
-  const backupPath = join(dshHome(), USER_SLOTS_BACKUP)
-  if (!existsSync(userSlots)) return
-  let userText
-  try {
-    userText = readFileSync(userSlots, 'utf8')
-  } catch {
-    return
-  }
-  let templateText = ''
-  try {
-    templateText = readFileSync(template, 'utf8')
-  } catch { /* 模板不可读视同定制, 保留现有备份 */ }
-  if (userText === templateText && templateText !== '') {
-    rmSync(backupPath, { force: true })
-    return
-  }
-  writeFileSync(backupPath, userText)
-}
-
-/** 待换入目录的 slots 若为模板内容且 home 有备份,写入用户定制;
- *  恢复随换入原子完成,dest 不再出现"模板+待恢复"中间态(崩溃窗口与复活窗口同消) */
-function restoreUserSlots(stagingOut) {
-  const backupPath = join(dshHome(), USER_SLOTS_BACKUP)
-  if (!existsSync(backupPath)) return
-  const userSlots = join(stagingOut, SLOTS_REL)
-  if (!existsSync(userSlots)) return
-  let userText
-  try {
-    userText = readFileSync(userSlots, 'utf8')
-  } catch {
-    return
-  }
-  let templateText = ''
-  try {
-    templateText = readFileSync(join(PRESET_SRC, SLOTS_REL), 'utf8')
-  } catch { /* 模板不可读时无法判定, 不动作 */ }
-  if (templateText !== '' && userText === templateText) {
-    writeFileSync(userSlots, readFileSync(backupPath, 'utf8'))
-  }
-}
-
-/** 清理硬崩溃残留的 staging/备份目录(前缀为本包独占,直接删安全);避免预设扫描把它们当 broken preset 展示 */
-function cleanStaleStaging(parentDir) {
-  let entries = []
-  try {
-    entries = readdirSync(parentDir)
-  } catch {
-    return
-  }
-  for (const name of entries) {
-    if (name.startsWith('.rs-workflow-staging-') || name.startsWith('.rs-workflow-old-')) {
-      rmSync(join(parentDir, name), { recursive: true, force: true })
-    }
-  }
-}
-
-/** 删除本包释放的 preset(仅供维护脚本/手工调用,插件生命周期内不触发)。
- *  返回三态:'removed' 已删 | 'missing' 目录不存在 | 'foreign' 外来目录拒绝删除 */
-export function removePreset() {
-  const dest = presetDest()
-  if (!existsSync(dest)) return 'missing'
-  const marker = readMarker(dest)
-  if (marker === null || marker.package !== PACKAGE_NAME) return 'foreign'
-  rmSync(dest, { recursive: true, force: true })
-  cleanStaleStaging(dirname(dest))
-  return 'removed'
-}

package/preset/rs-workflow/agent.cordis.yml

@@ -1,196 +0,0 @@
-# The `rs-workflow` agent preset: 若水工作流。
-#
-# 迁移自 rs-tui (C:\Users\yuanhao\Desktop\jzjy\rscli) 的 rs-workflow 多模型协作工作流引擎。
-# 基底是 `standard` 全功能编码代理（本文件行集与出厂 standard 保持同构），
-# 差异有四处：
-#   1. persona 换成若水工作流纪律（非平凡需求走 workflow 编排）；
-#   2. skill-filesystem 追加预设自带技能目录 skills/（rs-workflow 协议技能随预设分发）；
-#   3. 追加 GUI 配置读取工具行 rs-workflow-config（@mzzsfy/dsh-rs-workflow
-#      的 tool 角色，裸包名从组合 baseUrl 上溯解析到 profile node_modules；
-#      GUI 表单注册在同包 settings 角色、bundle patch 行上；本文件整体由该包
-#      的 preset-sync 角色行释放到用户预设根，随插件安装/升级自动同步）；
-#   4. 其余行保持 standard 原样 —— 工具面不变，模式差异只由 persona + 技能承载。
-#
-# 平面规则与 standard 一致：本文件是 AGENT-PLANE 组合；服务行必须在 isolate realm 后面。
-
-# ── identity ────────────────────────────────────────────────────────────────
-
-- id: persona
-  name: '@deepseek-ai/dsh-persona'
-  config:
-    text: |-
-      你是"若水工作流"编码 Agent，由 {{model}} 模型驱动，工作目录 {{cwd}}。
-      本模式迁移自 rs-tui 的多模型协作工作流引擎：executor 执行、reviewer 审批、planner 规划分诊，模型间分工与相互制约。
-
-      核心纪律：
-      - 非平凡编码需求（多步骤、多文件、质量敏感或有回归风险）必须先加载 rs-workflow 技能，按其协议用 workflow 工具启动编排：分诊与规划 → 执行与审批 → 终审，必要时升级重规划。
-      - 琐碎请求（问答、解释、单点小改）直接处理，不空转流程（off 态）。用户点名模板（lite / plan-final / step-review / multi-plan）时锁定该模板。
-      - 各角色的模型由工作位（slot）配置决定：细分位缺失降级基础位，再降级会话默认模型；配置以 GUI 设置页 rs-workflow 段为准（启动编排前用 rs_workflow_config 工具读取，改后即时生效），工具不可用时回退技能目录的 slots.json5。
-      - 工作流结束后必须向用户完整汇报：模板、难度分诊、任务结果、审批结论、变更文件；blocked 时说明原因并给出建议。
-
-- id: agent-instructions
-  name: '@deepseek-ai/dsh-agent-instructions'
-  config:
-    maxBytes: 65536
-
-# ── shell ───────────────────────────────────────────────────────────────────
-
-# 与 standard 相同：两个 shell 工具消费 HOST 侧注册表，执行器也在 host 平面。
-- id: tool-bash
-  name: '@deepseek-ai/dsh-tool-bash'
-  disabled: !!js process.platform === 'win32'
-
-- id: tool-pwsh
-  name: '@deepseek-ai/dsh-tool-pwsh'
-  disabled: !!js process.platform !== 'win32'
-
-# ── filesystem ──────────────────────────────────────────────────────────────
-
-- id: tool-fs
-  name: '@deepseek-ai/dsh-tool-fs'
-
-- id: tool-fs-search
-  name: '@deepseek-ai/dsh-tool-fs-search'
-  config:
-    sampleOverCapGlobResults: false
-
-# ── background jobs ────────────────────────────────────────────────────────
-
-- id: tool-jobs
-  name: '@deepseek-ai/dsh-tool-jobs'
-
-# ── skills ──────────────────────────────────────────────────────────────────
-
-# 与 cordis 出厂预设相同的手法：customSkillDirs 指向预设自己的 skills/ 目录，
-# baseUrl 即预设目录本身，因此 rs-workflow 协议技能随预设安装、复制、迁移。
-- id: skill-filesystem
-  name: '@deepseek-ai/dsh-skill-filesystem'
-  config:
-    customSkillDirs:
-      - !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('skills/', baseUrl))"
-
-- id: tool-skill
-  name: '@deepseek-ai/dsh-tool-skill'
-
-# 若水工作流的 GUI 配置读取工具（rs_workflow_config）：主代理启动编排前调用。
-# 包本体由 `dsh plugin add @mzzsfy/dsh-rs-workflow` 安装进 profile node_modules；
-# 本 preset 文件由同包的 preset-sync 角色行在宿主启动时释放/同步到用户预设根。
-# 预设行的裸包名从组合 baseUrl（profile 目录）上溯解析；settings 表单的注册
-# 在同包 bundle patch 行上（见包内 cordis.patch.yml）。
-- id: rs-workflow-config
-  name: '@mzzsfy/dsh-rs-workflow'
-  config:
-    role: tool
-
-# ── goals ───────────────────────────────────────────────────────────────────
-
-- id: tool-goal
-  name: '@deepseek-ai/dsh-tool-goal'
-
-# ── plan mode ───────────────────────────────────────────────────────────────
-
-# 保留 standard 的计划模式：用户仍可把会话切到 plan 模式做前置规划，
-# 与工作流不冲突（工作流自身的规划发生在编排内部）。
-- id: planning
-  name: cordis:group
-  group: true
-  isolate:
-    planMode: true
-  config:
-    - id: plan-mode
-      name: '@deepseek-ai/dsh-plan-mode'
-      config:
-        section: |
-              You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
-
-              Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
-
-              The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
-
-              Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
-
-              Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
-
-              When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
-
-# ── compaction ──────────────────────────────────────────────────────────────
-
-- id: compaction
-  name: cordis:group
-  group: true
-  isolate:
-    compaction: true
-    toolResultPruner: true
-  config:
-    - id: compaction-basic
-      name: '@deepseek-ai/dsh-compaction-basic'
-
-    - id: command-compact
-      name: '@deepseek-ai/dsh-command-compact'
-
-    - id: tool-result-pruner
-      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
-      config:
-        thresholdChars: 8192
-        headChars: 4096
-        tailChars: 1024
-
-# ── delegation and workflows ────────────────────────────────────────────────
-
-# 与 standard 相同：subagents 注册表留在 HOST；workflowEngine 是预设私有服务，
-# 所有触达它的行共享一个 entry-local realm。
-- id: delegation
-  name: cordis:group
-  group: true
-  isolate:
-    workflowEngine: true
-  config:
-    - id: tool-subagent-control
-      name: '@deepseek-ai/dsh-tool-subagent-control'
-
-    - id: tool-subagent-list-agents
-      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
-
-    - id: tool-subagent
-      name: '@deepseek-ai/dsh-tool-subagent'
-      config:
-        provider: spawn
-        toolName: subagent
-        backgroundMode: continuable
-
-    - id: tool-subagent-fork
-      name: '@deepseek-ai/dsh-tool-subagent'
-      config:
-        provider: fork
-        toolName: subagent_fork
-        backgroundMode: continuable
-
-    - id: workflow-worker-thread
-      name: '@deepseek-ai/dsh-workflow-worker-thread'
-      config:
-        provider: spawn
-
-    - id: tool-workflow
-      name: '@deepseek-ai/dsh-tool-workflow'
-
-    - id: tool-ralph
-      name: '@deepseek-ai/dsh-tool-ralph'
-      config:
-        subagentProvider: spawn
-        maxRounds: 64
-
-# ── remaining model-facing rows ─────────────────────────────────────────────
-
-- id: tool-ask-user
-  name: '@deepseek-ai/dsh-tool-ask-user'
-
-- id: tool-todo
-  name: '@deepseek-ai/dsh-tool-todo'
-  config:
-    allowParallelInProgress: true
-
-- id: tool-web
-  name: '@deepseek-ai/dsh-tool-web'
-  config:
-    fetch: false
-    searchTimeoutMs: 60000

package/preset/rs-workflow/preset.yml

@@ -1,5 +0,0 @@
-name: 若水工作流
-description: >-
-  rs-tui 多模型协作工作流迁移版：planner/executor/reviewer 三角色子代理分工，
-  难度分诊四模板（lite / plan-final / step-review / multi-plan），
-  审批循环、升级重规划与工作位模型降级链；非平凡编码需求自动走工作流编排。

package/preset/rs-workflow/skills/rs-workflow/SKILL.md

@@ -1,110 +0,0 @@
----
-name: rs-workflow
-description: 若水多模型协作工作流。非平凡编码需求（多步骤/多文件/质量敏感/有回归风险）必须先加载本技能，按协议用 workflow 工具启动编排（planner 分诊规划 / executor 执行 / reviewer 审批，16 工作位，4 模板，预算化审批循环，升级重规划）。琐碎问答或用户明说"直接做"时不要加载。
----
-
-# 若水工作流 (rs-workflow)
-
-迁移自 rs-tui 的多模型协作工作流引擎。三角色分工：**planner** 规划分诊、**executor** 执行、**reviewer** 审批；引擎按模板蓝图调度 DAG 节点，审批循环与升级重规划由脚本保证。
-
-## 0. 职责边界（必读）
-
-你是主代理（leader），**不亲自执行工作流内的任务**。你只负责四件事：
-
-1. 判定是否进入工作流；
-2. 调用 rs_workflow_config 工具读取工作位（slot）与工作流默认配置；
-3. 用 workflow 工具启动编排脚本；
-4. 向用户汇报结果。
-
-执行、审批、规划全部由编排内的子代理完成。你不在工作流运行期间并行改动代码。
-
-## 1. 进入判定
-
-- **直接处理（off 态）**：纯问答/解释；用户明说"直接做/别走流程"；单文件、无风险的小改。
-- **进入工作流**：其余编码需求——多文件、多步骤、质量敏感、有回归风险、需要先规划的任务。
-- 用户点名模板（lite / plan-final / step-review / multi-plan）→ 作为 `lockedTemplate` 传入；未点名 → 由 planner 分诊选模板。
-- 用户想改角色模型/默认模板/预算 → 让用户在 GUI 设置页的 rs-workflow 段修改（改完即时生效）；GUI 不可用时才改 slots.json5。
-
-## 2. 启动步骤（严格按序）
-
-1. **读工作流配置**：调用 `rs_workflow_config` 工具，取回 `{ slots, workflow, budgets, source }`。它反映 GUI 设置页 rs-workflow 段的当前配置（3 基础+13 细分工作位模型绑定、默认模板、任务上限、预算）。工具不可用或 `source=fallback`（设置服务不可用）时，回退读本技能目录下的 `slots.json5`：JSON5 解析后**取其 `slots` 属性**作为下面的 `slots`（空字符串 = 未配置）；该后备文件只含 slots，此时 `defaultTemplate`/`limits`/`budgets` 一并省略，由引擎缺省值兜底。
-2. **勘察仓库（可选）**：把与需求相关的要点（目录结构、相关文件、构建/测试命令）写进 `contextNotes`，不超过 30 行；已经熟悉仓库可传空字符串。
-3. **读引擎脚本**：读本技能 Base directory 下 `references/engine.js` 的**全文**，作为 workflow 的 `script` 参数原样传入——不要改写、不要截断、不要"优化"。
-4. **调用 workflow 工具**，三个参数：
-   - `meta`：`{ name: "rs-workflow", description: "<一句话需求>", phases: [{title: "分诊与规划"}, {title: "执行与审批"}, {title: "升级重规划"}, {title: "汇总"}] }`
-   - `script`：engine.js 全文
-   - `args`：`{ request: <用户需求原话>, contextNotes: <第2步要点或空串>, slots: <第1步 slots，16 键>, lockedTemplate: <见下>, defaultTemplate: <见下>, limits: <见下>, budgets: <见下>, prefix: <见下> }`
-     - `lockedTemplate`：仅用户点名了模板 → 传点名的；未点名省略，由引擎分诊定模板。
-     - `defaultTemplate`：第 1 步 `workflow.defaultTemplate` 原值（`auto` 也照传，引擎自行兜底 multi-plan）。
-     - `limits`：第 1 步 `workflow.maxTasks` 存在时传 `limits: { maxTasks: <值> }`。
-     - `budgets`：第 1 步 `budgets` 原样透传（审批/重问预算，字段见 §6）。
-     - 断点续跑（见 §4）：`prefix: <上轮已完成任务数组>`，元素取上轮返回 `tasks[]` 中 `status="done"` 且 `type="task"` 的 `{ id, description, output: <summary>, changedFiles }`（引擎返回的 tasks 字段名是 `summary`，映射为 prefix 元素的 `output`）；仅 lite / plan-final / step-review 生效，multi-plan 会忽略并记日志。
-5. 工作流在前台运行到结束才返回，等待期间不做其他改动。
-
-## 3. 汇报（工作流返回后，必做）
-
-用中文向用户汇报，依次包含：
-
-- 模板与难度分诊（complexity / risk / scope 三信号 + planner 理由；模板来源注明：引用返回 `templateSource` 字段——`locked`（用户/配置锁定）、`declared`（planner 声明采纳）、`matrix`（引擎矩阵裁定）、`default-fallback`（无信号兜底））；
-- 每个任务的结果与执行摘要；
-- 审批结论（计划审 / 逐步审 / 子计划审 / 终审 / 交叉终审链），逐项附：审批证据要点（reviewer 实际执行的检查与结果）、范围核查结果（是否发现申报清单外且不属于其他任务申报范围的越界文件）、审批者故障披露（引用返回 `reviews[].reviewerFault: true` 的条目——含义是引擎已把该审批按拒绝处理：审批者不可用或 APPROVED 缺证据预算耗尽折算，交付型可原样重交、计划型转计划重规划；leader 只披露，不自行重交）；multi-plan 模板按蓝图返回 `reviews`：大纲审（pr）→ 各子计划单元内逐步审（r-*）与子计划审（sr）→ 交叉终审串行链 xr1/xr2（均挂 `reviewer-cross` 位，xr1 审正确性、xr2 审边界与安全，xr2 依赖 xr1 通过，任一拒绝回跳最后一个已完成 task 重做后重挂）；blocked 时的返回中未运行到的审批 `verdict` 为 `UNREVIEWED`，如实报"未运行到"，不冒充通过或驳回；
-- 变更文件清单；
-- 升级重规划次数、换模型重做情况（slot 配了候选数组/rotation 时）、本次是否以 prefix 续跑及续跑任务数；blocked 时原因与建议（锁定更重的模板重跑 / 缩小需求范围 / 补充信息）。
-
-汇报前运行一次仓库验证（构建/测试）确认工作区真实状态，再交用户验收。
-
-## 4. 故障处置
-
-- workflow 调用报错（脚本被杀 / caps 超限）：读错误信息；保存上一次返回的 `tasks` 与 `reviews`（必要时含 `blocked`），把 `tasks[]` 中 `status="done"` 且 `type="task"` 的条目按 §2 第 4 步的 prefix 契约整理为数组重新调用 workflow 续跑——不缩 maxTasks、不重做已完成工作；取不回上轮结果时降级为主代理直接实现，并向用户声明"工作流引擎故障，已降级直发"。
-- 返回 `ok: false` 且 `blocked`：如实汇报，不粉饰；可按上一条以 prefix 续跑剩余工作，或缩小需求范围重跑。
-
-## 5. 工作位（slot）降级链
-
-3 基础位：`planner` / `executor` / `reviewer`。13 细分位未配置时降级到同域基础位，基础位未配置时降级到会话默认模型（细分位 → 基础位 → 会话默认模型）：
-
-| 细分位 | 降级到 | 用途 |
-|---|---|---|
-| `planner-triage` | `planner` | 首次分诊：分析需求选模板拆任务（建议快而便宜的模型） |
-| `planner-command` | `planner` | 总规划：制定整体方案 / 拆子计划大纲；计划被拒后的计划重写 |
-| `planner-subplan` | `planner` | 子计划细化：子计划内的计划 |
-| `planner-escalate` | `planner` | 升级重规划：连续拒绝超阈后的尾段重拆 / 返工重规划 |
-| `reviewer-plan` | `reviewer` | 计划审批：审批计划文本（计划审 / 大纲审，中等推理即可） |
-| `reviewer-task` | `reviewer` | 任务审批：审批单个任务执行结果 |
-| `reviewer-subplan` | `reviewer` | 子计划交付审批：审批整个子计划交付 |
-| `reviewer-final` | `reviewer` | 单终审：末尾终审全部交付（建议最强推理的模型） |
-| `reviewer-cross` | `reviewer` | 交叉终审：多视角交叉终审链（建议最强推理的模型） |
-| `executor-task` | `executor` | 任务首次执行 |
-| `executor-enhance` | `executor` | 被拒重做：携带 REJECTED 理由修改重交（可配数组实现换模型重做） |
-| `executor-retry` | `executor` | 失败重试：自报失败 / 无凭证后的重试 |
-| `executor-escalate` | `executor` | 升级后执行：升级重规划产出的新任务 |
-
-配好后引擎按节点语境自动选位：任务首执行=`executor-task`、被拒重做=`executor-enhance`、失败重试=`executor-retry`、升级新任务=`executor-escalate`、计划审=`reviewer-plan`、任务审=`reviewer-task`、子计划审=`reviewer-subplan`、终审=`reviewer-final`、交叉终审=`reviewer-cross`、分诊=`planner-triage`、计划重写=`planner-command`、子计划细化=`planner-subplan`、升级重规划=`planner-escalate`。
-
-值格式：`"provider/model"` 字符串、候选数组 `["a/m1", "b/m2"]`、`{ rotation: ["a/m1", "b/m2"] }`（前三态与 GUI 设置 schema 一致）或 `{ provider, model }` 对象（引擎兼容形态，GUI 配置路径不可产出）：单候选/rotation 内失效时依次故障转移，被拒重做与审批重问从下一候选换模型（节点级游标轮换）。必须是当前部署模型路由里真实存在的目标。适配红线：reviewer 弱于 executor = 审批形同虚设。配置来源优先级：GUI 设置页 rs-workflow 段（`rs_workflow_config` 工具读取，即时生效）> 本技能目录 `slots.json5`（后备）> 会话默认模型。
-
-## 6. 模板与阈值（细节见 references/templates.md）
-
-| 模板 | 形态 |
-|---|---|
-| lite | 单发终审：单任务直干，末尾终审一次 |
-| plan-final | 计划审 + 终审：前置总计划（pr 计划审通过才执行），末尾终审 |
-| step-review | 计划审 + 逐步审：前置总计划（pr），每任务执行完即审，通过才放行下一步 |
-| multi-plan | 大纲审 + 子计划审 + 交叉终审链：总规划拆子计划大纲（pr 大纲审），子计划单元逐个细化执行（子计划内逐步审 + 子计划交付审），末尾交叉终审串行链 xr1（正确性）→ xr2（边界与安全） |
-
-阈值（budgets 四字段，GUI/slots.json5 可配，clamp [1,10]，缺省 2/2/3/3）：`reviewRejectBeforeEscalate`=2（交付型审批对象连续被拒或失败达此值 → 升级）、`planRejectBeforeBlocked`=2（计划型审批对象连续被拒达此值 → 升级）、`emptyOutputRetryLimit`=3（审批缺验证证据时的重问上限，超限视为拒绝）、`reportNudgeLimit`=3（executor 返回 completed 但交接摘要空白时的补救追问上限）；升级重规划累计 `ESCALATION_LIMIT`=**2** 次 → blocked（固定，不可配）。审批通过清零规则：交付类审批（逐步审/子计划审/终审/交叉终审）通过清零升级账，计划审批通过只放行不清零。审批 fail-closed：审批者不可用视为拒绝（交付型可原样重交，计划审/大纲审带此原因转计划重规划），APPROVED 必须附验证证据。
-
-分诊口径：缺失信号按 low/small 降级（planner 未标注的信号视为不存在）；三信号全缺 → 按 `defaultTemplate` 兜底（`auto`/缺省 → multi-plan）；planner 可在计划中声明模板，合法才采纳，非法仍落引擎矩阵兜底。
-
-拆解与审批基准：planner 拆解时每任务可带 acceptance（可独立验证的验收判据）与 files（预期触达文件，作范围核查申报基线），任务描述禁止占位措辞（TBD/"适当处理"/"同任务 N"式描述视为计划缺陷）；任务审批基准为可判定清单——只审本任务改动，每条判据须带可核证据（测试名/命令输出/file:line），不确定写明；审批结论可带 severity（critical/important/minor），仅丰富报告、不作通过门控（APPROVED/REJECTED + evidence 契约不变），critical 问题必须进 reasons；带 fixNote 的复审只判定驳回点是否解决与是否引入新问题，不扩大审查范围。
-
-## 7. 庞大需求分阶段编排
-
-单次 workflow 有规模上限（全局任务预算 `maxTasks` / 代理数 caps），超大需求不硬塞单次编排，改用分阶段协议：
-
-- **触发**：分诊 `scope=large` 且拆解触达全局任务预算 `maxTasks`、上轮 blocked 且建议缩小范围，或用户明说"分阶段做"。
-- **动作**：
-  1. leader 先产出阶段大纲（把需求划分为若干可独立验收的 phase，每个 phase 一个明确目标与验收标准）；用 goal 工具（`create_goal`）把总目标固化为持久目标，由 goal 轮次自动续跑推进；
-  2. 逐 phase 调用 workflow（§2 流程，`request` 写该 phase 的目标与验收标准，`contextNotes` 带上仓库要点与上一 phase 的产物摘要）；
-  3. 每个 phase 返回后向用户简报该 phase 结果，goal 轮次自动续跑下一 phase；
-  4. 某 phase blocked → 用 goal 工具如实标记 blocked（`update_goal`，附原因），带原因与建议，不缩小总目标范围。
-- **注意**：多 phase 共享同一工作区，phase 划分必须文件域互斥或串行依赖明确；每 phase 用什么模板由该 phase 的分诊矩阵裁定，用户可点名。