ly-workflow-codex 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 fengshao1227
+Copyright (c) 2025 yang.li12
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# ly-workflow-codex
+
+> Codex 单 Agent 工作流：同一 Codex 会话内自己完成探索 / 方案 / 实施 / 审查编排；方案审查与代码审查两个关卡由**双审查 subagent**（fork 当前会话上下文 + 范围点名 + 独立审 → 交换 → 共识）执行，实施由 **coding subagent** 执行。最大化复用 OpenSpec 原生工作流。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+
+## 安装
+
+```bash
+npx ly-workflow-codex        # 交互式菜单（含 openspec 依赖 preflight 检查）
+npx ly-workflow-codex init   # 全量初始化（生成 AGENTS.md + openspec init）
+```
+
+- CLI 二进制名 `lycx`（子命令：`init`/`doctor`/`status`/`uninstall`，裸命令进菜单；`update` 在菜单内）
+- 安装产物：14 个 `@lyx-*` skills（`SKILL.md`）→ `~/.agents/skills/lyx-*/`；8 个角色提示词 → `~/.ly/prompts/codex/`
+- 配置：`~/.ly/config.toml`——首次读取/写入时自动从旧 `~/.claude/.ly/config.toml` 迁移（新位置已有配置则不覆盖）
+- 初始化向导采集流程：语言 → API 提供方（`~/.codex/config.toml` 现有 `[model_providers.*]` / OpenAI 官方 / 自定义）→ 模型三连（共用 provider 模型列表逐个选择：`codexHost.reviewModel` 审查 agent A / `reviewModelB` 审查 agent B / `codingModel` coding subagent，可"自定义输入…"或"不设置（回退当前会话模型）"，拉取失败回退自由输入）→ 配置摘要（三模型各自状态）
+
+## 命令（14 个 `@lyx-*` skills）
+
+| 命令 | 用途 |
+|------|------|
+| `@lyx-init` | 生成项目 AGENTS.md + 初始化 OpenSpec 目录结构 + 自动 commit |
+| `@lyx-explore` | 想清楚再动手（委托 `@openspec-explore skill`），收敛到方案时提示转 `@lyx-propose` |
+| `@lyx-propose` | 创建方案前问一次隔离方式（三选一：隔离 worktree【从当前分支 HEAD 切出、同会话 cd 续跑，续接命令为异常兜底】/ 本项目切新分支【仅分支隔离，脏改动三选处置】/ 留在当前分支）+ 问"全自动/手动" → 委托 `@openspec-propose skill` → 方案自审（四项检查 + 逐项结论清单；机械断链直接修、业务判断类问用户）→ commit `propose: <change>`；全自动 = review-plan → apply → review-code 流水线，手动 = 逐步确认 |
+| `@lyx-apply` | **coding subagent 实施**：spawn coding subagent（fork 当前上下文 + 只实施 change 范围，模型按 `codingModel` 指定）读 tasks.md 逐任务实施 + 验证 + 勾 checkbox → 回传主会话，主会话确认后统一 commit `apply: <change>`；环境级不可用回退当前会话，业务失败转人工 |
+| `@lyx-archive` | 归档完成的 change（委托 `@openspec-archive-change skill`）+ 自动 commit |
+| `@lyx-review-plan` | 审方案：**双审查 subagent**（角色词 `plan-reviewer.md`，fork 上下文 + 范围点名，模型按 `reviewModel`/`reviewModelB` 分别指定）分级审查，独立审→交换→共识，分歧主会话拍板；审查-修复循环直到 Critical 清零或触发终止条件（全局轮数上限 5，清零优先），清零统一提交修复 |
+| `@lyx-review-code` | 审代码：同上（角色词 `reviewer.md`），Critical/Warning/Info 分级 |
+| `@lyx-release` | GitFlow 四场景发版（feature/release/hotfix/dev-offline），SemVer 自动推导版本号；上线合并二选一（远端 PR 默认 / 本地直接合并）+ 主分支名检测（master/main） |
+| `@lyx-changelog` | 按 commit 前缀分组生成/更新 Keep a Changelog 格式的 CHANGELOG.md |
+| `@lyx-publish` | npm 包发布四场景（bmc 私域 Nexus / GitHub Packages / npmjs + GitHub Release / CI 自动发布），前置检查→版本号推导→构建→发布→验证 |
+| `@lyx-commit` `@lyx-rollback` `@lyx-clean-branches` `@lyx-worktree` | Git 工具（worktree 只留 `add`/`list`/`remove`/`prune`/`migrate`，`switch` 已移除——隔离切换统一由 `@lyx-propose` 触发） |
+
+审查-修复循环细节（增量传递、沿用同一批审查 subagent、终止条件、提交时机）内联在各 skill 模板（`@lyx-review-plan` / `@lyx-review-code`）；[docs/codex-exec-contract.md](./docs/codex-exec-contract.md) 已 DEPRECATED，仅作历史参考。
+
+## 典型工作流
+
+```
+@lyx-init
+@lyx-propose "要做什么"    # 隔离三选一 + 全自动/手动
+@lyx-review-plan            # 审方案（双审查 subagent）
+@lyx-apply                  # coding subagent 实施 + 主会话统一 commit
+@lyx-review-code            # 审代码（双审查 subagent）
+@lyx-archive
+```
+
+## 架构
+
+- **codex 单 Agent 编排**：当前 Codex 会话完成探索 → 方案 → 自审 → 实施 → 修复的全部编排；无 wrapper、无 Web UI、无 routing/implementer 后端选择
+- **审查关卡 = 双审查 subagent**：每关 spawn 2 个审查 subagent（fork 当前会话上下文 + 任务点名"只审 change 范围"），各自独立审 → 交换结论 → 达成共识；意见分歧 → 主会话拍板并显式提示用户，不能确认 → 判定 Critical；模型按 `codexHost.reviewModel`/`reviewModelB` 分别指定（未配置回退当前会话模型）；角色词绝对路径 `~/.ly/prompts/codex/` 为行为契约
+- **apply = coding subagent 实施**：spawn 一个 coding subagent（fork 当前上下文 + 只实施 change 范围），模型 = `codexHost.codingModel`；coding subagent 不自行 commit，结果回传主会话，由主会话确认后统一提交 `apply: <change-name>`；环境级不可用回退当前会话直接实施，业务失败原样呈报转人工
+- **发布**：打 tag `v*.*.*` push 触发 GitHub Actions 自动发 npm 包；无独立二进制构建步骤
+- **生命周期**：直接委托 OpenSpec 原生 skills（`@openspec-explore` / `@openspec-propose` / `@openspec-apply-change` / `@openspec-archive-change`），安装器只负责 preflight（openspec CLI + openspec-* skills 检测）与安装
+
+## 与 ly-workflow 的关系
+
+- **ly-workflow**（上游原仓库）是双宿主工具（claude + codex）；**ly-workflow-codex** 是它的 codex 单宿主独立版：砍掉 claude 宿主、wrapper、Web UI、routing 概念，审查/实施改为 **subagent 多 Agent 模式**（双审查 subagent + coding subagent，执行约定内联在各 skill 模板）
+- **安装位与旧包（v0.2.0 前）不再冲突**：本包命令以 `@lyx-*` skills 安装在 `~/.agents/skills/lyx-*/`（Codex 官方 skill 发现目录），与 ly-workflow 的 codex 分支产物（`~/.codex/prompts/ly-*.md`）互不覆盖；`~/.codex/prompts/ly-*.md` 旧残留由本包 init/uninstall 自动清理
+- **迁移路径**：先卸载旧包（`npx ly-workflow` 的 uninstall）再安装本包；或直接 `npx ly-workflow-codex init --force` 覆盖安装（同时清理旧安装位残留）。配置 `~/.ly/config.toml` 由本包自动从旧 `~/.claude/.ly/config.toml` 迁移
+
+## License
+
+MIT

