msdevflow 0.7.2 → 0.7.4

package/README.md

@@ -33,7 +33,7 @@ npx msdevflow@latest setup
 2. 安装或升级官方 `@gitcode-cli/cli@latest`；
 3. 安装受审的 Python Playwright 依赖；
 4. 验收 Issue、PR、结构化评论、行内评论、JSON、显式仓库和正文文件等 CLI 能力；
-5. GitCode CLI 未认证时打开官方浏览器登录。
+5. GitCode CLI 未认证时打开官方 Token 创建页面，并让 CLI 自己的终端提示接收 Token。
 
 显式选择客户端或只读预检：
 
@@ -65,25 +65,29 @@ npx msdevflow setup --agents-skills-dir "<shared-agent-skills-directory>"
 
 `--skills-dir` 未配合 `--targets` 使用时保留旧语义，只安装 Claude Code 目标。没有检测到客户端时，交互运行会要求选择目标；非交互运行必须提供 `--targets`。安装完成后重启或重新加载对应客户端。如果机器已有 Python 版本的 `gitcode`，setup 会保留它，并为 npm CLI 创建 `gitcode-npm` 命令；否则使用 `gitcode`。
 
-## 完整端到端流程
+## 运行与 action 菜单
 
-从目标仓库目录启动已安装目标中的任一客户端，然后调用 skill：
+从目标仓库目录启动客户端并提交 `msdevflow`：
 
-- Claude Code：输入 `/msdevflow`；
-- Codex：使用 `$msdevflow`、`/skills` 选择，或让 Codex 按描述隐式匹配；
-- OpenCode：通过其 skill 工具选择，或让 OpenCode 按描述隐式匹配。
+- Claude Code：输入并提交 `/msdevflow`；
+- Codex：使用 `$msdevflow` 或从 `/skills` 选择后提交；
+- OpenCode：打开 `/skills`，选择 `msdevflow`，再提交插入的 `/msdevflow`。`@` 用于文件、reference 或 agent，不用于选择 Skill。
 
-客户端 UI 和命令入口可能随版本变化，但传给 skill 的任务正文相同：
+没有字面量 `action=<name>` 时，Agent 会先通过宿主原生单选工具显示分级菜单，选择前不会探测仓库或访问 GitCode：
 
 ```text
-处理 https://gitcode.com/<canonical-owner>/<repo>/issues/<number>。
-本地仓库：<local-repository-absolute-path>
-canonical：<canonical-owner>/<repo>
-source：<your-account>/<repo>
-使用 guided 模式，按权威远端和本地证据推进完整作者 E2E。
+选择运行方式
+├─ 完整端到端流程
+├─ 作者工作流
+│  ├─ Issue 管理 -> discover | create-issue | issue
+│  ├─ 开发与交付 -> develop | pr | ci
+│  └─ PR 后续 -> feedback | merge
+└─ 独立工具 -> openlibing-auth | code-review
 ```
 
-未指定 `action` 时，流程为：
+Claude Code 使用 `AskUserQuestion`，Codex 使用 `request_user_input`，OpenCode 使用 `question`。每次只显示当前层且不超过 3 项；工具不可用或处于非交互模式时，Agent 只输出当前层编号选项并等待回复，不自行选择默认项。
+
+选择“完整端到端流程”后，才会运行：
 
 ```text
 Issue 发现/核验
@@ -98,10 +102,11 @@ Issue 发现/核验
 -> 远端回读 PR 已 merged
 ```
 
-这是可暂停、可恢复的流程。外部检视或审批有新进展后，可再次运行：
+调用正文可预先提供 Issue/PR URL、仓库路径、canonical、source 和模式；菜单选择后这些参数会保留。即使正文写明“运行完整 E2E”或某个具体任务，只要没有字面量 `action=<name>`，仍从顶层菜单开始。
+
+这是可暂停、可恢复的流程。外部检视或审批有新进展后，可再次提交 `/msdevflow` 和 PR 信息，并在菜单中选择“完整端到端流程”：
 
 ```text
-/msdevflow
 恢复 https://gitcode.com/<canonical-owner>/<repo>/pulls/<number> 的完整作者 E2E。
 本地仓库：<local-repository-absolute-path>
 canonical：<canonical-owner>/<repo>
@@ -172,7 +177,7 @@ Agent 写入的 PR/Issue 正文、评论和 discussion 回复末尾会附加：
 `msdevflow`：
 
 - 不读取、打印或转存 GitCode Token；
-- 不要求用户把 Token 粘贴到终端、对话或项目文件；
+- Token 只粘贴到 GitCode CLI 自己的终端提示，不放入 Agent 对话、命令参数、项目文件、URL 或日志；
 - openLiBing Token 只在当前 Python 认证进程内短暂使用，不输出、不落盘；
 - 永远不会自动下载 Playwright Chromium；
 - 优先使用系统 Chrome/Edge，其次使用已经安装的 Playwright Chromium；
@@ -212,7 +217,7 @@ npx msdevflow setup
 <gitcode-command> auth status --json
 ```
 
-用户只在官方浏览器页面输入凭证。
+用户在官方页面创建 Token，并只粘贴到 GitCode CLI 自己的终端提示；不要把 Token 交给 Agent 或放入命令参数、项目文件、URL 或日志。
 
 ### `blocked: browser-required`
 

package/lib/bootstrap.js

