momo-ai 1.0.99 → 1.0.100

package/.r2mo/.obsidian/plugins/obsidian-git/obsidian_askpass.bat

@@ -0,0 +1,21 @@
+@echo off
+set "PROMPT=%~1"
+set "TEMP_FILE=%OBSIDIAN_GIT_CREDENTIALS_INPUT%"
+
+if not "%PROMPT%"=="" echo %PROMPT%> "%TEMP_FILE%"
+
+:wait_response
+if not exist "%TEMP_FILE%" (
+    echo Trigger file got removed: Abort 1>&2
+    exit /b 1
+)
+if exist "%TEMP_FILE%.response" goto :got_response
+ping -n 1 127.0.0.1 >nul
+goto :wait_response
+
+:got_response
+set /p RESPONSE=<"%TEMP_FILE%.response"
+echo %RESPONSE%
+
+if exist "%TEMP_FILE%" del "%TEMP_FILE%"
+if exist "%TEMP_FILE%.response" del "%TEMP_FILE%.response"

package/.r2mo/task/goon-001.md

@@ -1,6 +1,6 @@
 ---
-runAt: 2026-05-25.17-45-00
-title: 整改-开发 Claude、Codex、OpenCode 命令
+runAt: 2026-05-25.17-57-24
+title: 整改-BUG-强化隔离区域
 status: Done
 author:
 ---

package/.r2mo/task/goon-002.md

@@ -1,3 +1,5 @@
-# task-002 待整改项
+---
+title: 整改-追加新的命令
+---
 
-当前无待整改项。
+（无待整改项）

package/.r2mo/task/goon-003.md

@@ -0,0 +1,7 @@
+---
+title: 整改-强化跨平台兼容性（Windows / Linux / macOS）
+---
+
+## 待整改项
+
+无待整改项。

package/.r2mo/task/goon-004.md

@@ -0,0 +1,7 @@
+---
+title: 整改-更新 README.md
+---
+
+## 待整改项
+
+无待整改项。

package/.r2mo/task/task-001.md

@@ -1,6 +1,18 @@
 ---
 runAt: 2026-05-25.17-57-24
-title: 任务
-status: Pending
+title: BUG-强化隔离区域
+status: Done
 author:
 ---
+在使用 /momo: 系列命令时出现了 /momo:plan 002 结果最终回写 task-001.md 的场景，对隔离处理进行一轮强化和修正。
+
+## Changes
+
+- 2026-05-26 10:30: 强化 /momo:plan、/momo:run、/momo:end、/momo:goon 四个 skill 的任务隔离机制，防止跨任务回写污染。
+  - Files changed: `agent/commands/claude/momo/commands/plan.md`, `run.md`, `end.md`, `goon.md` (源文件)
+  - Files changed: `~/.claude/plugins/cache/momo-skills/momo/1.0.0/commands/plan.md`, `run.md`, `end.md`, `goon.md` (Claude 插件缓存)
+  - Files changed: `~/.codex/plugins/momo/commands/plan.md`, `run.md`, `end.md`, `goon.md` (Codex 命令)
+  - Files changed: `~/.codex/plugins/momo/skills/momo-plan/SKILL.md`, `momo-run/SKILL.md`, `momo-end/SKILL.md`, `momo-goon/SKILL.md` (Codex skill)
+  - Files changed: `~/.codex/rules/r2mo-task-workflow.md` (共享规则)
+  - 新增三层隔离守卫：(1) 隔离锁定声明（📌 任务隔离锁定），(2) 写回前路径校验，(3) 全程隔离约束禁止操作其他 task/goon 文件
+  - Verification: grep 确认全部 12 个文件 + 1 个共享规则均包含隔离锁定、写回校验、隔离约束三个关键词

package/.r2mo/task/task-002.md

@@ -1,6 +1,81 @@
 ---
 runAt: 2026-05-25.17-57-24
-title: 任务
-status: Pending
+title: 追加新的命令
+status: Done
 author:
 ---