package/bin/lycx.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.mjs'

package/dist/chunks/legacy-cleanup.mjs

@@ -0,0 +1,143 @@
+import { readFile, writeFile, readdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import fs from 'fs-extra';
+
+async function removePath(target) {
+  await fs.remove(target);
+}
+async function cleanupCodexAgentsMd(result, dirs) {
+  const filePath = join(dirs.codexDir, "AGENTS.md");
+  if (!await fs.pathExists(filePath)) {
+    result.skipped.push("~/.codex/AGENTS.md (not found)");
+    return;
+  }
+  try {
+    const content = await readFile(filePath, "utf-8");
+    const stripped = content.replace(/<!-- LY:START[\s\S]*?-- LY:END -->\n?/g, "");
+    if (stripped !== content) {
+      const tmpPath = `${filePath}.tmp`;
+      await writeFile(tmpPath, stripped);
+      await fs.move(tmpPath, filePath, { overwrite: true });
+      result.cleaned.push("~/.codex/AGENTS.md (LY blocks stripped)");
+    } else {
+      result.skipped.push("~/.codex/AGENTS.md (no LY blocks)");
+    }
+  } catch (error) {
+    result.failed.push(`~/.codex/AGENTS.md: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function cleanupCodexConfigTomlLyBlocks(result, dirs) {
+  const filePath = join(dirs.codexDir, "config.toml");
+  if (!await fs.pathExists(filePath)) {
+    result.skipped.push("~/.codex/config.toml (not found)");
+    return;
+  }
+  try {
+    const content = await readFile(filePath, "utf-8");
+    const hasLyMarker = /^\s*#\s*(?:ly-workflow\b|Installed by: npx ly-workflow\b|Added by ly-workflow-codex\b)/m.test(content);
+    if (!hasLyMarker) {
+      result.skipped.push("~/.codex/config.toml (no ly-workflow write markers)");
+      return;
+    }
+    const lines = content.split("\n");
+    const out = [];
+    let removed = false;
+    let inLyTable = false;
+    let headerZone = true;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (headerZone && trimmed.startsWith("#")) {
+        if (/^#\s*ly-workflow/.test(trimmed) || /^#\s*Installed by: npx ly-workflow/.test(trimmed) || /^#\s*Added by ly-workflow-codex/.test(trimmed)) {
+          removed = true;
+          continue;
+        }
+        out.push(line);
+        continue;
+      }
+      if (trimmed !== "")
+        headerZone = false;
+      if (inLyTable) {
+        if (trimmed.startsWith("[")) {
+          inLyTable = false;
+        } else {
+          removed = true;
+          continue;
+        }
+      }
+      if (trimmed.startsWith("[features.multi_agent_v2]")) {
+        removed = true;
+        inLyTable = true;
+        continue;
+      }
+      out.push(line);
+    }
+    if (removed) {
+      const tmpPath = `${filePath}.tmp`;
+      await writeFile(tmpPath, out.join("\n"));
+      await fs.move(tmpPath, filePath, { overwrite: true });
+      result.cleaned.push("~/.codex/config.toml (LY blocks stripped)");
+    } else {
+      result.skipped.push("~/.codex/config.toml (no LY blocks)");
+    }
+  } catch (error) {
+    result.failed.push(`~/.codex/config.toml: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function cleanupCodexAgents(result, dirs) {
+  const agentsDir = join(dirs.codexDir, "agents");
+  if (!await fs.pathExists(agentsDir)) {
+    result.skipped.push("~/.codex/agents (not found)");
+    return;
+  }
+  try {
+    let lyFiles = 0;
+    for (const file of await readdir(agentsDir)) {
+      if (!(file.startsWith("ly-") && file.endsWith(".toml")))
+        continue;
+      lyFiles++;
+      const filePath = join(agentsDir, file);
+      const content = await readFile(filePath, "utf-8");
+      if (!/ly-workflow|Installed by: npx ly-workflow|Added by ly-workflow-codex/.test(content)) {
+        result.skipped.push(`~/.codex/agents/${file} (no ly-workflow write marker)`);
+        continue;
+      }
+      try {
+        await removePath(join(agentsDir, file));
+        result.cleaned.push(`~/.codex/agents/${file}`);
+      } catch (error) {
+        result.failed.push(`~/.codex/agents/${file}: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+    if (lyFiles === 0)
+      result.skipped.push("~/.codex/agents (no ly-*.toml)");
+  } catch (error) {
+    result.failed.push(`~/.codex/agents: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function cleanupLegacyArtifacts(options) {
+  const result = { cleaned: [], skipped: [], failed: [] };
+  const dirs = {
+    codexDir: options?.codexDir ?? join(homedir(), ".codex")
+  };
+  await cleanupCodexAgentsMd(result, dirs);
+  await cleanupCodexConfigTomlLyBlocks(result, dirs);
+  await cleanupCodexAgents(result, dirs);
+  return result;
+}
+function reportCleanupResult(result) {
+  if (result.cleaned.length > 0) {
+    console.log(`  \u2713 \u6B8B\u7559\u6E05\u7406 cleaned: ${result.cleaned.length} \u9879`);
+    for (const item of result.cleaned) console.log(`    - ${item}`);
+  }
+  if (result.skipped.length > 0) {
+    console.log(`  - \u6B8B\u7559\u6E05\u7406 skipped: ${result.skipped.length} \u9879\uFF08\u4E0D\u5B58\u5728\u6216\u65E0\u9700\u5904\u7406\uFF09`);
+    for (const item of result.skipped) console.log(`    - ${item}`);
+  }
+  if (result.failed.length > 0) {
+    console.log("  \u26A0 \u6B8B\u7559\u6E05\u7406\u5931\u8D25\uFF08\u4E0D\u963B\u65AD\uFF09:");
+    for (const item of result.failed) console.log(`    - ${item}`);
+  }
+}
+
+export { cleanupLegacyArtifacts, reportCleanupResult };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+

package/dist/cli.d.ts

@@ -0,0 +1 @@
+

package/dist/cli.mjs

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+import cac from 'cac';
+import { homedir } from 'node:os';
+import ansis from 'ansis';
+import inquirer from 'inquirer';
+import { join } from 'pathe';
+import { a as i18n, t as AGENTS_SKILLS_DIR, r as readLyConfig, L as LY_PROMPTS_DIR, v as version, P as PACKAGE_NAME, b as initI18n, s as showMainMenu, i as init, l as uninstallWorkflows, B as BIN_NAME } from './shared/ly-workflow-codex.K-E7PMp3.mjs';
+import { execFile, spawn, execSync } from 'node:child_process';
+import fs from 'fs-extra';
+import { existsSync } from 'node:fs';
+import 'node:util';
+import 'ora';
+import 'smol-toml';
+import 'i18next';
+import 'node:url';
+
+const DEPENDENT_COMMANDS = ["@lyx-init", "@lyx-explore", "@lyx-propose", "@lyx-review-plan", "@lyx-archive"];
+const INSTALL_CMD = ["npm", "install", "-g", "@fission-ai/openspec@latest"];
+const SHELL_OPT = process.platform === "win32" ? { shell: true } : {};
+const OPENSPEC_SKILL_NAMES = [
+  "openspec-explore",
+  "openspec-propose",
+  "openspec-apply-change",
+  "openspec-archive-change"
+];
+function detectOpenspecSkills() {
+  const roots = [
+    AGENTS_SKILLS_DIR,
+    join(process.cwd(), ".agents", "skills")
+  ];
+  return OPENSPEC_SKILL_NAMES.some(
+    (name) => roots.some((root) => existsSync(join(root, name, "SKILL.md")))
+  );
+}
+function detectOpenspecCli() {
+  return new Promise((resolve) => {
+    execFile("openspec", ["--version"], { timeout: 5e3, ...SHELL_OPT }, (err, stdout) => {
+      if (err) {
+        if ("killed" in err && err.killed || err.code === "ETIMEDOUT") {
+          resolve({ installed: true, version: "unknown" });
+          return;
+        }
+        resolve({ installed: false });
+        return;
+      }
+      resolve({ installed: true, version: stdout.toString().trim() || "unknown" });
+    });
+  });
+}
+function printUnavailable() {
+  console.log(ansis.yellow(`  ${i18n.t("common:preflight.unavailableList", { list: DEPENDENT_COMMANDS.join(" ") })}`));
+  console.log(ansis.gray(`  ${i18n.t("common:preflight.unaffectedNote")}`));
+}
+async function runNpmInstall() {
+  return new Promise((resolve) => {
+    const [cmd, ...args] = INSTALL_CMD;
+    const child = spawn(cmd, args, { stdio: "inherit", ...SHELL_OPT });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+function isNonInteractive(skipPrompt) {
+  return Boolean(skipPrompt || process.env.CI || !process.stdin.isTTY || !process.stdout.isTTY);
+}
+async function checkExternalDeps(options) {
+  try {
+    const cli = await detectOpenspecCli();
+    if (cli.installed) {
+      if (!detectOpenspecSkills()) {
+        console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.skillsMissingCodex")}`));
+      }
+      return;
+    }
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.cliMissing")}`));
+    if (isNonInteractive(options?.skipPrompt)) {
+      printUnavailable();
+      return;
+    }
+    const { confirmed } = await inquirer.prompt([{
+      type: "confirm",
+      name: "confirmed",
+      message: i18n.t("common:preflight.installAsk"),
+      default: true
+    }]);
+    if (!confirmed) {
+      printUnavailable();
+      return;
+    }
+    const ok = await runNpmInstall();
+    if (!ok) {
+      console.error(ansis.red(`\u2717 ${i18n.t("common:preflight.installFailed")}`));
+      printUnavailable();
+      return;
+    }
+    const recheck = await detectOpenspecCli();
+    if (!recheck.installed) {
+      console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.installNotInPath")}`));
+      return;
+    }
+    if (detectOpenspecSkills()) {
+      console.log(ansis.green(`\u2713 ${i18n.t("common:preflight.installSuccessWithSkills")}`));
+    } else {
+      console.log(ansis.green(`\u2713 ${i18n.t("common:preflight.installSuccessNeedInit")}`));
+    }
+  } catch {
+  }
+}
+
+const OK = ansis.green("\u2713");
+const WARN = ansis.yellow("\u26A0");
+const FAIL = ansis.red("\u2717");
+async function fileExists(p) {
+  return fs.pathExists(p);
+}
+async function dirFiles(p) {
+  if (!await fs.pathExists(p))
+    return [];
+  return (await fs.readdir(p)).filter((f) => !f.startsWith("."));
+}
+function execSafe(cmd) {
+  try {
+    return execSync(cmd, { stdio: "pipe", timeout: 1e4 }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+async function doctor() {
+  const checks = [];
+  const nodeVer = process.version;
+  const major = Number.parseInt(nodeVer.slice(1));
+  checks.push({
+    label: "Node.js",
+    status: major >= 20 ? OK : FAIL,
+    detail: `${nodeVer}${major < 20 ? " (requires >=20)" : ""}`
+  });
+  const config = await readLyConfig();
+  checks.push({
+    label: "config",
+    status: config ? OK : WARN,
+    detail: config ? `v${config.general?.version || "?"}, lang=${config.general?.language || "?"}` : "Not found (~/.ly/config.toml)"
+  });
+  const skillsEntries = await dirFiles(AGENTS_SKILLS_DIR);
+  const cmdCount = skillsEntries.filter((f) => f.startsWith("lyx-")).length;
+  checks.push({
+    label: "Commands",
+    status: cmdCount > 0 ? OK : FAIL,
+    detail: `${cmdCount} installed (~/.agents/skills/lyx-*/)`
+  });
+  const roleDir = join(LY_PROMPTS_DIR, "codex");
+  const roleFiles = (await dirFiles(roleDir)).filter((f) => f.endsWith(".md"));
+  checks.push({
+    label: "Roles",
+    status: roleFiles.length >= 2 ? OK : roleFiles.length > 0 ? WARN : FAIL,
+    detail: roleFiles.length > 0 ? roleFiles.join(", ") : "None (~/.ly/prompts/codex/)"
+  });
+  const openspecCli = await detectOpenspecCli();
+  checks.push({
+    label: "OpenSpec CLI",
+    status: openspecCli.installed ? OK : WARN,
+    detail: openspecCli.installed ? `v${openspecCli.version}` : i18n.t("common:doctor.openspecCliMissing")
+  });
+  const hasOpenspecSkills = detectOpenspecSkills();
+  checks.push({
+    label: "OpenSpec skills",
+    status: hasOpenspecSkills ? OK : WARN,
+    detail: hasOpenspecSkills ? i18n.t("common:doctor.skillsInitialized") : i18n.t("common:doctor.skillsMissing")
+  });
+  console.log();
+  console.log(ansis.cyan.bold(`  ly-workflow-codex Doctor v${version}`));
+  console.log();
+  for (const { label, status: status2, detail } of checks) {
+    console.log(`  ${status2} ${ansis.bold(label.padEnd(20))} ${ansis.gray(detail)}`);
+  }
+  const failures = checks.filter((c) => c.status === FAIL);
+  console.log();
+  if (failures.length === 0) {
+    console.log(ansis.green("  All checks passed."));
+  } else {
+    console.log(ansis.red(`  ${failures.length} issue(s) found. Run ${ansis.cyan(`npx ${PACKAGE_NAME}`)} to reinstall.`));
+  }
+  console.log();
+}
+async function status() {
+  const config = await readLyConfig();
+  const installedVer = config?.general?.version || "unknown";
+  const latestVer = execSafe(`npm view ${PACKAGE_NAME} version`) || "unknown";
+  const cmds = (await dirFiles(AGENTS_SKILLS_DIR)).filter((f) => f.startsWith("lyx-"));
+  const reviewModel = config?.codexHost?.reviewModel || "\u672A\u914D\u7F6E\uFF08\u56DE\u9000\u5F53\u524D\u4F1A\u8BDD\u6A21\u578B\uFF09";
+  let activeTasks = 0;
+  const tasksDir = join(process.cwd(), ".ly", "tasks");
+  if (await fileExists(tasksDir)) {
+    for (const d of await fs.readdir(tasksDir)) {
+      if (d === "archive")
+        continue;
+      const taskJson = join(tasksDir, d, "task.json");
+      if (await fileExists(taskJson)) {
+        try {
+          const t = await fs.readJSON(taskJson);
+          const s = String(t.status || "").toLowerCase();
+          if (!["completed", "complete", "done", "finished", "archived", "cancelled", "closed"].includes(s)) {
+            activeTasks++;
+          }
+        } catch {
+        }
+      }
+    }
+  }
+  const openspecCli = await detectOpenspecCli();
+  const hasOpenspecSkills = detectOpenspecSkills();
+  console.log();
+  console.log(ansis.cyan.bold("  ly-workflow-codex Status"));
+  console.log();
+  console.log(`  ${ansis.bold("Version")}        ${installedVer}${installedVer !== latestVer ? ansis.yellow(` (latest: ${latestVer})`) : ansis.green(" (up to date)")}`);
+  console.log(`  ${ansis.bold("Commands")}       ${cmds.length}`);
+  console.log(`  ${ansis.bold("Review model")}   ${reviewModel}`);
+  console.log(`  ${ansis.bold("OpenSpec CLI")}   ${openspecCli.installed ? `v${openspecCli.version}` : ansis.yellow(i18n.t("common:doctor.openspecCliMissing"))}`);
+  console.log(`  ${ansis.bold("OpenSpec skills")}${hasOpenspecSkills ? ` ${i18n.t("common:doctor.skillsInitialized")}` : ansis.yellow(` ${i18n.t("common:doctor.skillsMissing")}`)}`);
+  console.log(`  ${ansis.bold("Active tasks")}   ${activeTasks > 0 ? ansis.yellow(String(activeTasks)) : "0"}`);
+  console.log();
+}
+
+function customizeHelp(sections) {
+  sections.unshift({
+    title: "",
+    body: ansis.cyan.bold(`ly-workflow-codex \u2014 Codex \u5355 Agent \u5DE5\u4F5C\u6D41 + OpenSpec \u53CC\u5BA1\u67E5\u5173\u5361 v${version}`)
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.commands")),
+    body: [
+      `  ${ansis.cyan(BIN_NAME)}              ${i18n.t("cli:help.commandDescriptions.showMenu")}`,
+      `  ${ansis.cyan(`${BIN_NAME} init`)} | ${ansis.cyan("i")}     ${i18n.t("cli:help.commandDescriptions.initConfig")}`,
+      `  ${ansis.cyan(`${BIN_NAME} doctor`)}       Check installation health`,
+      `  ${ansis.cyan(`${BIN_NAME} status`)}       Show installation overview`,
+      `  ${ansis.cyan(`${BIN_NAME} uninstall`)}    Uninstall ${PACKAGE_NAME} (non-interactive)`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.shortcuts")}`),
+      `  ${ansis.cyan(`${BIN_NAME} i`)}            ${i18n.t("cli:help.shortcutDescriptions.quickInit")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.options")),
+    body: [
+      `  ${ansis.green("--lang, -l")} <lang>         ${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`,
+      `  ${ansis.green("--force, -f")}               ${i18n.t("cli:help.optionDescriptions.forceOverwrite")}`,
+      `  ${ansis.green("--help, -h")}                ${i18n.t("cli:help.optionDescriptions.displayHelp")}`,
+      `  ${ansis.green("--version, -v")}             ${i18n.t("cli:help.optionDescriptions.displayVersion")}`,
+      `  ${ansis.green("--yes, -y")}                 ${i18n.t("cli:help.optionDescriptions.skipConfirmation")}`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.nonInteractiveMode")}`),
+      `  ${ansis.green("--skip-prompt, -s")}         ${i18n.t("cli:help.optionDescriptions.skipAllPrompts")}`,
+      `  ${ansis.green("--workflows, -w")} <list>    ${i18n.t("cli:help.optionDescriptions.workflows")}`,
+      `  ${ansis.green("--install-dir, -d")} <path>  ${i18n.t("cli:help.optionDescriptions.installDir")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.examples")),
+    body: [
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.showInteractiveMenu")}`),
+      `  ${ansis.cyan(`npx ${PACKAGE_NAME}`)}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.runFullInitialization")}`),
+      `  ${ansis.cyan(`npx ${PACKAGE_NAME} init`)}`,
+      `  ${ansis.cyan(`npx ${PACKAGE_NAME} i`)}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.customModels")}`),
+      `  ${ansis.cyan(`npx ${PACKAGE_NAME} init -s`)}`,
+      ""
+    ].join("\n")
+  });
+  return sections;
+}
+async function setupCommands(cli) {
+  try {
+    const config = await readLyConfig();
+    const defaultLang = config?.general?.language || "zh-CN";
+    await initI18n(defaultLang);
+  } catch {
+    await initI18n("zh-CN");
+  }
+  cli.command("", i18n.t("cli:help.commandDescriptions.showMenu")).option("--lang, -l <lang>", `${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`).action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await checkExternalDeps();
+    await showMainMenu();
+  });
+  cli.command("init", i18n.t("cli:help.commandDescriptions.initConfig")).alias("i").option("--lang, -l <lang>", `${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`).option("--force, -f", i18n.t("cli:help.optionDescriptions.forceOverwrite")).option("--skip-prompt, -s", i18n.t("cli:help.optionDescriptions.skipAllPrompts")).option("--workflows, -w <workflows>", i18n.t("cli:help.optionDescriptions.workflows")).option("--install-dir, -d <path>", i18n.t("cli:help.optionDescriptions.installDir")).action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await checkExternalDeps({ skipPrompt: options.skipPrompt });
+    await init(options);
+  });
+  cli.command("doctor", "Check ly-workflow-codex installation health").action(async () => {
+    await doctor();
+  });
+  cli.command("status", "Show ly-workflow-codex installation status").action(async () => {
+    await status();
+  });
+  cli.command("uninstall", "Uninstall ly-workflow-codex workflows (~/.agents/skills/lyx-*, ~/.ly/prompts/codex/)").option("--yes, -y", "Skip confirmation").action(async (options) => {
+    const installDir = join(homedir(), ".codex");
+    if (!options.yes) {
+      const { confirm } = await inquirer.prompt([{
+        type: "confirm",
+        name: "confirm",
+        message: `\u786E\u5B9A\u8981\u5378\u8F7D ${PACKAGE_NAME} \u5417\uFF1F\u5C06\u79FB\u9664 ~/.agents/skills/lyx-*\uFF08\u542B\u65E7 ~/.agents/skills/ly-* \u4E0E ~/.codex/prompts/ly-*.md \u6B8B\u7559\uFF09\u4E0E ~/.ly/prompts/codex/\uFF1B\u5171\u4EAB\u914D\u7F6E ~/.ly/config.toml \u4E0E ~/.ly/ \u5176\u4F59\u5185\u5BB9\uFF08\u542B worktrees\uFF09\u4FDD\u7559\u3002`,
+        default: false
+      }]);
+      if (!confirm) {
+        console.log(ansis.gray("\u5378\u8F7D\u5DF2\u53D6\u6D88"));
+        return;
+      }
+    }
+    const result = await uninstallWorkflows(installDir);
+    if (result.success) {
+      console.log(ansis.green(`\u2713 ${PACKAGE_NAME} uninstalled`));
+      if (result.removedSkills.length > 0)
+        console.log(ansis.gray(`  lyx-* skills: ${result.removedSkills.length} removed`));
+      if (result.removedLegacyPrompts.length > 0)
+        console.log(ansis.gray(`  Legacy ~/.codex/prompts residue: ${result.removedLegacyPrompts.length} removed`));
+      if (result.removedSharedPrompts)
+        console.log(ansis.gray("  Shared prompts (~/.ly/prompts/codex/): removed"));
+      if (result.configTomlKept)
+        console.log(ansis.gray("  Shared config (~/.ly/config.toml): kept (~/.ly is the ly-workflow shared namespace)"));
+    } else {
+      console.error(ansis.red("\u2717 Uninstall failed"));
+      for (const err of result.errors) console.error(ansis.gray(`  ${err}`));
+      process.exitCode = 1;
+    }
+  });
+  cli.help((sections) => customizeHelp(sections));
+  cli.version(version);
+}
+
+async function main() {
+  const cli = cac(BIN_NAME);
+  await setupCommands(cli);
+  cli.parse();
+}
+main().catch(console.error);