@runweave/server-linux-x64 0.1.8 → 0.1.10

package/payload/plugins/toolkit/skills/runweave-change-validation/SKILL.md

@@ -0,0 +1,196 @@
+---
+name: runweave-change-validation
+description: 仅当用户在当前请求中显式指定 $toolkit:runweave-change-validation 时使用；不要因普通代码修改、Bug 修复、功能实现、重构、共享协议、服务生命周期、UI 或 CDP 验收自动触发。被显式调用后，根据真实 diff 通过 Dev Session 规划、启动、发现并清理隔离验证环境。
+---
+
+# Runweave 变更验证
+
+把 Dev Session 当作代码改完后的环境裁决器，而不是编码前猜测 profile 的工具。
+
+## 触发边界
+
+- 仅当用户在当前请求中显式点名 `$toolkit:runweave-change-validation` 时使用本技能。
+- 未显式点名时，不因代码修改、Bug 修复、功能实现、重构、运行行为、共享协议、服务生命周期、UI 或 CDP 验收而自动使用。
+- 显式调用只对当前请求有效，不跨请求或后续轮次延续。
+- “提交所有代码”、调用 `$toolkit:github-pr`，或 diff 涉及 UI、Backend、共享协议与服务生命周期，
+  都不构成显式调用。
+- 未调用本技能时，不执行本技能定义的 diff 规划、隔离 Worktree、Dev Session、UI/CDP 验收或
+  Before/After 取证。纯提交、推送或 PR 流程只处理 Git 操作自然触发的已有 hook 与远端 CI，
+  不从改动范围推导额外验证。
+
+## 必需技能
+
+- 实际执行任何 Dev Session planner、start、status、open、attach、recovery 或 stop 操作时，同时使用 `$toolkit:runweave-dev-session`。本技能负责 patch 边界、完整验收和证据合同；该技能负责准确的 Session 生命周期。
+- 因脏工作区需要创建、检查或移除隔离 Worktree 时，同时使用 `$toolkit:git-advanced-workflows`。本技能决定 patch 与验证时序；该技能负责 Git Worktree 的规范路径、身份检查和精确清理。
+
+## 不可变边界
+
+- 始终从 Stable terminal 执行命令；所有 Dev Session profile 都只是被测面。
+- 第一次 dry-run 不显式指定 profile。先让真实 diff 给出最低影响闭包。
+- 可以因用户明确的安装态、跨版本或桌面验收目标提升 profile；禁止向下降级或绕过 planner。
+- 未提交代码的验证环境只允许通过 `pnpm dev:session` 启动，并只用 `dev:status`、`dev:open`、`dev:stop` 管理生命周期。Agent 直接调用 Backend、App Server、Electron、Beta、手工 profile/端口或任何跳过 planner 的入口都视为绕过；Dev Session 内部调用的 adapter 不受此限制。
+- 当前工作区有无关改动时，使用只包含本次 patch 的独立 Worktree；新建路径固定为任务绑定父 Project 的 `<projectRoot>/.worktree/<validationName>` 直接子目录，禁止 `/tmp`、`/private/tmp`、仓库同级、`.trae/worktrees`、工具私有目录或嵌套 `.worktree`；禁止 stash、reset 或混入他人改动。
+- 浏览器与桌面行为必须真实取证，静态检查不能代替行为验收。
+- Runweave UI/浏览器验收只能显式附着 `dev:open` 返回的 CDP endpoint。禁止使用 `playwright-cli open`、系统浏览器、headless 浏览器、默认 endpoint、环境变量或既有无关 Playwright session 代替目标 surface。
+
+## 与真实复现的交接契约
+
+与 `$toolkit:reproduce-before-fix` 组合时，先接收并固定：
+
+- `validationSessionId`：修复前后共用的 Dev Session 逻辑身份；
+- `scenarioId`：需要原样重跑的用户场景；
+- 修复前 revision、完整步骤、输入和 `before/` 证据路径；
+- 修复前 `dev:status` / `dev:open` 关键身份；若来自既有用户现场，则接收 `sourceSessionId` 映射。
+
+修复前 Dev Session 必须先 `dev:stop`，并在重用 ID 前归档 before manifest 关键字段，因为同 ID 再次启动会更新 manifest。修复后继续使用同一个 `validationSessionId`，不得另取随机 ID。service instance ID、PID 和 endpoint 可以变化，需分别记录以证明两轮都属于正确 target。
+
+如果修复前来自不可替换的既有用户 session，保留原 `sourceSessionId`，修复后使用既定的 `validationSessionId`；最终明确说明不同 ID 的原因，不把它伪装成同环境复测。
+
+## Session ID 生成规则
+
+禁止自行使用 UUID、完整时间戳、问题标题或临时字符串作为 session ID。
+
+- 默认：第一次实际执行 `dev:session start` 时不传 `--session`，从 JSON 结果捕获 `devSessionId`，立即保存为 `validationSessionId`；后续 `status`、`open`、`stop` 和修复后重启全部显式传入该 ID。
+- 必须预先声明 ID：使用 `rcv-YYYYMMDD-<hash6>`。`hash6` 固定取 `SHA-256("<baselineRevision>\n<scenarioId>")` 前 6 位小写十六进制，例如 `rcv-20260712-a1b2c3`；禁止 `Math.random`、UUID、随意截 commit 或其它来源。只生成一次，并在第一次 start 前写入交接记录。
+- 从 `$toolkit:reproduce-before-fix` 接收到 ID：直接复用，不重新生成。
+
+创建证据根目录时使用最终捕获的 ID，不用“latest”、端口或 PID 代替。
+
+## 执行流程
+
+### 1. 固定本次 patch 边界
+
+代码修改完成后读取 `git status --short`、任务开始前状态和当前 diff，区分本次文件与既有改动。
+
+若工作区不干净且包含无关改动：
+
+1. 使用 `$toolkit:git-advanced-workflows`，从当前基线 commit 创建 detached 隔离 Worktree，路径为任务绑定父 Project 的 `<projectRoot>/.worktree/<validationName>`；若当前 cwd 已是该父 Project 的子 Worktree，则创建同级子 Worktree，禁止继续嵌套。
+2. 通过 Git Worktree 登记和 realpath 确认 source root 是 `.worktree` 下的直接子目录，且没有路径或分支身份冲突。
+3. 只把本次任务文件的 patch 应用到该 Worktree。
+4. 在该 Worktree 安装依赖并执行后续 Dev Session 命令。
+
+无法可靠区分 patch 边界时停止，不把整个脏工作区当作本次影响范围。
+
+### 2. 让 planner 裁决最低环境
+
+在只包含本次 patch 的 source root 中先运行：
+
+```bash
+pnpm dev:session --dry-run --json
+```
+
+检查 `changedFiles`、`impacts`、`requiredProfile`、每项服务的 `ownership` 和目标 surface。
+
+若结果高于预期，先反查实现是否无意修改公共契约、安装运行时或扩大消费者闭包。能收缩实现则修改代码并重新 dry-run；不能收缩则接受 planner 结果。不要用显式低 profile 压过影响闭包。
+
+### 3. 启动并核对身份
+
+按 Session ID 生成规则得到 `validationSessionId`，再按 planner 结果启动 Dev Session。与 `$toolkit:reproduce-before-fix` 组合时必须使用其交接的 ID；单独使用本技能时默认捕获 Dev Session 自动生成的 ID。用户明确要求更高环境时才显式提升 profile。
+
+启动后执行：
+
+```bash
+pnpm dev:status --session <id> --json
+```
+
+将纯 JSON 状态保存为证据，并使用本技能的 `scripts/assert-dev-session-status.mjs` 做机器断言：
+
+```bash
+node ./scripts/dev-session/cli.mjs status --session <id> --json > <status.json>
+node <skill-dir>/scripts/assert-dev-session-status.mjs \
+  --file <status.json> \
+  --session <id> \
+  --source-root <patch-worktree> \
+  --profile <profile> \
+  --surface <surface>
+```
+
+脚本必须输出 `healthy: true`；失败时停止，不用人工目测覆盖脚本结论。
+
+必须确认：
+
+- `controlPlane.appChannel` 是 `stable`；
+- source root、revision 和 dirty 状态对应本次 patch；
+- target profile 与验收目标一致；
+- dedicated/shared ownership 符合 planner；
+- Backend、App Server、Electron/CDP 的 service identity 与 health 均匹配 manifest。
+
+任一 dedicated 服务发生身份漂移、隐式 fallback 或能力退化时停止验收。比如 pane 归属用例要求 tmux，却实际退化为 PTY，不能继续把结果算作通过。
+
+### 4. 从 Dev Session 解析并附着验收入口
+
+根据行为所在层选择 surface：
+
+- Electron 主窗口和终端标签：`desktop` CDP；
+- 终端右侧内嵌 Browser：`terminal-browser` CDP；
+- Web 主页面：先用 `web` 取得 URL；需要用户可见的右侧验收时，再用 `terminal-browser` 取得 CDP endpoint，把该 URL 导航到本次新建的内嵌 Browser tab。
+
+对每个所需 surface 分别运行：
+
+```bash
+pnpm dev:open --session <id> --surface <surface> --json
+```
+
+`desktop` 和 `terminal-browser` 的 JSON 必须包含 `health: "ready"`、与目标 Session 一致的 `devSessionId`、`serviceInstanceId`、`endpoint` 和 `suggestedPlaywrightSession`。使用返回值显式附着：
+
+```bash
+playwright-cli -s="<suggestedPlaywrightSession>" attach --cdp="<endpoint>"
+```
+
+不得省略 `--cdp`，不得把 `PLAYWRIGHT_MCP_CDP_ENDPOINT`、默认端口、最近实例、旧 tab 或另一个 Playwright session 当成目标来源。不得执行 `playwright-cli open`；它会创建独立浏览器，不能证明结果来自 Runweave 的目标实例或用户可见 surface。
+
+附着后的操作与清理按 surface 区分：
+
+- `desktop`：读取 tab/page 列表并选择目标 Electron renderer；验收后只执行 `playwright-cli -s="<session>" detach`，不得关闭 page、窗口或 App。
+- `terminal-browser`：先保存现有 tab 列表和原活动 tab，再新建一个本次验收专属 tab；只在该 tab 中导航、操作和取证。验收后关闭这个专属 tab，必要时恢复原活动 tab，再执行 `detach`；不得关闭用户已有 tab 或外部 Browser。
+- 右侧 Web 验收：同时保存 `dev:open --surface web` 返回的 URL 和 `dev:open --surface terminal-browser` 返回的 CDP endpoint；附着 `terminal-browser` 后新建专属 tab 并导航到 Web URL。不得把 URL 交给 `playwright-cli open` 或系统浏览器。
+
+若 attach 失败、endpoint 身份不匹配，或 planner/profile 没有提供用户要求的 CDP surface，立即停止行为验收并报告环境阻塞。可以因为明确的验收目标提升 profile 后重新规划，但不得静默回退到独立、系统级或 headless 浏览器。
+
+桌面启动、系统弹窗或菜单准备使用 `$computer-use`；页面 DOM、点击、输入、刷新和截图使用 `$toolkit:playwright-cli`。每轮证据至少记录 `validationSessionId`、surface、`serviceInstanceId`、CDP endpoint、Playwright session 名、目标 page/tab URL，以及 DOM 或截图证据。
+
+### 5. 执行真实场景
+
+按需求运行真实入口和生产代码路径。若本任务组合了 `$toolkit:reproduce-before-fix`，使用同一个 `scenarioId`，保持用户步骤、输入、数据规模和关键时序不变，原样重跑复现场景，再补受影响回归。
+
+将运行前、运行中和运行后的关键状态写入与 `before/` 同级的 `after/`，包括必要的 session/pane、事件、manifest identity、DOM 和截图证据。只验证本次影响闭包，不顺手扩大验收范围。
+
+### 6. 清理与交付
+
+验收完成或失败后都执行：
+
+```bash
+pnpm dev:stop --session <id> --json
+```
+
+只停止 manifest 中由该 Session 拥有的 dedicated 服务；不停止 shared 服务。停止后最多等待 10 秒确认状态进入 `stopped` 且目标端口/CDP 不再监听，再使用 `$toolkit:git-advanced-workflows` 移除本次精确的隔离 Worktree；不得强制移除 dirty Worktree，也不得执行全局 `git worktree prune`。
+
+10 秒后仍未清理完成时停止等待：重新保存 `dev:status --json`，用 `lsof -nP -iTCP:<port> -sTCP:LISTEN` 记录占用进程并报告环境阻塞。不要无限轮询、按端口盲杀或移除仍被运行服务使用的 worktree。
+
+最终报告必须包含：
+
+- planner 的最低 profile 与影响原因；
+- 实际使用的 target profile、ownership 和 surface；
+- `dev:status` / `dev:open` 的关键身份；
+- `playwright-cli attach` 使用的 CDP endpoint、Playwright session、目标 page/tab，以及只清理本次 tab 后成功 `detach` 的结果；
+- 真实验收结果与证据；
+- 同一个 `validationSessionId` 下的 Before/After 对照；
+- `dev:stop` 和资源清理结果；
+- 未执行项及阻塞原因。
+
+至少并列呈现以下字段：
+
+| 字段            | Before                               | After                              |
+| --------------- | ------------------------------------ | ---------------------------------- |
+| revision        | 修复前 revision                      | 修复后 revision                    |
+| session         | `validationSessionId` 或 source 映射 | 同一 `validationSessionId`         |
+| target identity | profile、service identity、surface   | profile、service identity、surface |
+| 场景            | `scenarioId`、步骤、输入             | 原样重跑结果                       |
+| 可观察结果      | 原始症状                             | 修复后结果                         |
+| 证据            | `before/` 路径                       | `after/` 路径                      |
+
+## 例外
+
+- 纯诊断、只读评审：不修改代码，也不创建 Dev Session。
+- 纯文档改动：执行文档自身校验，不启动运行环境。
+- Dev Session 明确不支持所需 target：报告环境阻塞，不自行搭建平行环境；需要扩大机制时先与用户对齐。