+基于当前 /momo 系列命令，追加新的 /momo:debug 专用命令，这种任务应该是直接处理成 BUG 排查，检查当前环境中是否存在 superpowers，如果有，调用系统排查的命令进行BUG诊断。
+
+## Plan
+
+### 目标拆解
+
+1. **新增 `/momo:debug` AI 命令**：作为 `/momo:plan|run|end|goon` 之外的第五个专用命令，面向 BUG 排查场景
+2. **Superpowers 检测与调度**：命令执行时先检测当前环境是否安装了 superpowers 插件；有则调用 `superpowers:systematic-debugging` 进行系统化 BUG 诊断；无则降级为手动排查工作流
+3. **全平台覆盖**：Claude Code / Codex / OpenCode 三平台均需安装该命令
+4. **安装/卸载闭环**：`momo ai-cmd` 安装和卸载时正确处理 `debug` 命令
+
+### 涉及文件/模块
+
+| 文件 | 变更类型 | 说明 |
+|------|----------|------|
+| `agent/commands/claude/momo/commands/debug.md` | 新增 | Claude Code slash command 定义 |
+| `agent/commands/codex/momo/commands/debug.md` | 新增 | Codex prompt command 定义 |
+| `agent/commands/opencode/momo/commands/debug.md` | 新增 | OpenCode command 定义 |
+| `src/utils/momo-ai-cmd.js` | 修改 | `MOMO_COMMANDS` 数组追加 `'momo:debug'`，卸载清理逻辑自动生效 |
+| `agent/commands/claude/momo/plugin.json` | 修改 | `description` 字段追加 `/momo:debug` |
+
+### 执行步骤
+
+**Step 1 — 创建 `agent/commands/claude/momo/commands/debug.md`**
+
+- YAML frontmatter：`description: "BUG 排查：检测 superpowers 并调用系统化诊断命令"`，`argument-hint: "[bug-description]"`
+- 正文 Workflow：
+  1. 声明本次执行目标（BUG 排查）
+  2. 检测 superpowers 是否可用（检查 skill 列表中是否存在 `superpowers:systematic-debugging`）
+  3. **有 superpowers**：调用 `superpowers:systematic-debugging` skill，传入 `$ARGUMENTS` 作为 BUG 描述，按其工作流执行
+  4. **无 superpowers**：降级为手动排查流程——收集错误信息、定位相关文件、分析根因、给出修复建议
+  5. 排查完成后输出诊断结论和修复方向
+- 风格与 plan.md / run.md 保持一致（Workflow 编号、Verification 段落）
+
+**Step 2 — 创建 `agent/commands/codex/momo/commands/debug.md`**
+
+- 与 Step 1 内容一致，Codex 平台无需额外适配
+
+**Step 3 — 创建 `agent/commands/opencode/momo/commands/debug.md`**
+
+- 与 Step 1 内容一致，OpenCode 平台无需额外适配
+
+**Step 4 — 修改 `src/utils/momo-ai-cmd.js`**
+
+- 将 `MOMO_COMMANDS` 数组从 `['momo:plan', 'momo:run', 'momo:end', 'momo:goon']` 更新为 `['momo:plan', 'momo:run', 'momo:end', 'momo:goon', 'momo:debug']`
+- `removeOpenCodeCommandEntries` 函数依赖此数组进行卸载清理，追加后自动生效，无需额外修改
+
+**Step 5 — 修改 `agent/commands/claude/momo/plugin.json`**
+
+- 更新 `description` 字段为 `"R2MO task workflow slash commands: /momo:plan, /momo:run, /momo:end, /momo:goon, /momo:debug."`
+
+### 验证方式
+
+1. **语法检查**：`node --check src/utils/momo-ai-cmd.js` 确认无语法错误
+2. **安装测试**：`node src/momo.js ai-cmd` 选择 Claude 平台安装，确认 `debug.md` 被复制到目标目录
+3. **命令发现**：在 Claude Code 中输入 `/momo:debug` 确认命令可被发现
+4. **卸载测试**：`node src/momo.js ai-cmd -u` 确认 `momo:debug` 条目被正确清理
+5. **功能验证**：在 Claude Code 中执行 `/momo:debug 问题描述` 确认 superpowers 检测逻辑和降级路径均正常工作
+
+### 风险与交接说明
+
+- **风险**：superpowers 检测依赖于 skill 列表在运行时可见，若 Claude Code 版本差异导致 skill 发现机制不同，降级路径需作为兜底保障
+- **边界**：本 Plan 仅覆盖 `/momo:debug` 命令的创建与安装，不涉及 superpowers 插件本身的修改
+- **交接**：实施者需确认三平台 debug.md 内容一致；安装后需在真实环境执行一次端到端验证
+
+## Changes
+
+- 2026-05-26 11:00: 新增 `/momo:debug` AI 命令，覆盖 Claude Code / Codex / OpenCode 三平台
+  - Files changed: `agent/commands/claude/momo/commands/debug.md` (新增), `agent/commands/codex/momo/commands/debug.md` (新增), `agent/commands/opencode/momo/commands/debug.md` (新增), `src/utils/momo-ai-cmd.js` (MOMO_COMMANDS 追加 `momo:debug`), `agent/commands/claude/momo/plugin.json` (description 追加 `/momo:debug`)
+  - Verification: `node --check src/utils/momo-ai-cmd.js` 通过；三平台 debug.md 文件存在且 frontmatter 正确；`require('./src/utils/momo-ai-cmd')` 加载正常
+
+- 2026-05-26 11:15: 整改闭环 — 修复两处遗漏
+  - 整改项 1：`src/utils/momo-ai-cmd.js` marketplace JSON description 追加 `/momo:debug`（L307）
+  - 整改项 2：`src/utils/momo-ai-cmd.js` `uninstallCodexPlugin` 追加 `momo-debug.md` 卸载清理（L510）
+  - Verification: `node --check src/utils/momo-ai-cmd.js` 通过；`require('./src/utils/momo-ai-cmd')` 加载正常