@@ -1,4 +1,4 @@
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
 import {
   closeSync,
@@ -265,6 +265,22 @@ function executableCommand(executable, args, platform) {
   };
 }
 
+export function interactiveExecutableCommand(executable, args, platform) {
+  if (platform !== "win32" || !/\.(?:cmd|bat)$/i.test(executable)) {
+    return executableCommand(executable, args, platform);
+  }
+  const values = [executable, ...args];
+  if (values.some((value) => /["\r\n]/.test(value))) {
+    throw new BootstrapError("Interactive Windows command contains unsupported characters.", 3);
+  }
+  const commandLine = `"${values.map((value) => `"${value}"`).join(" ")}"`;
+  return {
+    command: "cmd.exe",
+    args: ["/d", "/s", "/c", commandLine],
+    windowsVerbatimArguments: true,
+  };
+}
+
 export function formatCommand(invocation) {
   return [invocation.command, ...invocation.args]
     .map((value) => (/^[A-Za-z0-9_./:@=\\-]+$/.test(value) ? value : JSON.stringify(value)))
@@ -279,6 +295,7 @@ function execute(invocation, { allowFailure = false, inherit = false, outputToSt
       : "pipe",
     maxBuffer: 20 * 1024 * 1024,
     windowsHide: false,
+    windowsVerbatimArguments: invocation.windowsVerbatimArguments === true,
   });
   if (result.error) {
     throw new BootstrapError(`Failed to run ${invocation.command}: ${result.error.message}`);
@@ -295,6 +312,54 @@ function execute(invocation, { allowFailure = false, inherit = false, outputToSt
   };
 }
 
+function executeAsync(invocation, { allowFailure = false, inherit = false, outputToStderr = false } = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(invocation.command, invocation.args, {
+      stdio: inherit
+        ? ["inherit", outputToStderr ? process.stderr : "inherit", "inherit"]
+        : ["ignore", "pipe", "pipe"],
+      windowsHide: false,
+      windowsVerbatimArguments: invocation.windowsVerbatimArguments === true,
+    });
+    const stdout = [];
+    const stderr = [];
+    let outputBytes = 0;
+    let outputError = null;
+    const capture = (chunks) => (chunk) => {
+      outputBytes += chunk.length;
+      if (outputBytes > 20 * 1024 * 1024) {
+        outputError = new BootstrapError(`Command output exceeded 20 MiB: ${formatCommand(invocation)}`);
+        child.kill();
+        return;
+      }
+      chunks.push(chunk);
+    };
+    child.stdout?.on("data", capture(stdout));
+    child.stderr?.on("data", capture(stderr));
+    child.once("error", (error) => {
+      reject(new BootstrapError(`Failed to run ${invocation.command}: ${error.message}`));
+    });
+    child.once("close", (code) => {
+      if (outputError) {
+        reject(outputError);
+        return;
+      }
+      const status = code ?? 1;
+      const result = {
+        status,
+        stdout: Buffer.concat(stdout).toString("utf8"),
+        stderr: Buffer.concat(stderr).toString("utf8"),
+      };
+      if (status !== 0 && !allowFailure) {
+        const detail = inherit ? "" : `\n${(result.stderr || result.stdout).trim()}`;
+        reject(new BootstrapError(`Command failed (${status}): ${formatCommand(invocation)}${detail}`));
+        return;
+      }
+      resolve(result);
+    });
+  });
+}
+
 function runOptional(run, invocation) {
   try {
     return run(invocation, { allowFailure: true });
@@ -306,6 +371,55 @@ function runOptional(run, invocation) {
   }
 }
 
+async function runOptionalAsync(run, invocation) {
+  try {
+    return await run(invocation, { allowFailure: true });
+  } catch (error) {
+    if (error instanceof BootstrapError && error.message.startsWith("Failed to run ")) {
+      return { status: 1, stdout: "", stderr: error.message };
+    }
+    throw error;
+  }
+}
+
+export function createProgress(output, writeLine, timers = { setInterval, clearInterval }) {
+  const interactive = Boolean(output?.isTTY && typeof output.write === "function");
+  const frames = ["|", "/", "-", "\\"];
+  return {
+    async run(label, operation) {
+      if (!interactive) {
+        writeLine(`${label}...`);
+        try {
+          const result = await operation();
+          writeLine(`${label}: done`);
+          return result;
+        } catch (error) {
+          writeLine(`${label}: failed`);
+          throw error;
+        }
+      }
+
+      let frame = 0;
+      const render = () => {
+        output.write(`\r${frames[frame]} ${label}`);
+        frame = (frame + 1) % frames.length;
+      };
+      render();
+      const timer = timers.setInterval(render, 80);
+      try {
+        const result = await operation();
+        timers.clearInterval(timer);
+        output.write(`\r[done] ${label}\n`);
+        return result;
+      } catch (error) {
+        timers.clearInterval(timer);
+        output.write(`\r[failed] ${label}\n`);
+        throw error;
+      }
+    },
+  };
+}
+
 function verifyFile(file, missingMessage) {
   let descriptor;
   try {
@@ -792,8 +906,8 @@ function writeWrapper(details, platform) {
   }
 }
 
-function installGitcode(plan, run, platform) {
-  run(plan.installInvocation);
+async function installGitcode(plan, runLong, run, platform) {
+  await runLong(plan.installInvocation);
   if (plan.gitcodeInstall.mode === "coexist") {
     verifyFile(
       plan.gitcodeInstall.cliTarget,
@@ -885,10 +999,10 @@ function cliInvoker(cliExecutable, run, platform) {
   return (args, options) => run(executableCommand(cliExecutable, args, platform), options);
 }
 
-function validateCore(cliExecutable, run, platform) {
+async function validateCore(cliExecutable, run, platform) {
   const invoke = cliInvoker(cliExecutable, run, platform);
-  const version = invoke(["version"]).stdout.trim();
-  const doctor = invoke(["doctor", "install", "--json"], { allowFailure: true });
+  const version = (await invoke(["version"])).stdout.trim();
+  const doctor = await invoke(["doctor", "install", "--json"], { allowFailure: true });
   const missing = [];
   try {
     const metadata = JSON.parse(doctor.stdout);
@@ -899,7 +1013,7 @@ function validateCore(cliExecutable, run, platform) {
     missing.push("doctor install (invalid JSON)");
   }
   for (const [schema, requiredFlags] of Object.entries(REQUIRED_SCHEMAS)) {
-    const result = invoke(["schema", schema], { allowFailure: true });
+    const result = await invoke(["schema", schema], { allowFailure: true });
     if (result.status !== 0) {
       missing.push(schema);
       continue;
@@ -916,28 +1030,45 @@ function validateCore(cliExecutable, run, platform) {
       missing.push(`${schema} (invalid schema JSON)`);
     }
   }
-  if (invoke(["api", "--help"], { allowFailure: true }).status !== 0) {
+  if ((await invoke(["api", "--help"], { allowFailure: true })).status !== 0) {
     missing.push("api");
   }
   if (missing.length) {
     throw new BootstrapError(`GitCode CLI is missing required capabilities: ${missing.join(", ")}.`);
   }
-  const authentication = safeAuthStatus(invoke(["auth", "status", "--json"], { allowFailure: true }).stdout);
+  const authentication = safeAuthStatus(
+    (await invoke(["auth", "status", "--json"], { allowFailure: true })).stdout,
+  );
   return { version, authentication, capabilities: "passed" };
 }
 
-function authenticateGitcode(cliExecutable, authentication, run, platform, write, jsonOutput) {
+async function authenticateGitcode(
+  cliExecutable,
+  authentication,
+  runInteractive,
+  runLong,
+  platform,
+  write,
+  progress,
+  jsonOutput,
+) {
   if (authentication.logged_in) {
     return authentication;
   }
-  const invoke = cliInvoker(cliExecutable, run, platform);
+  const invokeLong = cliInvoker(cliExecutable, runLong, platform);
   write("GitCode authentication is required. Opening the official browser login.");
-  write("Complete the GitCode page shown by the CLI; do not paste a token into this terminal or the conversation.");
-  invoke(["auth", "login", "--web"], {
-    inherit: true,
-    outputToStderr: jsonOutput,
-  });
-  authentication = safeAuthStatus(invoke(["auth", "status", "--json"], { allowFailure: true }).stdout);
+  write("Create the token in the browser, paste it at the CLI prompt, then press Enter.");
+  write("Waiting for the GitCode CLI login process to finish; token verification can take up to 30 seconds.");
+  await runInteractive(
+    interactiveExecutableCommand(cliExecutable, ["auth", "login", "--web"], platform),
+    {
+      inherit: true,
+      outputToStderr: jsonOutput,
+    },
+  );
+  authentication = await progress.run("Verifying GitCode authentication", async () => safeAuthStatus(
+    (await invokeLong(["auth", "status", "--json"], { allowFailure: true })).stdout,
+  ));
   if (!authentication.logged_in) {
     throw new BootstrapError("GitCode browser login did not produce an authenticated CLI session.", 2);
   }
@@ -969,8 +1100,16 @@ export async function runSetup(options, dependencies = {}) {
   const platform = dependencies.platform || process.platform;
   const environment = dependencies.environment || process.env;
   const run = dependencies.run || execute;
+  const runLong = dependencies.runLong || dependencies.run || executeAsync;
+  const runInteractive = dependencies.runInteractive || dependencies.run || executeAsync;
   const write = dependencies.write || ((line) => console.log(line));
   const writePlan = dependencies.writePlan || write;
+  const writeProgress = options.json ? writePlan : write;
+  const progress = dependencies.progress || createProgress(
+    dependencies.progressOutput || (options.json ? process.stderr : process.stdout),
+    writeProgress,
+    dependencies.timers,
+  );
   const targetSelection = await resolveClientTargets(
     options,
     run,
@@ -1003,11 +1142,14 @@ export async function runSetup(options, dependencies = {}) {
   run(namedCommand("npm", ["--version"], platform));
   const npmPrefix = run(namedCommand("npm", ["config", "get", "prefix"], platform)).stdout.trim();
   const gitVersion = run(namedCommand("git", ["--version"], platform)).stdout.trim();
-  const latestResult = runOptional(run, namedCommand(
-    "npm",
-    ["view", "@gitcode-cli/cli", "version", `--registry=${REGISTRY}`],
-    platform,
-  ));
+  const latestResult = await progress.run(
+    "Checking the latest GitCode CLI version",
+    () => runOptionalAsync(runLong, namedCommand(
+      "npm",
+      ["view", "@gitcode-cli/cli", "version", `--registry=${REGISTRY}`],
+      platform,
+    )),
+  );
   const diagnosis = diagnoseGitcode(run, platform);
   diagnosis.officialLatest = latestResult.status === 0 ? latestResult.stdout.trim() || null : null;
   const gitcodeInstall = gitcodeInstallDetails(diagnosis.classification, environment, platform, npmPrefix);
@@ -1052,27 +1194,40 @@ export async function runSetup(options, dependencies = {}) {
     validateWrapper(gitcodeInstall, platform);
   }
 
-  const installed = installGitcode(plan, run, platform);
-  const gitcode = validateCore(installed.executable, run, platform);
+  const installed = await progress.run(
+    "Installing the official GitCode CLI",
+    () => installGitcode(plan, runLong, run, platform),
+  );
+  const gitcode = await progress.run(
+    "Validating GitCode CLI capabilities",
+    () => validateCore(installed.executable, runLong, platform),
+  );
   gitcode.command = installed.command;
   gitcode.executable = installed.executable;
 
-  run(pipInvocation);
-  run({ command: python.executable, args: ["-c", "import playwright.sync_api"] });
-  gitcode.authentication = authenticateGitcode(
+  await progress.run("Installing reviewed Python dependencies", () => runLong(pipInvocation));
+  await progress.run(
+    "Verifying the Playwright Python package",
+    () => runLong({ command: python.executable, args: ["-c", "import playwright.sync_api"] }),
+  );
+  gitcode.authentication = await authenticateGitcode(
     installed.executable,
     gitcode.authentication,
-    run,
+    runInteractive,
+    runLong,
     platform,
-    options.json ? writePlan : write,
+    writeProgress,
+    progress,
     options.json,
   );
-  const skills = skillInstalls.map(({ layout, details }) => ({
-    kind: layout.kind,
-    clients: layout.clients,
-    status: installBundledSkill(details),
-    target: layout.workflowDir,
-  }));
+  const skills = await progress.run("Installing msdevflow skill targets", async () => (
+    skillInstalls.map(({ layout, details }) => ({
+      kind: layout.kind,
+      clients: layout.clients,
+      status: installBundledSkill(details),
+      target: layout.workflowDir,
+    }))
+  ));
   const result = {
     state: "ready",
     git: gitVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "msdevflow",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Install the msdevflow GitCode skill and its runtime dependencies",
   "type": "module",
   "bin": {
@@ -10,7 +10,9 @@
     "bin/",
     "lib/",
     "skill/",
-    "!skill/msdevflow/scripts/test_openlibing_ci.py"
+    "!skill/msdevflow/scripts/test_openlibing_ci.py",
+    "!skill/**/__pycache__/**",
+    "!skill/**/*.pyc"
   ],
   "scripts": {
     "check": "node --check bin/msdevflow.js && node --check lib/bootstrap.js",

package/skill/msdevflow/README.md

@@ -1,9 +1,23 @@
 # msdevflow
 
-通用 GitCode Issue 到 PR 合入 workflow skill。它保留一个统一 skill，通过显式 `action` 单独执行某一部分；未指定 `action` 时，按远端和本地证据运行完整作者端到端流程。
+通用 GitCode Issue 到 PR 合入 workflow skill。它保留一个统一 skill：显式 `action=<name>` 直接执行单项能力；未提供 action 时先通过客户端原生选择菜单路由，再读取仓库或访问 GitCode。
 
 ## 1. Action 模型
 
+无 action 调用的菜单为：
+
+```text
+选择运行方式
+├─ 完整端到端流程
+├─ 作者工作流
+│  ├─ Issue 管理 -> discover | create-issue | issue
+│  ├─ 开发与交付 -> develop | pr | ci
+│  └─ PR 后续 -> feedback | merge
+└─ 独立工具 -> openlibing-auth | code-review
+```
+
+Claude Code 使用 `AskUserQuestion`，Codex 使用 `request_user_input`，OpenCode 使用 `question`。每次只显示当前层且不超过 3 项；没有可用选择工具时只输出当前层编号选项并等待回复。菜单选择前不探测仓库、不调用 GitCode、不读写远端，也不加载 action reference。选中叶子后等同于显式 action，且保留原调用正文中的 URL、路径、仓库和模式。
+
 支持：
 
 | action | 能力 | 完成后行为 |
@@ -28,7 +42,7 @@
 
 ## 2. 完整作者 E2E
 
-未指定 `action` 时，从环境、CLI 能力和仓库画像开始运行完整流程：
+无 action 菜单选中“完整端到端流程”后，从环境、CLI 能力和仓库画像开始运行完整流程：
 
 ```text
 discover -> issue -> develop -> pr -> ci
@@ -55,9 +69,9 @@ discover -> issue -> develop -> pr -> ci
 
 ## 4. 调用示例
 
-以下示例使用 Claude Code 的 `/msdevflow` 形式。Codex 使用 `$msdevflow`、`/skills` 或隐式匹配；OpenCode 使用 skill 工具或隐式匹配。无论客户端入口如何，正文中的 `action=<name>` 和其余任务参数保持相同。
+以下示例使用 Claude Code 的 `/msdevflow` 形式。Codex 使用 `$msdevflow` 或从 `/skills` 选择；OpenCode 使用 `/skills` 选择 `msdevflow`，不要用 `@` 查找 Skill。没有 `action=` 时，提交后先出现分级菜单；显式 `action=<name>` 则不显示菜单，直接路由。无论客户端入口如何，正文中的 action 和其余任务参数保持相同。
 
-### 未指定 action：完整 E2E
+### 通过菜单选择完整 E2E
 
 ```text
 /msdevflow
@@ -206,7 +220,7 @@ git --version
 <gitcode-command> auth login --web
 ```
 
-用户只在 GitCode CLI 打开的官方浏览器页面完成登录。不要把 Token 粘贴到对话、setup、README、项目文件或命令 URL 中；如需手动恢复认证，也优先在自己的终端运行同一 `--web` 命令。
+GitCode CLI 会打开官方页面让用户创建 Token，再在 CLI 自己的终端提示中接收粘贴内容并验证。Token 只能粘贴到该 CLI 提示；不要放入 Agent 对话、命令参数、项目文件、README、URL 或日志。`msdevflow` 父进程不读取或输出 Token；如需手动恢复认证，在自己的终端运行同一 `--web` 命令。
 
 ## 6. 安装
 
@@ -263,7 +277,7 @@ npm 包尚未发布时，可从当前源码/发布目录运行等价入口：
 node ./msdevflow/bin/msdevflow.js setup
 ```
 
-`setup` 不下载或启动 Chromium。凭证只由 GitCode CLI 和官方浏览器流程接收与保存；setup 不读取、输出或转存 Token，也不要求用户把 Token 传给 Agent。每个已有 skill 目标只有 manifest 明确标识为 `msdevflow` 时才允许更新，来源不明的目录、文件或符号链接会被拒绝覆盖。安装后重启或重新加载对应客户端。
+`setup` 不下载或启动 Chromium。GitCode Token 只由 GitCode CLI 自己的终端提示接收并验证；setup 父进程不读取、输出或转存 Token，也不要求用户把 Token 传给 Agent。每个已有 skill 目标只有 manifest 明确标识为 `msdevflow` 时才允许更新，来源不明的目录、文件或符号链接会被拒绝覆盖。安装后重启或重新加载对应客户端。
 
 ## 7. 仓库画像和 PR 模板
 

package/skill/msdevflow/SKILL.md

@@ -1,20 +1,52 @@
 ---
 name: msdevflow
 description: >
-  通用 GitCode Issue 到 PR 合入工作流。未指定 action 时，从环境与仓库画像开始，按远端和本地证据幂等推进完整作者流程；也支持通过 action=discover、create-issue、issue、develop、pr、ci、openlibing-auth、feedback、code-review 或 merge 只执行单个能力。适用于发现、新建或接取 GitCode Issue、开发并创建 PR、处理 CI、验证 openLiBing OAuth、处理自己 PR 的检视意见、检视他人 PR，以及在独立审批和显式确认后合入。仅适用于已授权的 GitCode 仓库。
+  通用 GitCode Issue 到 PR 合入工作流。无 action 调用时通过宿主原生选择菜单路由到完整作者流程或独立能力；也支持通过 action=discover、create-issue、issue、develop、pr、ci、openlibing-auth、feedback、code-review 或 merge 直接执行单个能力。适用于发现、新建或接取 GitCode Issue、开发并创建 PR、处理 CI、验证 openLiBing OAuth、处理自己 PR 的检视意见、检视他人 PR，以及在独立审批和显式确认后合入。仅适用于已授权的 GitCode 仓库。
 compatibility: Requires Git, Node.js >=18, Python >=3.10, GitCode access, and the setup-installed GitCode CLI. Supports Claude Code, Codex, and OpenCode.
 metadata:
-  version: 2.0.0
+  version: 2.1.0
   source: msdevflow
 ---
 
 # msdevflow：GitCode Issue 到 PR 合入
 
-把 GitCode 工作拆成可显式调用的 action，同时保留未指定 action 时的完整作者 E2E 编排。先探测仓库规范和 CLI 能力，不硬编码组织、默认分支、CI、分支命名、合并方式或机器人协议。
+把 GitCode 工作拆成可显式调用的 action；无 action 调用先通过选择菜单路由到完整作者 E2E 或独立能力。选定流程后再探测仓库规范和 CLI 能力，不硬编码组织、默认分支、CI、分支命名、合并方式或机器人协议。
 
 ## Action 路由
 
-只识别显式参数 `action=<name>`。未知 action 停止并列出有效值，不做远端写入。
+识别显式参数 `action=<name>`；显式 action 直接路由，不显示菜单。未知 action 停止并列出有效值，不做远端写入。仅当用户调用本 skill 且没有提供 `action=` 时，必须先执行下述菜单路由，不得在选择完成前探测仓库、调用 GitCode、读写远端或加载 action reference。
+
+### 无 action 菜单路由
+
+优先使用当前宿主提供的原生单选工具：Claude Code 使用 `AskUserQuestion`，Codex 使用 `request_user_input`，OpenCode 使用 `question`；不要仅因工具名称不同而跳过菜单。每次只问一个问题，选项不超过 3 个，等待用户选择后再进入下一层：
+
+```text
+选择运行方式
+├─ 完整端到端流程 -> full-e2e
+├─ 作者工作流
+│  ├─ Issue 管理
+│  │  ├─ discover
+│  │  ├─ create-issue
+│  │  └─ issue
+│  ├─ 开发与交付
+│  │  ├─ develop
+│  │  ├─ pr
+│  │  └─ ci
+│  └─ PR 后续
+│     ├─ feedback
+│     └─ merge
+└─ 独立工具
+   ├─ openlibing-auth
+   └─ code-review
+```
+
+菜单规则：
+
+1. 顶层“完整端到端流程”不是 action；选中后按“完整作者 E2E”执行，并在内部将本次路由记为 `full-e2e`。
+2. 每级原生菜单都把推荐项放在首位，并按宿主约定标明推荐：顶层推荐“完整端到端流程”；作者工作流分类推荐“Issue 管理”；各叶子层分别推荐 `discover`、`develop`、`feedback` 和 `openlibing-auth`。不得为了改变推荐项而提前探测仓库或远端。
+3. 选中叶子 action 后，等同于用户显式提供了对应 `action=<name>`，严格遵守显式 action 契约；保留调用正文中已经给出的 URL、路径、仓库和模式等参数。
+4. 宿主没有可用选择工具、选择工具在当前模式被禁用，或处于非交互运行时，只输出当前层的编号文本选项并停止等待用户回复；不得自行选择默认项，也不得把多层菜单一次性展开。
+5. 只要调用中没有字面量 `action=<name>`，即使自然语言看似指向某个流程，也必须从顶层菜单开始；不得根据意图猜测跳过菜单。菜单选择属于当前 skill 调用，选定后立即继续，不要求用户重新输入 `/msdevflow`。
 
 | action | 目标 | 主要输入 | 完成后立即停止于 | 必读文件 |
 |---|---|---|---|---|
@@ -29,7 +61,7 @@ metadata:
 | `code-review` | 检视他人的 PR，发布 finding 或 `/lgtm` | 他人 PR | `review-findings`、`review-passed`、`review-incomplete`、`waiting` 或 `blocked` | [references/code-review.md](references/code-review.md) |
 | `merge` | 核验门禁并在最终确认后合入 | canonical PR | `merged`、`waiting` 或 `blocked` | [references/review-and-merge.md](references/review-and-merge.md) |
 
-`code-review` 只能显式调用，永不进入作者 E2E，不得检视或批准当前账号自己的 PR。它固定当前 head，完整检视权威 diff、必要上下文和既有 discussions：有高置信度问题时发布经确认且逐字回读的 finding，不发送 `/lgtm`；没有问题、没有有效未解决意见且覆盖完整时，在针对当前 PR/head 明确确认后先发布带尾签摘要，再原样发送 `/lgtm`。它不发送 `/approve`、`/merge`，不修改作者代码。
+`code-review` 只能通过显式 `action=code-review` 或“独立工具”菜单叶子独立调用，永不进入作者 E2E，不得检视或批准当前账号自己的 PR。它固定当前 head，完整检视权威 diff、必要上下文和既有 discussions：有高置信度问题时发布经确认且逐字回读的 finding，不发送 `/lgtm`；没有问题、没有有效未解决意见且覆盖完整时，在针对当前 PR/head 明确确认后先发布带尾签摘要，再原样发送 `/lgtm`。它不发送 `/approve`、`/merge`，不修改作者代码。
 
 ## 显式 action 契约
 
@@ -41,9 +73,9 @@ metadata:
 6. `ci` 和完整 E2E 在 openLiBing 只读接口返回 401/403 时可运行 OAuth 认证子流程并恢复原流程；这是读取当前 CI 证据的必要步骤，不视为越界执行显式 `openlibing-auth` action。
 7. 所有远端写仍遵循 guided/autonomous 授权、UTF-8、尾签、幂等和最终 merge 确认规则。
 
-## 未指定 action：完整作者 E2E
+## 完整作者 E2E
 
-未提供 `action` 时，从 Phase 0 环境、CLI 能力和仓库画像开始运行完整流程；“从头开始”只表示重新读取事实，不表示重复创建资源或重复评论。按证据幂等跳过已完成步骤：
+只有无 action 菜单选中 `full-e2e` 后，才从 Phase 0 环境、CLI 能力和仓库画像开始运行完整流程；调用正文可以提供完整 E2E 所需的 URL、路径、仓库和模式，但不能替代菜单选择。“从头开始”只表示重新读取事实，不表示重复创建资源或重复评论。按证据幂等跳过已完成步骤：
 
 ```text
 discover -> issue -> develop -> pr -> ci
@@ -65,7 +97,7 @@ discover -> issue -> develop -> pr -> ci
 1. 固定 `gitcode_command`：无 Python 同名工具时为 `gitcode`；有 Python `gitcode` 时保留它并使用 `gitcode-npm`。来源不明时停止，不覆盖。
 2. 检查当前目录；若不是 Git 仓库，自动探测直接子目录中的 Git 仓库及 remotes。
 3. 确认 canonical repository、source repository、operation target、当前账号和授权范围。
-4. 除纯只读 `discover` 外，显式 action 先从 [references/setup-and-issue.md](references/setup-and-issue.md) 只读取公共环境、仓库上下文和最小充分仓库画像，不执行其中的 Issue 接取业务；随后只加载该 action 对应 reference 及实际触发的深层规则。`create-issue` 的模板选择和写入只按 [references/create-issue.md](references/create-issue.md)，不执行候选发现或既有 Issue 核验。`code-review` 只使用公共只读画像和 [references/code-review.md](references/code-review.md)，不加载作者 feedback/merge 规则。未指定 action 也只按当前位置渐进加载。
+4. 除纯只读 `discover` 外，显式 action 先从 [references/setup-and-issue.md](references/setup-and-issue.md) 只读取公共环境、仓库上下文和最小充分仓库画像，不执行其中的 Issue 接取业务；随后只加载该 action 对应 reference 及实际触发的深层规则。`create-issue` 的模板选择和写入只按 [references/create-issue.md](references/create-issue.md)，不执行候选发现或既有 Issue 核验。`code-review` 只使用公共只读画像和 [references/code-review.md](references/code-review.md)，不加载作者 feedback/merge 规则。`full-e2e` 也只按当前位置渐进加载。
 5. CLI 缺失、命令不兼容或版本不足时读 [references/command-capabilities.md](references/command-capabilities.md)，停止当前 action 并提示用户运行独立 setup；setup 成功后恢复原 action。
 6. 进入 autonomous、远端写、危险动作或恢复时读 [references/state-and-safety.md](references/state-and-safety.md)。
 7. 中断恢复、写结果不确定或最终报告时读 [references/recovery.md](references/recovery.md)。

package/skill/msdevflow/references/ci-and-review.md

@@ -107,7 +107,7 @@ commit/head SHA
    - 不采纳：spec/代码/测试依据；
 6. 统一换行为 `\n` 后逐字比较完整远端回复与预期正文，并验证末尾恰好存在一次尾签；发现 `?`、乱码、截断、尾签缺失、重复或其他不一致时先原地修复，未修复前不得 resolve；
 7. 正文回读通过后，仓库规则允许且权限具备时 resolve，再回读确认 `resolved=true`；
-8. 产生新 head 时，显式 `action=feedback` 停止并建议 `action=ci`；未指定 action 的完整作者 E2E 由编排器随后路由到 `ci`。
+8. 产生新 head 时，显式 `action=feedback` 停止并建议 `action=ci`；菜单选中的完整作者 E2E（`full-e2e`） 由编排器随后路由到 `ci`。
 
 不要只发一条总体总结替代逐条回复。汇总应在逐条闭环后发布。
 

package/skill/msdevflow/references/create-issue.md

@@ -1,6 +1,6 @@
 # Action `create-issue`
 
-显式 `action=create-issue` 用于在一个已授权的 canonical repository 中创建一个 GitCode Issue。它是独立 action：创建并回读确认后立即停止，不执行 `discover`、`issue`、接取、查重、代码核验、开发或 PR 流程，也不进入未指定 action 的完整作者 E2E。
+显式 `action=create-issue` 用于在一个已授权的 canonical repository 中创建一个 GitCode Issue。它是独立 action：创建并回读确认后立即停止，不执行 `discover`、`issue`、接取、查重、代码核验、开发或 PR 流程，也不进入菜单选中的完整作者 E2E（`full-e2e`）。
 
 ## 输入和边界
 

package/skill/msdevflow/references/design-and-development.md

@@ -1,6 +1,6 @@
 # Action `develop`：分析、设计与开发
 
-只在显式 `action=develop`，或未指定 action 的完整作者 E2E 已达到 `verified` 时读取。显式 action 启动时先只读确认 Issue 已核验且没有重复实现；前置不足时返回 `blocked` 并建议 `action=issue`，不得自动接取或补跑核验。
+只在显式 `action=develop`，或菜单选中的完整作者 E2E（`full-e2e`） 已达到 `verified` 时读取。显式 action 启动时先只读确认 Issue 已核验且没有重复实现；前置不足时返回 `blocked` 并建议 `action=issue`，不得自动接取或补跑核验。
 
 ## Phase 3：需求分析与设计决策树
 

package/skill/msdevflow/references/pr-and-ci.md

@@ -1,6 +1,6 @@
 # Action `pr` 与 `ci`
 
-只在显式 `action=pr`、`action=ci`，或未指定 action 的完整作者 E2E 路由到对应位置时读取。任何远端写前同时读取 [state-and-safety.md](state-and-safety.md)。CI 触发或失败时再读取 [ci-and-review.md](ci-and-review.md)，不要提前加载。
+只在显式 `action=pr`、`action=ci`，或菜单选中的完整作者 E2E（`full-e2e`） 路由到对应位置时读取。任何远端写前同时读取 [state-and-safety.md](state-and-safety.md)。CI 触发或失败时再读取 [ci-and-review.md](ci-and-review.md)，不要提前加载。
 
 ## Action `pr`：Commit、Push、普通 PR
 

package/skill/msdevflow/references/recovery.md

@@ -14,7 +14,7 @@
 4. 根据 action 完成条件识别最后一个有证据的状态；不能只信先前摘要或旧 run 产物。
 5. 验证本地分支与远端 source head 是否一致。
 6. 显式 action 只判断自身前置和完成条件：前置缺失时 `blocked`，不得运行上游；已完成时报告证据并立即停止。
-7. 未指定 action 的完整 E2E 从 Phase 0 重建仓库画像，再路由到下一未完成作者 action；不重复已完成的写操作。
+7. 菜单选中的完整作者 E2E（`full-e2e`） 从 Phase 0 重建仓库画像，再路由到下一未完成作者 action；不重复已完成的写操作。
 8. `create-issue` 不执行产品查重；仅在本次创建结果不确定时按目标仓库、当前账号、启动时间、标题和完整正文做有界恢复，无法唯一证明时停止。`openlibing-auth` 的历史 profile 或旧认证摘要不证明当前授权有效；必须用本次固定 run 做真实只读请求。
 9. `code-review` 不参与作者 E2E，也不从作者 feedback 状态恢复。恢复时重新确认 reviewer、author、PR 状态和当前 head；旧 `review_head_sha` 的分析、摘要、finding 或 `/lgtm` 不证明当前 head 已检视。
 10. 当前 head 等于旧 `review_head_sha` 时，回读结构化 comments/discussions，并按 reviewer、head、path/position 和完整正文恢复已发布 finding；检视通过必须同时回读到绑定当前 head 的带尾签摘要和同一 reviewer 的精确 `/lgtm`。

package/skill/msdevflow/references/review-and-merge.md

@@ -1,6 +1,6 @@
 # Action `feedback` 与 `merge`
 
-只在显式 `action=feedback`、`action=merge`，或未指定 action 的完整作者 E2E 路由到对应位置时读取。开始时同时读取 [state-and-safety.md](state-and-safety.md)；处理结构化 discussion 或 CI 时按需读取 [ci-and-review.md](ci-and-review.md)。本文件不定义 `action=code-review`。
+只在显式 `action=feedback`、`action=merge`，或菜单选中的完整作者 E2E（`full-e2e`） 路由到对应位置时读取。开始时同时读取 [state-and-safety.md](state-and-safety.md)；处理结构化 discussion 或 CI 时按需读取 [ci-and-review.md](ci-and-review.md)。本文件不定义 `action=code-review`。
 
 ## Action `feedback`：处理自己 PR 的检视意见
 
@@ -31,7 +31,7 @@ PR 不存在时返回 `blocked` 并建议 `action=pr`；source branch 不可写
 6. 创建新 commit 并 push，不 amend、不 force push；
 7. 每条 discussion 在线程内回复：已修复引用 commit；部分采纳、不采纳或延期说明依据；每条回复按 [state-and-safety.md](state-and-safety.md) 使用 UTF-8 安全通道并附加唯一尾签，逐字回读完整正文；
 8. 只有回复正文和尾签回读一致后，仓库规则和权限允许时才 resolve；乱码、`?`、截断或不一致时先原地修复；
-9. 产生新 head 时记录旧 CI 结果已失效，停止后建议 `action=ci`；不得在显式 `feedback` 内触发或监控远端 CI。未指定 action 的完整 E2E 由编排器随后路由到 `ci`。
+9. 产生新 head 时记录旧 CI 结果已失效，停止后建议 `action=ci`；不得在显式 `feedback` 内触发或监控远端 CI。菜单选中的完整作者 E2E（`full-e2e`） 由编排器随后路由到 `ci`。
 
 不要以一条总体评论替代逐条回复。处理完成后不请求重新检视、不触发检视机器人；外部 reviewer 是否重新检视由仓库和人员流程决定。
 

package/skill/msdevflow/references/setup-and-issue.md

@@ -1,6 +1,6 @@
 # Action `discover` 与 `issue`
 
-在显式 `action=discover`、`action=issue`，或未指定 action 的完整作者 E2E 启动时读取；显式 `action=create-issue` 只读取本文件的公共环境、仓库上下文和最小充分画像，模板和写入业务转到 [create-issue.md](create-issue.md)，不得执行本文件的发现、接取或重复实现核验。`discover` 全程只读并在候选报告后立即停止；`issue` 只接取和核验指定 Issue，达到 `verified` 后立即停止，不进入开发。
+在显式 `action=discover`、`action=issue`，或菜单选中的完整作者 E2E（`full-e2e`） 启动时读取；显式 `action=create-issue` 只读取本文件的公共环境、仓库上下文和最小充分画像，模板和写入业务转到 [create-issue.md](create-issue.md)，不得执行本文件的发现、接取或重复实现核验。`discover` 全程只读并在候选报告后立即停止；`issue` 只接取和核验指定 Issue，达到 `verified` 后立即停止，不进入开发。
 
 显式 `action=issue` 必须提供 Issue URL 或编号。缺少目标时只做确认输入缺失所需的只读核验，随后返回 `blocked` 并建议先运行 `action=discover`；不得在本 action 内查询候选、让用户选择 Issue 或执行 `discover` 的业务。
 
@@ -98,7 +98,7 @@ pr_number（如已有）
 
 ## Phase 1：发现与接取
 
-显式 `action=issue` 直接读取输入中的 Issue URL/编号；缺少目标时按本文件入口规则返回 `blocked`。显式 `action=discover` 或未指定 action 的完整作者 E2E 尚无目标时，才对“无目标发现”确认出的每个 canonical 查询当前用户负责的开放 Issue：
+显式 `action=issue` 直接读取输入中的 Issue URL/编号；缺少目标时按本文件入口规则返回 `blocked`。显式 `action=discover` 或菜单选中的完整作者 E2E（`full-e2e`） 尚无目标时，才对“无目标发现”确认出的每个 canonical 查询当前用户负责的开放 Issue：
 
 ```bash
 <gitcode-command> issue list -R <canonical> --state open --assignee <username> --json