package/payload/plugins/toolkit/skills/runweave-change-validation/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Runweave Change Validation"
+  short_description: "仅在显式调用时用 Dev Session 完成隔离验收"
+  default_prompt: "使用 $toolkit:runweave-change-validation 根据当前代码 diff 选择并完成正确的 Runweave 隔离验证流程。"
+
+policy:
+  allow_implicit_invocation: false

package/payload/plugins/toolkit/skills/runweave-change-validation/scripts/assert-dev-session-status.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+const args = parseArgs(process.argv.slice(2));
+const status = JSON.parse(readFileSync(args.file, "utf8"));
+const errors = [];
+const checkedServices = [];
+
+expectEqual(status.devSessionId, args.session, "devSessionId", errors);
+expectEqual(status.state, "ready", "state", errors);
+expectEqual(
+  status.controlPlane?.appChannel,
+  "stable",
+  "controlPlane.appChannel",
+  errors,
+);
+
+if (
+  typeof status.source?.root !== "string" ||
+  path.resolve(status.source.root) !== path.resolve(args.sourceRoot)
+) {
+  errors.push(
+    `source.root mismatch: expected ${path.resolve(args.sourceRoot)}, received ${String(status.source?.root)}`,
+  );
+}
+if (typeof status.source?.revision !== "string" || !status.source.revision) {
+  errors.push("source.revision must be present");
+}
+if (args.profile) {
+  expectEqual(status.profile, args.profile, "profile", errors);
+  expectEqual(
+    status.targetEnvironment?.kind,
+    args.profile,
+    "targetEnvironment.kind",
+    errors,
+  );
+}
+if (
+  args.surface &&
+  !status.targetEnvironment?.acceptanceSurfaces?.includes(args.surface)
+) {
+  errors.push(`targetEnvironment does not include surface ${args.surface}`);
+}
+
+for (const [name, service] of listServices(status.services)) {
+  checkedServices.push(name);
+  validateService(name, service, args.session, status.source?.revision, errors);
+}
+
+const result = {
+  healthy: errors.length === 0,
+  devSessionId: status.devSessionId ?? null,
+  profile: status.profile ?? null,
+  checkedServices,
+  errors,
+};
+process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+if (errors.length > 0) {
+  process.exitCode = 1;
+}
+
+function parseArgs(values) {
+  const options = {};
+  for (let index = 0; index < values.length; index += 2) {
+    const flag = values[index];
+    const value = values[index + 1];
+    if (!value || !flag?.startsWith("--")) {
+      fail(
+        "usage: assert-dev-session-status.mjs --file <path> --session <id> --source-root <path> --profile <profile> --surface <surface>",
+      );
+    }
+    const key = flag
+      .slice(2)
+      .replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+    options[key] = value;
+  }
+  for (const key of ["file", "session", "sourceRoot", "profile", "surface"]) {
+    if (!options[key]) {
+      fail(
+        `missing required argument --${key.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`)}`,
+      );
+    }
+  }
+  return options;
+}
+
+function listServices(services) {
+  if (!services || typeof services !== "object") {
+    return [];
+  }
+  return [
+    ["frontend", services.frontend],
+    ["backend", services.backend],
+    ["appServer", services.appServer],
+    ["electron", services.electron],
+    ["beta", services.beta],
+    ["cdp.desktop", services.cdp?.desktop],
+    ["cdp.terminalBrowser", services.cdp?.terminalBrowser],
+  ];
+}
+
+function validateService(name, service, sessionId, sourceRevision, errors) {
+  if (!service || typeof service !== "object") {
+    errors.push(`${name} service is missing`);
+    return;
+  }
+  if (
+    !new Set(["dedicated", "shared-declared", "disabled"]).has(
+      service.ownership,
+    )
+  ) {
+    errors.push(`${name}.ownership is invalid`);
+    return;
+  }
+  if (service.ownership === "disabled") {
+    return;
+  }
+  if (
+    typeof service.serviceInstanceId !== "string" ||
+    !service.serviceInstanceId
+  ) {
+    errors.push(`${name}.serviceInstanceId must be present`);
+  }
+  if (service.ownership === "dedicated") {
+    expectEqual(
+      service.ownerDevSessionId,
+      sessionId,
+      `${name}.ownerDevSessionId`,
+      errors,
+    );
+    if (!Number.isInteger(service.pid) || service.pid < 1) {
+      errors.push(`${name}.pid must be a positive integer`);
+    }
+    expectEqual(
+      service.sourceRevision,
+      sourceRevision,
+      `${name}.sourceRevision`,
+      errors,
+    );
+  }
+  if (!name.startsWith("cdp.") && service.health !== "live") {
+    errors.push(
+      `${name}.health must be live, received ${String(service.health)}`,
+    );
+  }
+  if (service.healthFailureReason) {
+    errors.push(
+      `${name}.healthFailureReason: ${String(service.healthFailureReason)}`,
+    );
+  }
+  if (name.startsWith("cdp.") && !isLoopbackHttpUrl(service.endpoint)) {
+    errors.push(`${name}.endpoint must be a loopback HTTP URL`);
+  }
+}
+
+function isLoopbackHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return (
+      url.protocol === "http:" &&
+      ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname)
+    );
+  } catch {
+    return false;
+  }
+}
+
+function expectEqual(actual, expected, label, errors) {
+  if (actual !== expected) {
+    errors.push(
+      `${label} mismatch: expected ${expected}, received ${String(actual)}`,
+    );
+  }
+}
+
+function fail(message) {
+  process.stderr.write(`${message}\n`);
+  process.exit(2);
+}

package/payload/plugins/toolkit/skills/runweave-dev-session/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: runweave-dev-session
+description: "Use whenever Codex needs to actually plan, start, inspect, open, attach to, recover, or stop a Runweave Dev Session, including any execution of pnpm dev:session, dev:status, dev:open, or dev:stop. Manage exact worktree and Session identity, planner-selected profiles, Beta slots, surfaces, and cleanup. Do not trigger for conceptual discussion that does not operate a runtime Session."
+---
+
+# Runweave Dev Session
+
+把 Dev Session 作为运行环境事实源。始终从准确的源码 worktree 和 Stable 控制面操作，不按端口、最近启动时间或窗口外观猜测目标。
+
+## 与其他技能组合
+
+- `$toolkit:runweave-change-validation` 负责完整代码变更验收、patch 边界和证据合同；本技能负责其中的 Dev Session 生命周期。显式调用前者时，两者同时使用。
+- 页面 DOM、点击、输入和截图需要 `$toolkit:playwright-cli`；只附着 `dev:open` 返回的目标 CDP。
+- macOS 原生窗口、菜单或系统弹窗确实参与任务时，使用 `$computer-use`。
+
+## 选择操作模式
+
+- 只查询现有 Session：执行 `status` 或 `open`，不要创建或停止 Session。
+- 创建环境：先 dry-run，再按 planner 结果启动。
+- 管理指定 Session：后续每条命令显式传入同一个 `--session <id>`。
+- 多 worktree 并行：分别在各自 worktree 执行并保存独立 Session ID；不得从一个 worktree 猜测或操作另一个 worktree 的 Session。
+
+## 1. 固定 source root
+
+在用户指定或任务实际修改所在的 worktree 中确认：
+
+```bash
+pwd
+git status --short
+```
+
+不要自动切换到主 checkout。正常开发不覆盖 `RUNWEAVE_DEV_SESSION_HOME`；只有测试合同或用户明确要求隔离 registry 时才设置它。
+
+## 2. 让 planner 先裁决
+
+创建 Session 前先执行无显式 profile 的只读规划：
+
+```bash
+pnpm dev:session --dry-run --json
+```
+
+检查 `sourceRoot`、`changedFiles`、`impacts`、`requiredProfile`、service ownership 和 acceptance surface。profile 高于预期时先检查真实 diff，不得显式向下降级。
+
+用户明确要求安装态、跨版本、Electron 或 Beta 目标时，可以在不低于 `requiredProfile` 的前提下提升 profile。只查询或操作既有 Session 时不重复 dry-run。
+
+## 3. 启动并捕获身份
+
+默认让 CLI 生成 Session ID：
+
+```bash
+pnpm dev:session --json
+```
+
+需要提升目标时才显式指定：
+
+```bash
+pnpm dev:session --profile <profile> --json
+```
+
+立即保存返回的 `devSessionId`、`profile`、`source.root` 和 services。不要自行生成随机 ID。只有用户明确指定，或上层复现/变更验证合同已经提供 `validationSessionId` 时，才传入该 ID。
+
+Beta profile 使用全机共享的 `pool-01` 至 `pool-05`：
+
+- 默认自动分配槽位，不传 `--instance`。
+- 只有用户或测试合同明确要求固定槽位时才传 `--instance pool-0N`。
+- dry-run 的容量快照不是租约承诺；真实 start 才原子获取槽位。
+- 槽位占满或显式槽位已占用时按失败处理，不等待、不抢占、不清理其他 Session。
+
+## 4. 核对状态
+
+启动后和关键操作前使用精确 ID：
+
+```bash
+pnpm dev:status --session <id> --json
+```
+
+至少核对：
+
+- `devSessionId`、`source.root` 和 revision 属于本次 worktree；
+- state 满足当前操作要求；
+- profile、dedicated/shared ownership 和 service identity 符合 planner；
+- Beta 的 slot、lease 和 CDP identity 一致。
+
+若没有 ID，只允许在准确 source root 中调用一次无 `--session` 的 `dev:status` 来解析唯一候选。出现多个候选时停止并列出候选，不选择“最新”的 Session。
+
+## 5. 解析 surface
+
+只通过 resolver 获取入口：
+
+```bash
+pnpm dev:open --session <id> --surface <surface> --json
+```
+
+surface 选择：
+
+- `web`：Web 页面 URL；
+- `desktop`：Electron 主窗口和终端标签 CDP；
+- `terminal-browser`：终端右侧内嵌 Browser CDP。
+
+浏览器验收时，同时使用 `$toolkit:playwright-cli`：
+
+- `desktop` 和 `terminal-browser` 按返回的 `suggestedPlaywrightSession` 和 `endpoint` 执行 `attach --cdp=<endpoint>`；
+- `web` 的 `endpoint` 是 URL，不是 CDP。需要自动化 Web 页面时，另外解析 `terminal-browser` CDP，在本次新建的内嵌 Browser tab 中导航到该 Web URL；目标 profile 不提供所需 CDP 时，按验收目标合法提升 profile 或报告阻塞。
+
+禁止改用固定端口、ambient endpoint、系统浏览器、`playwright-cli open` 或既有无关 Playwright session。
+
+## 6. 停止与清理
+
+任务创建的 Session 在完成或失败后都应停止，除非用户明确要求保留：
+
+```bash
+pnpm dev:stop --session <id> --json
+```
+
+只停止该 manifest 拥有的 dedicated 服务，不停止 shared 服务或其他 worktree 的资源。不是本任务创建的 Session，除非用户明确要求，不得停止。
+
+遇到 stale、PID 漂移、占用或清理失败时：
+
+- 保存 `dev:status --session <id> --json` 和错误中的 recovery 指引；
+- 只有 recovery 明确要求且目标身份可验证时，才执行 `dev:stop --session <id> --cleanup-stale --json`；
+- 不删除 manifest、profile lock、Beta lease 或端口 lease；
+- 不按端口盲杀进程，不重置其他 worktree，不无限轮询。
+
+## 交付
+
+报告实际操作结果：source root、Session ID、profile、关键 ownership；Beta 时包含 slot；打开页面时包含 surface 和目标 identity；最后说明 Session 已停止、按要求保留，或具体清理阻塞。

package/payload/plugins/toolkit/skills/runweave-dev-session/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Runweave Dev Session"
+  short_description: "安全规划、启动、定位并清理 Runweave Dev Session"
+  default_prompt: "使用 $toolkit:runweave-dev-session 安全规划并管理当前任务所需的 Runweave Dev Session。"
+
+policy:
+  allow_implicit_invocation: true

package/payload/plugins/toolkit/skills/runweave-management/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: runweave-management
+description: 管理 Runweave 实例配置与服务状态，查询 warning/error、解释配置、校验、修改并确认生效；更新安装和 Dev Session 生命周期沿用专属技能。
+---
+
+# Runweave 配置与服务管理
+
+使用当前源码构建的 CLI 或目标机器已安装的 `rw`，先核对 `rw version --json` 支持以下命令。旧版本缺少命令时报告能力缺失，不直接编辑配置文件补救。
+仓库操作指南：[配置 CLI](https://github.com/jackshen3102/run-weave/blob/main/docs/cli/configuration.md)、[权威字段参考](https://github.com/jackshen3102/run-weave/blob/main/docs/cli/configuration-reference.md)、[服务管理](https://github.com/jackshen3102/run-weave/blob/main/docs/cli/service-management.md)。离开仓库也可通过 `rw config keys --json` 查询当前二进制的字段目录及 constraints（枚举、范围、路径和成组凭据约束），用 `rw config explain <实际键> --instance <id> --json` 读取来源与生效方式。
+
+## 定位与只读诊断
+
+明确目标机器、Stable 或 Dev 实例，以及 Backend profile。本地配置命令读取执行 CLI 的机器；远端 profile 不会把本地磁盘查询变成远程读取。远端本地字段操作应在目标机器执行。Dev Session 使用其绑定入口及真实 Session ID，不猜端口或路径。
+
+```bash
+rw config path --instance <id> --json
+rw status --instance <id> --profile <name> --json
+rw config status --instance <id> --profile <name> --json
+rw config keys --json
+rw config validate --instance <id> --json
+rw config doctor --instance <id> --json
+```
+
+`status.management.capabilities` 使用统一 warning/error 与依赖聚合；先看上游故障，再看受阻项。diagnostics.configuration 是候选排查关联，不证明故障由配置导致。动态字段模式要替换成真实键；不要将占位符直接交给 explain/set。
+核对 node、profile、来源和 coverage；Backend 节点快照不包含 Electron IPC、当前页面连接和未上报独立服务。404/协议不支持/认证失败是读取能力或连接问题，不等于服务健康。`rw health` 可达不代表全部服务正常。
+Research MCP 也可通过 `query_data` 的 `source: status` 查询同一 Backend API；旧 Backend 没有 management 时只解释已有证据，不伪造完整覆盖。
+
+## 修改与确认结果
+
+在本次授权范围内执行配置变更。先 explain 目标键，核对类型、约束、敏感性、归属与生效方式；读取最新 revision/digest 并保存预期值。值通过私有 JSON 文件或 stdin 传入，凭据不进命令参数、stdout 或成果。
+
+```bash
+rw config set <实际键> --value-file <private-json> --instance <id> \
+  --expected-revision <revision> --expected-digest <digest> --json
+rw config validate --instance <id> --json
+rw config reload --instance <id> --profile <name> --json
+rw config status --instance <id> --profile <name> --json
+rw status --instance <id> --profile <name> --json
+```
+
+null 恢复默认。关联凭据需成组变更时使用配置文档的 import 流程，先 dry-run，不通过多次单键保存制造无效中间态。版本冲突重新读取并核对用户意图，不能去掉预期版本强行覆盖。
+保存成功只表示持久化。检查目标字段 fieldStates 的 state、saved、applied 与 appliedRevision；pending/error/notObserved 不能报告为生效，重载失败保留旧采用值。重启字段通过目标服务既有生命周期入口处理，禁止按端口杀进程或重启无关服务。Dev Session 操作使用 runweave-dev-session；macOS Stable 桌面更新在用户显式指定时使用 update-runweave-desktop。
+最后执行该服务真实功能验证，例如读取数据、连接或用户授权的业务操作；healthy 与 applied 本身不能替代业务成功。只读诊断不发送消息或写入终端。
+
+Linux 整套后台更新与 systemd 开机自启使用 [update-runweave-backend](../update-runweave-backend/SKILL.md)。恢复备份、迁移、初始化和软件更新不是普通配置写入；按配置文档/专属技能执行精确目标、预览和兼容检查。初始化只用于确认全新安装；不覆盖已有身份。写入响应不确定先核对，不自动重放有副作用的操作。
+
+交付区分保存、应用、服务状态及业务验证四种证据，明确来源和未验证范围。

package/payload/plugins/toolkit/skills/scheduled-task/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: scheduled-task
+description: 在 Runweave 终端用自然语言创建或编辑 Backend 定时任务：Agent 整理配置、只读校验并展示完整草稿，用户确认最终数据后才写入。用户说“帮我设一个定时任务”“修改这个定时任务”等时使用。
+---
+
+# 用 Agent 创建或编辑 Runweave 定时任务
+
+本 Skill 管理 **Runweave Backend** 的定时任务，不创建 Codex 或其他产品自己的自动化。入口是 `rw scheduled-task`；在 Runweave 源码 checkout 中可读 `docs/cli/scheduled-task-cli.md`。已安装的 `rw` 没有此命令时，可在当前 Runweave 源码 checkout 运行 `pnpm cli:build` 后使用 `node packages/runweave-cli/dist/index.js`；找不到支持此命令的客户端就报告环境缺口，不绕开鉴权写数据库。
+
+## 整理草稿
+
+1. 用 `rw auth status --json` 确认目标 Backend/profile，用 `rw scheduled-task capabilities --json` 核对 taskContextVersion=2、provider 与执行权限。版本不兼容或 migration_required 时按 CLI 当前文档处理，不填虚假项目绕过。编辑时先 `list`/`get` 精确定位一条未归档任务；同名多条不能猜测。所有命令使用同一 profile 或 Backend 端口。
+2. 把用户的话整理成任务名称、provider、完整提示词、时间规则与 IANA 时区、补跑策略、启用状态，以及可选模型、推理强度、执行权限。提示词忠实保留目标、约束和验收条件；不自行增加发布、发送消息、删除或提高权限等动作。用户未指定的值可以提出默认建议，但必须在最终核对中明确展示。当前 Web 默认 Codex、启用、仅沙箱、错过后补最近一次且有效期 24 小时；不要把这些当作用户已确认的选择。
+3. 明确一次性时间的日期、时区和 UTC 转换；“明早”“工作日”等相对说法要按当前日期解释并给出绝对日期/规则。缺少时间、时区或任务内容，或存在两种合理解释时先询问。任务提示词提到另一个 Skill 时，确认它在预期后台 Agent 环境可用；无法确认就告知用户这一限制。
+   提示词要求真实 Browser、iOS 模拟器、命令联网、Git 元数据或工作区外本机访问时，建议用户选择
+   `full-access`，并说明它无沙箱且不等待交互审批。具体能力和验收要求仍写入提示词并遵循对应 Skill；
+   不增加或暗中生成 Browser、模拟器、网络、Git 等独立开关，也不因选择 full access 自动调用工具。
+4. 在本次唯一的受保护临时路径写 JSON（权限 `0600`）。创建文件使用 `CreateScheduledTaskRequest`；编辑文件只放改动字段和从 `get` 读到的 `expectedRevision`。编辑草稿应同时保存当前任务原文，以便展示修改后的**完整有效配置**。不把访问 token、密码或无关资料写入草稿。
+
+普通任务没有项目或 cwd 配置项，也不需要先登记业务项目。任务从每次运行的私有目录启动，
+需要操作仓库或终端时把准确目标、项目规则和验收条件写入提示词；Agent 自行核对目标，不能按同名目录猜测写入。
+描述不会扩大 sandbox 权限，不能为了免填项目而暗中改成 full-access。旧项目任务的迁移须独立 preview、
+展示全部草稿并获明确确认后 apply；本 Skill 的普通创建／编辑授权不包含批量迁移、重新启用旧任务或重启 Backend。
+
+## 只读校验与最终确认
+
+- 创建执行 `rw scheduled-task validate-create --file <草稿> --json`；编辑执行 `rw scheduled-task validate-update <精确 taskId> --file <补丁> --json`。校验复用正式写入的 Backend schema、provider、schedule 和 revision 检查，但不写任务。失败时说明具体问题，修改草稿并重验；不可用 provider、过期一次性时间和 revision 冲突不能靠猜测绕过。接口返回 404 表示当前 Backend 尚未提供预校验，应报告需要更新 Backend，不能跳过校验直接写入。
+- 以验证响应的 `validation.config` 为准，向用户展示目标 Backend/profile、任务 ID（编辑）、完整名称与**完整提示词**、provider/model/effort、执行权限、启用状态、时间规则与时区、下一次及后续预览的本地和 UTC 时间、补跑策略，以及编辑前后变化。连同 `sha256` 明确标识本次请求。`full-access` 草稿必须再次突出无沙箱、无交互审批及本机访问风险。预览不保证电脑届时在线；不要声称任务已经创建。
+- **等待用户明确确认这份最终配置。** 初始“帮我创建/修改”不等于确认；用户改任何字段、目标 Backend 改变、编辑任务 revision 改变、或一次性时间已过，都要重新校验并再次展示。没有明确确认不得调用 `create` 或 `update`，也不得以准备好的文件代替确认。
+
+## 写入和核对
+
+- 创建：为这份已确认草稿生成并保留一个 UUID 幂等键，调用一次 `rw scheduled-task create --file <草稿> --sha256 <验证响应 sha256> --expected-backend <验证响应 backend> --idempotency-key <UUID> --json`。只有成功响应并通过 `get <返回 taskId>` 核对后，才报告创建成功。
+- 编辑：确认前再次 `get` 核对任务仍是原 `expectedRevision`，然后调用一次 `rw scheduled-task update <taskId> --file <补丁> --sha256 <验证响应 sha256> --expected-backend <验证响应 backend> --json`，再 `get` 核对。出现 revision 冲突时保留草稿，重新整理差异并请用户确认，不能覆盖较新版本。
+- 创建请求结果不确定时，保留原文件和幂等键；先只读查询，必要时仅用**相同文件、摘要、Backend 和键**重试。编辑结果不确定时先 `get` 对比 revision 与字段，不盲目再次 PATCH。停止、删除或立即运行是独立操作，本 Skill 不因创建/编辑成功而触发。