package/.r2mo/task/task-003.md

@@ -1,6 +1,133 @@
 ---
-runAt: 2026-05-25.11-25-47
-title: 任务
-status: Pending
-author:
+runAt: 2026-05-26.14-41-00
+title: 强化跨平台兼容性（Windows / Linux / macOS）
+status: Done
+author: Claude
 ---
+
+## 目标
+
+全量扫描 r2mo-lain 所有命令源码，修复 Windows / Linux / macOS 三平台兼容性问题，确保安装、卸载、命令执行在三个平台上行为一致。
+
+## 扫描结果
+
+### 高严重度：Windows `spawn`/`execSync` 缺少 `shell: true`
+
+Windows 上 npm 全局安装的 CLI 是 `.cmd` 文件，`spawn`/`execSync` 不加 `shell: true` 会抛 `ENOENT`。
+
+| 文件 | 调用 |
+|------|------|
+| `src/utils/momo-audio.js` | `spawnSync(checker)`, `spawn(player.command)` |
+| `src/utils/momo-ai-cmd.js` | `spawnSync(lookup)`, `spawnSync(command)` |
+| `src/executor/executeOpen.js` | `spawn(whereCmd)`, `spawn(command)` |
+| `src/executor/executeApp.js` | `spawn(whereCmd)`, `spawn('ai')` |
+| `src/executor/executeMmr0.js` | `execSync(whereCmd)`, `execSync(git fetch/rev-parse/pull)` |
+| `src/executor/executeMmr2.js` | `execSync(whereCmd)`, `execSync(git fetch/rev-parse/pull)` |
+| `src/executor/executeDomain.js` | `spawn(whereCmd)`, `execSync(git fetch/rev-parse/pull)` |
+| `src/executor/executeDocs.js` | `execSync(whereCmd obsidian)` |
+| `src/executor/executeMod.js` | `execSync(git fetch/rev-parse/pull)` |
+| `src/executor/executeMcp.js` | `execSync(npm install)` |
+| `src/executor/executeApply.js` | `execSync(git pull/clone)` |
+| `src/executor/executeDict.js` | `execSync(npm install -g)` |
+| `src/executor/executeEnv.js` | `execAsync(whereCmd/java/node/npm/git/codex)` 共 8 处 |
+| `src/utils/momo-file-utils.js` | `execSync(git clone)` |
+
+### 高严重度：OpenCode 配置路径
+
+- `momo-ai-cmd.js` OpenCode 平台 `targetDir` 硬编码 `~/.config/opencode/`，Windows 不使用此路径，应使用 `%APPDATA%\opencode\`
+
+### 中严重度：Windows 文件锁定
+
+- `momo-ai-cmd.js` 中 `fs.rm`/`fs.copyFile` 在文件被占用时抛 `EPERM`/`EBUSY`，无重试机制
+
+### 中严重度：符号链接
+
+- `momo-ai-cmd.js` 和 `momo-file-utils.js` 中 `copyDir` 只处理 `isFile()`，跳过 `isSymbolicLink()`
+
+### 低严重度：README 缺少跨平台安装说明
+
+- 2.1 安装章节只有一行 `npm install -g momo-ai`，无平台差异说明
+- 缺 Windows 排错提示（PowerShell 执行策略、文件锁定）
+
+## Changes
+
+### 代码修复
+
+1. **`src/utils/momo-ai-cmd.js`**
+   - `commandExists` / `runOptionalCommand`：加 `shell: process.platform === 'win32'`
+   - 新增 `openCodeConfigDir()`：Windows 使用 `%APPDATA%\opencode\`，其他平台使用 `~/.config/opencode/`
+   - `PLATFORMS[2].targetDir` 改为调用 `openCodeConfigDir()`
+   - `openCodeConfigFiles` 使用 `openCodeConfigDir()` 查找 legacy jsonc
+   - 新增 `retryOnWindows()`：对 `removeIfExists`、`removeExistingPath`、`copyFile` 自动重试 `EPERM`/`EBUSY`
+   - `copyDir` 增加 `entry.isSymbolicLink()` 分支
+
+2. **`src/utils/momo-audio.js`**
+   - `_isCommandAvailable`：`spawnSync` 加 `shell: process.platform === 'win32'`
+   - `_playWith`：`spawn` 加 `shell: process.platform === 'win32'`
+
+3. **`src/utils/momo-file-utils.js`**
+   - `gitClone`：`execSync` 加 `shell: process.platform === 'win32'`
+
+4. **`src/executor/executeOpen.js`**
+   - `_isCommandAvailable`：`spawn` 加 `shell`
+   - `_openWithSpawn`：`spawn` 加 `shell`
+
+5. **`src/executor/executeApp.js`**
+   - `_isCommandAvailable`：`spawn` 加 `shell`
+   - `_executeAiCommand`：`spawn('ai')` 改 `shell: false` 为 `shell: process.platform === 'win32'`
+
+6. **`src/executor/executeMmr0.js`**
+   - `_isCommandAvailable`、`_isRepositoryUpToDate`、`_cloneOrUpdateRepository` 中所有 `execSync` 加 `shell`
+
+7. **`src/executor/executeMmr2.js`**
+   - 同上，4 处 `execSync` 加 `shell`
+
+8. **`src/executor/executeDomain.js`**
+   - `_isCommandAvailable`：`spawn` 加 `shell`
+   - git 操作 3 处 `execSync` 加 `shell`
+
+9. **`src/executor/executeDocs.js`**
+   - `execSync(whereCmd obsidian)` 加 `shell`
+
+10. **`src/executor/executeMod.js`**
+    - git 操作 3 处 `execSync` 加 `shell`
+
+11. **`src/executor/executeMcp.js`**
+    - `execSync('npm install')` 加 `shell`
+
+12. **`src/executor/executeApply.js`**
+    - `execSync(git pull/clone)` 2 处加 `shell`
+
+13. **`src/executor/executeDict.js`**
+    - `execSync(npm install -g)` 加 `shell`
+
+14. **`src/executor/executeEnv.js`**
+    - 新增 `_shellOpt()` 辅助函数
+    - 8 处 `execAsync` 调用全部加 `_shellOpt()`
+
+### README.md 修复
+
+- 2.1 安装章节：补充 macOS / Linux / Windows 三平台安装命令、权限处理、卸载命令
+- 添加 Windows 文件锁定排错提示
+- 2.3 AI 平台命令安装：闭环流程 Mermaid 图改纵向（`flowchart TD`）
+- 文字按子章节拆分（闭环流程、前置校验、各平台调用方式、卸载、平台安装细节）
+- SDD 表格按平台拆分为两个独立表格
+- 平台安装细节表格改为 bullet list
+- 各列表行加 `<br/>` 换行避免拥挤
+
+### 验证
+
+- 14 个修改文件全部通过 `node --check` 语法检查
+
+### Goon 整改闭环（goon-003）
+
+整改项：`momo-file-utils.js` 的 `copyDir` 使用 `fsAsync.stat()`（跟随符号链接），需改为 `fsAsync.lstat()`（不跟随），并补齐 `isSymbolicLink()` 分支。
+
+修复内容：
+- `fsAsync.stat(sPath)` → `fsAsync.lstat(sPath)`
+- 新增 `stat.isSymbolicLink()` 分支：使用 `fsAsync.readlink()` 读取链接目标，再用 `fsAsync.symlink()` 重建链接
+- 目录和普通文件分支保持不变
+
+涉及文件：`src/utils/momo-file-utils.js:20-33`
+
+验证：`node --check src/utils/momo-file-utils.js` 通过，goon-003.md 整改项已清空。

package/.r2mo/task/task-004.md

@@ -1,6 +1,29 @@
 ---
 runAt: 2026-05-25.11-25-47
-title: 任务
-status: Pending
+title: 更新 README.md
+status: Done
 author:
 ---
+- 扫描 README.md 中看是否有遗漏的命令
+- 强化 Mermaid 图（要瘦长从上往下，方便主页查看）
+- 所有表格不要出现换行，有文字的尽量多列显示
+
+## Changes
+
+- **变更摘要**: 更新 README.md，补充遗漏命令、Mermaid 图瘦长化、表格多列无换行
+- **涉及文件**: `README.md`
+- **具体变更**:
+  1. 环境初始化表格补充 `momo focus` 命令（commander 有 focus.json 但 README 遗漏）
+  2. 环境初始化表和开发实施表增加「选项」列，说明列缩短避免换行
+  3. 需求分析表和 SDD 开发表说明列精简，去除跨行描述
+  4. Mermaid 图节点文本精简，移除粗体标记和冗长描述，保持瘦长纵向布局
+- **验证命令**: `grep -c 'momo focus' README.md` → 1
+- **验证结果**: `momo focus` 已出现在环境初始化表格中，所有表格无换行文本，Mermaid 图纵向精简
+
+### 整改闭环（goon-004）
+
+- **整改项**: 各平台调用方式表格说明列过长，未完全对齐"多列显示"要求
+- **整改执行**: Claude/OpenCode 表扩展为「命令」「前置」「写回」「说明」4列；Codex 表扩展为「命令」「等价」「说明」3列
+- **涉及文件**: `README.md`
+- **验证命令**: `grep -c '前置' README.md` → 1
+- **验证结果**: 两个平台表均已多列化，无长句挤单单元格，goon-004.md 已清空

package/README.md

@@ -23,129 +23,218 @@
 
 ### 2.1. 安装
 
+**前置条件**：Node.js 18+（推荐 LTS 版本）
+
+**macOS / Linux**
+
+```bash
+npm install -g momo-ai
+# 验证
+momo help
+```
+
+若遇到权限问题：
+
+```bash
+sudo npm install -g momo-ai
+# 或使用 nvm 管理 Node 版本，避免 sudo
+```
+
+**Windows**
+
 ```bash
 npm install -g momo-ai
-# 查看帮助
+# 验证
 momo help
 ```
 
+若遇到执行策略限制（PowerShell）：
+
+```powershell
+Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
+npm install -g momo-ai
+```
+
+**卸载**
+
+```bash
+npm uninstall -g momo-ai
+```
+
+> **Windows 提示**：安装或卸载 `momo ai-cmd` 时，请先关闭 Claude Code / Codex / OpenCode，否则文件可能被锁定导致操作失败。若仍遇到 `EPERM` 或 `EBUSY` 错误，关闭应用后重试即可。
+
 ### 2.2. 常用命令
 
 #### 🛠️ 环境初始化（工程初始化）
 
-| 命令 | 说明 | 示例 |
-|:---|:---|:---|
-| `momo app` | 创建 R2MO/Spring 或 ZERO/Vertx 应用 | `momo app -n my-app` |
-| `momo apply` | 从远程仓库安装技能到当前项目；`-i` 可反馈本地技能到仓库 | `momo apply` |
-| `momo env` | 环境信息检查 | `momo env` |
-| `momo help` | 显示帮助的详细信息 | `momo help` |
-| `momo init` | 初始化 `.r2mo` 规范目录结构 | `momo init` |
-| `momo mcp` | 配置 MCP Skills Server，整合项目和全局技能 | `momo mcp` |
-| `momo open` | 使用指定的 AI 工具打开项目 | `momo open` |
-| `momo team` | 根据 DPA 架构位置写入 `.r2mo/momo.yaml` 角色配置 | `momo team` |
-| `momo ui` | 从 r2mo-ui 模板创建/更新 UI 子项目（Rust/WASM + Tauri） | `momo ui` |
+| 命令 | 说明 | 选项 | 示例 |
+|:---|:---|:---|:---|
+| `momo app` | 创建 R2MO/Spring 或 ZERO/Vertx 应用 | `-n` 指定名称 | `momo app -n my-app` |
+| `momo apply` | 从远程仓库安装技能到当前项目 | `-i` 反馈到仓库 | `momo apply` |
+| `momo env` | 环境信息检查 | | `momo env` |
+| `momo focus` | 维护 DPA focus 配置与任务绑定 | `-d` 完成备份；`-c` 同步配置 | `momo focus` |
+| `momo help` | 显示帮助的详细信息 | | `momo help` |
+| `momo init` | 初始化 `.r2mo` 规范目录结构 | | `momo init` |
+| `momo mcp` | 配置 MCP Skills Server | | `momo mcp` |
+| `momo open` | 使用指定 AI 工具打开项目 | | `momo open` |
+| `momo team` | 写入 `.r2mo/momo.yaml` 角色配置 | | `momo team` |
+| `momo ui` | 创建/更新 UI 子项目 | | `momo ui` |
 
 #### 📋 需求分析
 
 | 命令 | 说明 | 示例 |
 |:---|:---|:---|
 | `momo docs` | 使用 Obsidian 打开文档目录 | `momo docs` |
-| `momo menu` | 扫描 `src/pages` 下 `menu.yaml`，打印完整树型菜单 | `momo menu` |
-| `momo mod` | 拉取 r2mo-spec 到 `.r2mo/repo`，拷贝 OpenAPI 到 `.r2mo/api/` | `momo mod` |
-| `momo openapi` | 从子项目 OpenAPI 提取 Operation/Schema 文档到 `-ui/.r2mo/api/` | `momo openapi` |
+| `momo menu` | 扫描 `src/pages` 下 `menu.yaml` 打印树型菜单 | `momo menu` |
+| `momo mod` | 拉取 r2mo-spec，拷贝 OpenAPI 到 `.r2mo/api/` | `momo mod` |
+| `momo openapi` | 提取子项目 OpenAPI 文档到 `-ui/.r2mo/api/` | `momo openapi` |
 
 #### 🚀 开发实施
 
-| 命令 | 说明 | 示例 |
-|:---|:---|:---|
-| `momo admin` | 根据项目需求文档生成前端页面结构 | `momo admin` |
-| `momo dict` | 从 `.r2mo/api/components/schemas` 读取结构并导出字典；`-r` 逆向生成 SQL | `momo dict` |
-| `momo domain` | 在指定目录执行 r2mo_proto 脚本生成 Protobuf | `momo domain` |
-| `momo mmr0` | 从 r2mo-spec 仓库下载并生成 Flyway SQL 文件 | `momo mmr0` |
-| `momo mmr2` | 从 r2mo-spec 仓库下载并生成 Entity 类 | `momo mmr2` |
+| 命令 | 说明 | 选项 | 示例 |
+|:---|:---|:---|:---|
+| `momo admin` | 根据需求文档生成前端页面结构 | | `momo admin` |
+| `momo dict` | 读取 schemas 导出字典 | `-r` 逆向生成 SQL | `momo dict` |
+| `momo domain` | 执行 r2mo_proto 生成 Protobuf | | `momo domain` |
+| `momo mmr0` | 下载并生成 Flyway SQL 文件 | | `momo mmr0` |
+| `momo mmr2` | 下载并生成 Entity 类 | | `momo mmr2` |
 
 #### 🤖 SDD 开发
 
 | 命令 | 说明 | 示例 |
 |:---|:---|:---|
-| `momo ask` | 从模板目录中选择提示词并复制到剪切板 | `momo ask` |
-| `momo plan` | 从项目根或 `.r2mo` 目录下的 `task/` 中选择任务，生成 Plan 阶段提示词到剪贴板 | `momo plan` |
-| `momo run` | 从项目根或 `.r2mo` 目录下的 `task/` 中选择任务，生成提示词到剪贴板 | `momo run` |
-| `momo task` | 按项目根或 `.r2mo` 目录下的 `task/thread` 配置对齐任务槽位；thread 缺失时默认 20，满队列时交互选择要转历史的任务 | `momo task` |
+| `momo ask` | 从模板选择提示词复制到剪贴板 | `momo ask` |
+| `momo plan` | 选择任务生成 Plan 提示词到剪贴板 | `momo plan` |
+| `momo run` | 选择任务生成提示词到剪贴板 | `momo run` |
+| `momo task` | 按 `task/thread` 配置对齐任务槽位 | `momo task` |
 
 ### 2.3. AI 平台命令安装
 
-`momo ai-cmd` 会把命令安装到 Claude Code、Codex、OpenCode 的可用位置。命令源随 npm 包一起发布，位于 `agent/commands/`。
+`momo ai-cmd` 将命令安装到 Claude Code、Codex、OpenCode 的可用位置。命令源随 npm 包发布，位于 `agent/commands/`。
 
 ```bash
 # 交互式选择安装平台
 momo ai-cmd
 ```
 
-每次安装都会先清理 `momo` 自己在所选平台上的旧安装记录，再写入最新命令并重新注册；重复执行可用于刷新 Claude Code / Codex / OpenCode 的命令或技能索引。
+每次安装会先清理 `momo` 在所选平台上的旧记录，再写入最新命令并重新注册。重复执行可用于刷新索引。
+
+---
 
-安装后在不同平台的调用方式如下。Claude Code / OpenCode 使用 slash command；Codex 当前使用 plugin skill，不支持把第三方命令注册成 `/momo-run` 这种自定义 slash command。
+#### 闭环流程
 
-完整闭环为：`requirement(task.md) -> [plan(task.md)] -> run Changes(task.md) -> end(goon.md) -> goon Changes(task.md) -> end(goon.md)`。这里的 `task.md` / `goon.md` 是流程占位写法，实际分别表示当前参数编号对应的 `task-xxx.md` / `goon-xxx.md`。`plan`、`run`、`end` 都只以编号定位 `task-xxx.md`；`goon` 同时定位同编号的 `task-xxx.md` 和 `goon-xxx.md`。`plan` 是可选步骤，只写回 `task-xxx.md` 的 `## Plan`，不执行实现；`run` 优先按已存在的 `## Plan` 执行，没有 `## Plan` 时直接按任务正文执行，并追加 `Changes`；`end` 每次都先清空 `goon-xxx.md` 原始内容，再写入当前待整改项；`goon` 完成整改后把闭环记录追加回 `task-xxx.md` 的 `Changes`，然后应再次执行 `end` 验证并重写当前剩余待整改项或空状态。当 `end` 验证后 `goon-xxx.md` 为空或无待整改项时，该编号任务闭环完成。`plan`、`run`、`end` 三个命令要求对应 `task-xxx.md` 在 frontmatter 之后必须存在非空正文；如果正文为空或只有空白字符，命令应立即停止并直接返回，不执行后续提示词。所有 `goon-xxx.md` 的 frontmatter `title` 都必须与对应 `task-xxx.md` 标题一致，并追加 `整改-` 前缀，例如 `task-001.md` 的标题为 `开发 Claude、Codex、OpenCode 命令` 时，`goon-001.md` 标题必须为 `整改-开发 Claude、Codex、OpenCode 命令`。
+四个命令形成一个 `plan → run → end → goon` 闭环：
 
 ```mermaid
-flowchart LR
-    A["Requirement<br/>task-xxx.md"] --> B["momo:plan<br/>可选：写入/更新 ## Plan"]
-    A --> C["momo:run<br/>按任务正文或 ## Plan 执行"]
+flowchart TD
+    A[“`task-xxx.md`”] --> B[“momo:plan<br/>可选”]
+    A --> C[“momo:run”]
     B --> C
-    C --> D["momo:end<br/>验证并重写 goon-xxx.md"]
-    D --> E{"goon-xxx.md<br/>是否有待整改项"}
-    E -- "有" --> F["momo:goon<br/>按 task + goon 整改"]
-    F --> G["task-xxx.md<br/>追加 Changes"]
+    C --> D[“momo:end”]
+    D --> E{“有待整改？”}
+    E -- 有 --> F[“momo:goon”]
+    F --> G[“追加 Changes”]
     G --> D
-    E -- "无" --> H["Done<br/>goon-xxx.md 无待整改项"]
-
-    classDef requirement fill:#e8f1ff,stroke:#4a7bd1,color:#12325b,stroke-width:1px;
-    classDef optional fill:#fff4d6,stroke:#d4a72c,color:#5b4300,stroke-width:1px;
-    classDef execute fill:#e8f7e8,stroke:#43a047,color:#123d1b,stroke-width:1px;
-    classDef verify fill:#f3e8ff,stroke:#8e5ad7,color:#41215f,stroke-width:1px;
-    classDef remediate fill:#ffe8e8,stroke:#d45a5a,color:#5d1f1f,stroke-width:1px;
-    classDef done fill:#e6fffb,stroke:#1aa39a,color:#0f4f4a,stroke-width:1px;
-
-    class A requirement;
-    class B optional;
-    class C execute;
-    class D,E verify;
-    class F,G remediate;
-    class H done;
+    E -- 无 --> H[“Done ✅”]
+
+    classDef requirement fill:#e8f1ff,stroke:#4a7bd1,color:#12325b
+    classDef optional fill:#fff4d6,stroke:#d4a72c,color:#5b4300
+    classDef execute fill:#e8f7e8,stroke:#43a047,color:#123d1b
+    classDef verify fill:#f3e8ff,stroke:#8e5ad7,color:#41215f
+    classDef remediate fill:#ffe8e8,stroke:#d45a5a,color:#5d1f1f
+    classDef done fill:#e6fffb,stroke:#1aa39a,color:#0f4f4a
+
+    class A requirement
+    class B optional
+    class C execute
+    class D,E verify
+    class F,G remediate
+    class H done
 ```
 
-| 平台 | 调用方式 | 说明 |
+各步骤行为：
+
+- **plan**（可选）— 只写回 `task-xxx.md` 的 `## Plan`，不执行实现
+- **run** — 优先按已有 `## Plan` 执行，无 Plan 时按任务正文执行，追加 `Changes`
+- **end** — 清空 `goon-xxx.md` 原始内容，写入当前待整改项
+- **goon** — 按整改项执行，闭环记录追加回 `task-xxx.md` 的 `Changes`，再执行 `end` 验证
+
+当 `end` 验证后 `goon-xxx.md` 无待整改项时，该编号任务闭环完成。
+
+> `goon-xxx.md` 的 frontmatter `title` 必须与对应 `task-xxx.md` 标题一致，并追加 `整改-` 前缀。
+
+---
+
+#### 前置校验
+
+`plan`、`run`、`end` 要求对应 `task-xxx.md` 在 frontmatter 之后必须存在非空正文。正文为空时命令立即返回，不执行后续提示词。
+
+---
+
+#### 各平台调用方式
+
+**Claude Code / OpenCode** — slash command
+
+| 命令 | 前置 | 写回 | 说明 |
+|:---|:---|:---|:---|
+| `/momo:plan 001` | 正文非空 | `## Plan` | 不执行、不追加 Changes |
+| `/momo:run 001` | 正文非空 | `Changes` | 优先按 Plan 执行 |
+| `/momo:end 001` | 正文非空 | `goon-001.md` | 标题为 `整改-` + task 标题 |
+| `/momo:goon 001` | goon 存在 | `Changes` | 整改后再 end 验证 |
+
+**Codex** — plugin skill
+
+| 命令 | 等价 | 说明 |
 |:---|:---|:---|
-| Claude Code / OpenCode | `/momo:plan 001` | 读取 `.r2mo/task/task-001.md`，正文非空时追加或更新 `## Plan`，不执行实现、不追加 Changes |
-| Claude Code / OpenCode | `/momo:run 001` | 读取 `.r2mo/task/task-001.md`，正文非空时优先按 `## Plan` 执行，先在聊天窗口显示最终执行提示词，再执行开发任务并追加 Changes |
-| Claude Code / OpenCode | `/momo:end 001` | 读取 `.r2mo/task/task-001.md`，正文非空时验证任务完成情况，并生成或重写 `.r2mo/task/goon-001.md`，goon 文件只保留当前待整改项，标题固定为 `整改-` + task 标题 |
-| Claude Code / OpenCode | `/momo:goon 001` | 读取 `.r2mo/task/goon-001.md`，并对齐 `.r2mo/task/task-001.md` 执行整改任务，完成后回写 task Changes，再使用 `/momo:end 001` 验证 |
-| Codex | `$momo-plan 001` 或 `/use` 选择 `momo-plan` | 与 `/momo:plan 001` 等价 |
-| Codex | `$momo-run 001` 或 `/use` 选择 `momo-run` | 与 `/momo:run 001` 等价 |
-| Codex | `$momo-end 001` 或 `/use` 选择 `momo-end` | 与 `/momo:end 001` 等价 |
-| Codex | `$momo-goon 001` 或 `/use` 选择 `momo-goon` | 与 `/momo:goon 001` 等价，完成后再使用 `$momo-end 001` 验证 |
+| `$momo-plan 001` | `/momo:plan` | 写 Plan |
+| `$momo-run 001` | `/momo:run` | 执行开发 |
+| `$momo-end 001` | `/momo:end` | 验证整改 |
+| `$momo-goon 001` | `/momo:goon` | 整改后验证 |
+
+参数为三位数字编号（如 `001`）。格式不对时命令停止并提示正确用法。
 
-参数必须是 `001` 这类三位数字编号。格式不对时，命令或 skill 会停止并提示正确用法。
-编号参数与文件一一对应，例如 `/momo:run 010` 只表示当前工作目录下的 `.r2mo/task/task-010.md`。`plan`、`run`、`end` 都对应 `.r2mo/task/task-010.md`；`goon 010` 同时对应 `.r2mo/task/task-010.md` 和 `.r2mo/task/goon-010.md`。如果对应文件不存在，命令不会猜测其他编号，而是直接询问用户提供最新任务号。如果 `task-010.md` frontmatter 之后正文为空，`plan`、`run`、`end` 会直接返回，不继续执行。
+编号与文件一一对应：`/momo:run 010` → `.r2mo/task/task-010.md`；`goon 010` 同时对应 `task-010.md` 和 `goon-010.md`。文件不存在时命令直接询问最新任务号。
 
-四个核心命令最终发送给 AI Agent 的提示词使用短列表“任务派发单”格式，统一包含输入范围、前置校验、调度策略或写回规则，便于不同 Agent 在 `plan -> run -> end -> goon` 闭环中准确接力。
+四个命令发送给 AI Agent 的提示词统一使用”任务派发单”短列表格式，包含输入范围、前置校验、调度策略和写回规则。
+
+---
 
-卸载时使用全量清理，已安装的平台会被删除，未安装的平台会被跳过：
+#### 卸载
 
 ```bash
 momo ai-cmd --uninstall
 ```
 
-平台安装方式：
+全量清理：已安装的平台会被删除，未安装的跳过。
 
-| 平台 | 安装方式 | 验证 |
-|:---|:---|:---|
-| Claude Code | 写入 `~/.claude/plugins/marketplaces/momo-skills`，并调用 `claude plugin marketplace add/update`、`claude plugin install momo@momo-skills` | `claude plugin list` 或 `claude plugin details momo@momo-skills` |
-| Codex | 写入 `~/.codex/marketplaces/momo-skills`、兼容 prompts，以及 plugin skills `momo-plan`、`momo-run`、`momo-end`、`momo-goon`；当前 Codex 0.133 的 `/` 补全不支持自定义 `/momo-run` slash command，稳定入口是 skills | `codex plugin list`；`codex debug prompt-input` 中应出现 `momo:momo-plan`、`momo:momo-run`、`momo:momo-end`、`momo:momo-goon` |
-| OpenCode | 写入 `~/.config/opencode/opencode.json` 的 `command` 配置，并清理旧 `opencode.jsonc` 中的 momo 命令残留 | 检查 `command["momo:plan"]`、`command["momo:run"]`、`command["momo:end"]`、`command["momo:goon"]` 是否存在 |
+---
+
+#### 平台安装细节
+
+**Claude Code**
+
+- 写入 `~/.claude/plugins/marketplaces/momo-skills`
+- 写入 `~/.claude/plugins/cache/momo-skills/momo/1.0.0`
+- 更新 `~/.claude/settings.json`（启用插件、注册 marketplace）
+- 若 `claude` CLI 可用：自动执行 `plugin marketplace add/update` 和 `plugin install`
+- 验证：`claude plugin list` 或 `claude plugin details momo@momo-skills`
+
+**Codex**
+
+- 写入 `~/.codex/plugins/momo` 及 `~/.codex/marketplaces/momo-skills`
+- 写入 `~/.codex/prompts/momo-*.md` 兼容 prompts
+- 更新 `~/.codex/config.toml`（注册 marketplace 和 plugin）
+- 若 `codex` CLI 可用：自动执行 `plugin marketplace add` 和 `plugin add`
+- 验证：`codex plugin list`；`codex debug prompt-input` 中应出现 `momo:momo-plan` 等
+
+**OpenCode**
+
+- macOS / Linux：写入 `~/.config/opencode/opencode.json`
+- Windows：写入 `%APPDATA%\opencode\opencode.json`
+- 清理旧 `opencode.jsonc` 中 momo 残留
+- 验证：检查 `command[“momo:plan”]` 等是否存在
 
-如果 Claude Code、Codex 或 OpenCode 已经打开，安装后请重启应用或在项目根开启新会话，让命令或 skill 索引重新加载。
+安装后请重启应用或开启新会话，让命令或 skill 索引重新加载。
 
 ### 2.4. 发布