docs: add VitePress documentation site

- Add docs directory with VitePress configuration - Add GitHub Actions workflow for docs build and deploy - Support bilingual (English/Chinese) documentation - Include search, custom theme, and responsive design
2026-03-01 15:03:57 +08:00 · 2026-02-28 16:14:09 +08:00
parent ab65caec45
commit c3ddf7e322
136 changed files with 34486 additions and 0 deletions
--- a/docs/zh/commands/claude/cli.md
+++ b/docs/zh/commands/claude/cli.md
@@ -0,0 +1,152 @@
+# CLI 工具命令
+
+## 一句话定位
+
+**CLI 工具命令是外部模型调用的桥梁** — 整合 Gemini、Qwen、Codex 等多模型能力到工作流中。
+
+## 核心概念速览
+
+| 概念 | 说明 | 配置 |
+| --- | --- | --- |
+| **CLI 工具** | 外部 AI 模型调用接口 | `cli-tools.json` |
+| **端点** | 可用的模型服务 | gemini, qwen, codex, claude |
+| **模式** | analysis / write / review | 权限级别 |
+
+## 命令列表
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`cli-init`](#cli-init) | 生成配置目录和设置文件 | `/cli:cli-init [--tool gemini\|qwen\|all] [--output path] [--preview]` |
+| [`codex-review`](#codex-review) | 使用 Codex CLI 进行交互式代码审查 | `/cli:codex-review [--uncommitted\|--base <branch>\|--commit <sha>] [prompt]` |
+
+## 命令详解
+
+### cli-init
+
+**功能**: 根据工作空间技术检测生成 `.gemini/` 和 `.qwen/` 配置目录，包含 settings.json 和 ignore 文件。
+
+**语法**:
+```
+/cli:cli-init [--tool gemini|qwen|all] [--output path] [--preview]
+```
+
+**选项**:
+- `--tool=工具`: gemini, qwen 或 all
+- `--output=路径`: 输出目录
+- `--preview`: 预览模式（不实际创建）
+
+**生成的文件结构**:
+```
+.gemini/
+├── settings.json      # Gemini 配置
+└── ignore            # 忽略模式
+
+.qwen/
+├── settings.json      # Qwen 配置
+└── ignore            # 忽略模式
+```
+
+**技术检测**:
+
+| 检测项 | 生成配置 |
+| --- | --- |
+| TypeScript | tsconfig 相关配置 |
+| React | React 特定配置 |
+| Vue | Vue 特定配置 |
+| Python | Python 特定配置 |
+
+**示例**:
+```bash
+# 初始化所有工具
+/cli:cli-init --tool all
+
+# 初始化特定工具
+/cli:cli-init --tool gemini
+
+# 指定输出目录
+/cli:cli-init --output ./configs
+
+# 预览模式
+/cli:cli-init --preview
+```
+
+### codex-review
+
+**功能**: 使用 Codex CLI 通过 ccw 端点进行交互式代码审查，支持可配置的审查目标、模型和自定义指令。
+
+**语法**:
+```
+/cli:codex-review [--uncommitted|--base <branch>|--commit <sha>] [--model <model>] [--title <title>] [prompt]
+```
+
+**选项**:
+- `--uncommitted`: 审查未提交的更改
+- `--base <分支>`: 与分支比较
+- `--commit <sha>`: 审查特定提交
+- `--model <模型>`: 指定模型
+- `--title <标题>`: 审查标题
+
+**注意**: 目标标志和 prompt 是互斥的
+
+**示例**:
+```bash
+# 审查未提交的更改
+/cli:codex-review --uncommitted
+
+# 与主分支比较
+/cli:codex-review --base main
+
+# 审查特定提交
+/cli:codex-review --commit abc123
+
+# 带自定义指令
+/cli:codex-review --uncommitted "关注安全性问题"
+
+# 指定模型和标题
+/cli:codex-review --model gpt-5.2 --title "认证模块审查"
+```
+
+## CLI 工具配置
+
+### cli-tools.json 结构
+
+```json
+{
+  "version": "3.3.0",
+  "tools": {
+    "gemini": {
+      "enabled": true,
+      "primaryModel": "gemini-2.5-flash",
+      "secondaryModel": "gemini-2.5-flash",
+      "tags": ["分析", "Debug"],
+      "type": "builtin"
+    },
+    "qwen": {
+      "enabled": true,
+      "primaryModel": "coder-model",
+      "tags": [],
+      "type": "builtin"
+    },
+    "codex": {
+      "enabled": true,
+      "primaryModel": "gpt-5.2",
+      "tags": [],
+      "type": "builtin"
+    }
+  }
+}
+```
+
+### 模式说明
+
+| 模式 | 权限 | 用途 |
+| --- | --- | --- |
+| `analysis` | 只读 | 代码审查、架构分析、模式发现 |
+| `write` | 创建/修改/删除 | 功能实现、Bug 修复、文档创建 |
+| `review` | Git 感知代码审查 | 审查未提交更改、分支差异、特定提交 |
+
+## 相关文档
+
+- [CLI 调用系统](../../features/cli.md)
+- [核心编排](./core-orchestration.md)
+- [工作流命令](./workflow.md)
--- a/docs/zh/commands/claude/core-orchestration.md
+++ b/docs/zh/commands/claude/core-orchestration.md
@@ -0,0 +1,166 @@
+# 核心编排命令
+
+## 一句话定位
+
+**核心编排命令是 Claude_dms3 的工作流大脑** — 分析任务意图、选择合适的工作流、自动执行命令链。
+
+## 命令列表
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`/ccw`](#ccw) | 主工作流编排器 - 意图分析→工作流选择→命令链执行 | `/ccw "任务描述"` |
+| [`/ccw-coordinator`](#ccw-coordinator) | 命令编排工具 - 链式命令执行和状态持久化 | `/ccw-coordinator "任务描述"` |
+
+## 命令详解
+
+### /ccw
+
+**功能**: 主工作流编排器 - 意图分析→工作流选择→命令链执行
+
+**语法**:
+```
+/ccw "任务描述"
+```
+
+**选项**:
+- `--yes` / `-y`: 自动模式，跳过确认步骤
+
+**工作流程**:
+
+```mermaid
+graph TD
+    A[用户输入] --> B[分析意图]
+    B --> C{清晰度评分}
+    C -->|≥2| D[直接选择工作流]
+    C -->|<2| E[需求澄清]
+    E --> D
+    D --> F[构建命令链]
+    F --> G{用户确认}
+    G -->|确认| H[执行命令链]
+    G -->|取消| I[结束]
+    H --> J{更多步骤?}
+    J -->|是| F
+    J -->|否| K[完成]
+```
+
+**任务类型检测**:
+
+| 类型 | 触发关键词 | 工作流 |
+| --- | --- | --- |
+| **Bug 修复** | urgent, production, critical + fix, bug | lite-fix |
+| **头脑风暴** | brainstorm, ideation, 头脑风暴, 创意 | brainstorm-with-file |
+| **调试文档** | debug document, hypothesis, 假设验证 | debug-with-file |
+| **协作分析** | analyze document, collaborative analysis | analyze-with-file |
+| **协作规划** | collaborative plan, 协作规划 | collaborative-plan-with-file |
+| **需求路线图** | roadmap, 需求规划 | req-plan-with-file |
+| **集成测试** | integration test, 集成测试 | integration-test-cycle |
+| **重构** | refactor, 重构 | refactor-cycle |
+| **团队工作流** | team + 关键词 | 对应团队工作流 |
+| **TDD** | tdd, test-first | tdd-plan → execute |
+| **测试修复** | test fix, failing test | test-fix-gen → test-cycle-execute |
+
+**示例**:
+
+```bash
+# 基础用法 - 自动选择工作流
+/ccw "实现用户认证功能"
+
+# Bug 修复
+/ccw "修复登录失败的 bug"
+
+# TDD 开发
+/ccw "使用 TDD 实现支付功能"
+
+# 团队协作
+/ccw "team-planex 实现用户通知系统"
+```
+
+### /ccw-coordinator
+
+**功能**: 命令编排工具 - 分析任务、推荐命令链、顺序执行、状态持久化
+
+**语法**:
+```
+/ccw-coordinator "任务描述"
+```
+
+**最小执行单元**:
+
+| 单元名称 | 命令链 | 输出 |
+| --- | --- | --- |
+| **快速实现** | lite-plan → lite-execute | 工作代码 |
+| **多 CLI 规划** | multi-cli-plan → lite-execute | 工作代码 |
+| **Bug 修复** | lite-plan (--bugfix) → lite-execute | 修复的代码 |
+| **完整规划+执行** | plan → execute | 工作代码 |
+| **验证规划+执行** | plan → plan-verify → execute | 工作代码 |
+| **TDD 规划+执行** | tdd-plan → execute | 工作代码 |
+| **测试生成+执行** | test-gen → execute | 生成的测试 |
+| **审查循环** | review-session-cycle → review-cycle-fix | 修复的代码 |
+| **Issue 工作流** | discover → plan → queue → execute | 完成的 Issue |
+
+**工作流程**:
+
+```mermaid
+graph TD
+    A[任务分析] --> B[发现命令]
+    B --> C[推荐命令链]
+    C --> D{用户确认}
+    D -->|确认| E[顺序执行]
+    D -->|修改| F[调整命令链]
+    F --> D
+    E --> G[状态持久化]
+    G --> H{更多步骤?}
+    H -->|是| B
+    H -->|否| I[完成]
+```
+
+**示例**:
+
+```bash
+# 自动编排 Bug 修复
+/ccw-coordinator "生产环境登录失败"
+
+# 自动编排功能实现
+/ccw-coordinator "添加用户头像上传功能"
+```
+
+## 自动模式
+
+两个命令都支持 `--yes` 标志启用自动模式：
+
+```bash
+# 自动模式 - 跳过所有确认
+/ccw "实现用户认证" --yes
+/ccw-coordinator "修复登录 bug" --yes
+```
+
+**自动模式行为**:
+- 跳过需求澄清
+- 跳过用户确认
+- 直接执行命令链
+
+## 相关 Skills
+
+| Skill | 功能 |
+| --- | --- |
+| `workflow-lite-plan` | 轻量级规划工作流 |
+| `workflow-plan` | 完整规划工作流 |
+| `workflow-execute` | 执行工作流 |
+| `workflow-tdd` | TDD 工作流 |
+| `review-cycle` | 代码审查循环 |
+
+## 对比
+
+| 特性 | /ccw | /ccw-coordinator |
+| --- | --- | --- |
+| **执行位置** | 主进程 | 外部 CLI + 后台任务 |
+| **状态持久化** | 无 | 有 |
+| **Hook 回调** | 不支持 | 支持 |
+| **复杂工作流** | 简单链式 | 支持并行、依赖 |
+| **适用场景** | 日常开发 | 复杂项目、团队协作 |
+
+## 相关文档
+
+- [工作流命令](./workflow.md)
+- [会话管理](./session.md)
+- [CLI 调用系统](../features/cli.md)
--- a/docs/zh/commands/claude/index.md
+++ b/docs/zh/commands/claude/index.md
@@ -0,0 +1,118 @@
+# Claude Commands
+
+## 一句话定位
+
+**Claude Commands 是 Claude_dms3 的核心命令系统** — 通过斜杠命令调用各种工作流、工具和协作功能。
+
+## 核心概念速览
+
+| 类别 | 命令数量 | 功能说明 |
+| --- | --- | --- |
+| **核心编排** | 2 | 主工作流编排器 (ccw, ccw-coordinator) |
+| **工作流** | 20+ | 规划、执行、审查、TDD、测试等工作流 |
+| **会话管理** | 6 | 会话创建、列表、恢复、完成等 |
+| **Issue 工作流** | 7 | Issue 发现、规划、队列、执行 |
+| **Memory** | 8 | 记忆捕获、更新、文档生成 |
+| **CLI 工具** | 2 | CLI 初始化、Codex 审查 |
+| **UI 设计** | 10 | UI 设计原型生成、样式提取 |
+
+## 命令分类
+
+### 1. 核心编排命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/ccw`](./core-orchestration.md#ccw) | 主工作流编排器 - 意图分析→工作流选择→命令链执行 | Intermediate |
+| [`/ccw-coordinator`](./core-orchestration.md#ccw-coordinator) | 命令编排工具 - 链式命令执行和状态持久化 | Intermediate |
+
+### 2. 工作流命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/workflow:lite-lite-lite`](./workflow.md#lite-lite-lite) | 超轻量级多工具分析和直接执行 | Intermediate |
+| [`/workflow:lite-plan`](./workflow.md#lite-plan) | 轻量级交互式规划工作流 | Intermediate |
+| [`/workflow:lite-execute`](./workflow.md#lite-execute) | 基于内存计划执行任务 | Intermediate |
+| [`/workflow:lite-fix`](./workflow.md#lite-fix) | 轻量级 Bug 诊断和修复 | Intermediate |
+| [`/workflow:plan`](./workflow.md#plan) | 5 阶段规划工作流 | Intermediate |
+| [`/workflow:execute`](./workflow.md#execute) | 协调代理执行工作流任务 | Intermediate |
+| [`/workflow:replan`](./workflow.md#replan) | 交互式工作流重新规划 | Intermediate |
+| [`/workflow:multi-cli-plan`](./workflow.md#multi-cli-plan) | 多 CLI 协作规划 | Intermediate |
+| [`/workflow:review`](./workflow.md#review) | 实现后审查 | Intermediate |
+| [`/workflow:clean`](./workflow.md#clean) | 智能代码清理 | Intermediate |
+| [`/workflow:init`](./workflow.md#init) | 初始化项目状态 | Intermediate |
+| [`/workflow:brainstorm-with-file`](./workflow.md#brainstorm-with-file) | 交互式头脑风暴 | Intermediate |
+| [`/workflow:analyze-with-file`](./workflow.md#analyze-with-file) | 交互式协作分析 | Beginner |
+| [`/workflow:debug-with-file`](./workflow.md#debug-with-file) | 交互式假设驱动调试 | Intermediate |
+| [`/workflow:unified-execute-with-file`](./workflow.md#unified-execute-with-file) | 通用执行引擎 | Intermediate |
+
+### 3. 会话管理命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/workflow:session:start`](./session.md#start) | 发现现有会话或启动新工作流会话 | Intermediate |
+| [`/workflow:session:list`](./session.md#list) | 列出所有工作流会话 | Beginner |
+| [`/workflow:session:resume`](./session.md#resume) | 恢复最近暂停的工作流会话 | Intermediate |
+| [`/workflow:session:complete`](./session.md#complete) | 标记活动工作流会话为完成 | Intermediate |
+| [`/workflow:session:solidify`](./session.md#solidify) | 将会话学习结晶为项目指南 | Intermediate |
+
+### 4. Issue 工作流命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/issue:new`](./issue.md#new) | 从 GitHub URL 或文本描述创建结构化 Issue | Intermediate |
+| [`/issue:discover`](./issue.md#discover) | 从多个角度发现潜在 Issue | Intermediate |
+| [`/issue:discover-by-prompt`](./issue.md#discover-by-prompt) | 通过用户提示发现 Issue | Intermediate |
+| [`/issue:plan`](./issue.md#plan) | 批量规划 Issue 解决方案 | Intermediate |
+| [`/issue:queue`](./issue.md#queue) | 形成执行队列 | Intermediate |
+| [`/issue:execute`](./issue.md#execute) | 执行队列 | Intermediate |
+| [`/issue:convert-to-plan`](./issue.md#convert-to-plan) | 转换规划工件为 Issue 解决方案 | Intermediate |
+
+### 5. Memory 命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/memory:compact`](./memory.md#compact) | 压缩当前会话记忆为结构化文本 | Intermediate |
+| [`/memory:tips`](./memory.md#tips) | 快速笔记记录 | Beginner |
+| [`/memory:load`](./memory.md#load) | 通过 CLI 分析项目加载任务上下文 | Intermediate |
+| [`/memory:update-full`](./memory.md#update-full) | 更新所有 CLAUDE.md 文件 | Intermediate |
+| [`/memory:update-related`](./memory.md#update-related) | 更新 git 变更模块的 CLAUDE.md | Intermediate |
+| [`/memory:docs-full-cli`](./memory.md#docs-full-cli) | 使用 CLI 生成完整项目文档 | Intermediate |
+| [`/memory:docs-related-cli`](./memory.md#docs-related-cli) | 生成 git 变更模块文档 | Intermediate |
+| [`/memory:style-skill-memory`](./memory.md#style-skill-memory) | 从样式参考生成 SKILL 记忆包 | Intermediate |
+
+### 6. CLI 工具命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/cli:cli-init`](./cli.md#cli-init) | 生成配置目录和设置文件 | Intermediate |
+| [`/cli:codex-review`](./cli.md#codex-review) | 使用 Codex CLI 进行交互式代码审查 | Intermediate |
+
+### 7. UI 设计命令
+
+| 命令 | 功能 | 难度 |
+| --- | --- | --- |
+| [`/workflow:ui-design:explore-auto`](./ui-design.md#explore-auto) | 交互式探索性 UI 设计工作流 | Intermediate |
+| [`/workflow:ui-design:imitate-auto`](./ui-design.md#imitate-auto) | 直接代码/图片输入的 UI 设计 | Intermediate |
+| [`/workflow:ui-design:style-extract`](./ui-design.md#style-extract) | 从参考图片或提示提取设计样式 | Intermediate |
+| [`/workflow:ui-design:layout-extract`](./ui-design.md#layout-extract) | 从参考图片提取布局信息 | Intermediate |
+| [`/workflow:ui-design:animation-extract`](./ui-design.md#animation-extract) | 提取动画和过渡模式 | Intermediate |
+| [`/workflow:ui-design:codify-style`](./ui-design.md#codify-style) | 从代码提取样式并生成可共享引用包 | Intermediate |
+| [`/workflow:ui-design:generate`](./ui-design.md#generate) | 组合布局模板与设计令牌生成原型 | Intermediate |
+
+## 自动模式
+
+大多数命令支持 `--yes` 或 `-y` 标志，启用自动模式后跳过确认步骤。
+
+```bash
+# 标准模式 - 需要确认
+/ccw "实现用户认证"
+
+# 自动模式 - 跳过确认直接执行
+/ccw "实现用户认证" --yes
+```
+
+## 相关文档
+
+- [Skills 参考](../skills/)
+- [CLI 调用系统](../features/cli.md)
+- [工作流指南](../guide/ch04-workflow-basics.md)
--- a/docs/zh/commands/claude/issue.md
+++ b/docs/zh/commands/claude/issue.md
@@ -0,0 +1,294 @@
+# Issue 工作流命令
+
+## 一句话定位
+
+**Issue 工作流命令是问题管理的闭环系统** — 从发现、规划到执行，完整追踪问题解决全流程。
+
+## 核心概念速览
+
+| 概念 | 说明 | 存放位置 |
+| --- | --- | --- |
+| **Issue** | 结构化问题定义 | `.workflow/issues/ISS-*.json` |
+| **解决方案** | 执行计划 | `.workflow/solutions/SOL-*.json` |
+| **队列** | 执行队列 | `.workflow/queues/QUE-*.json` |
+| **执行状态** | 进度跟踪 | 队列内状态 |
+
+## 命令列表
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`new`](#new) | 从 GitHub URL 或文本描述创建结构化 Issue | `/issue:new [-y] <github-url \| 描述> [--priority 1-5]` |
+| [`discover`](#discover) | 从多个角度发现潜在 Issue | `/issue:discover [-y] <路径模式> [--perspectives=维度] [--external]` |
+| [`discover-by-prompt`](#discover-by-prompt) | 通过用户提示发现 Issue | `/issue:discover-by-prompt [-y] <提示> [--scope=src/**]` |
+| [`plan`](#plan) | 批量规划 Issue 解决方案 | `/issue:plan [-y] --all-pending <issue-id>[,...] [--batch-size 3]` |
+| [`queue`](#queue) | 形成执行队列 | `/issue:queue [-y] [--queues N] [--issue id]` |
+| [`execute`](#execute) | 执行队列 | `/issue:execute [-y] --queue <queue-id> [--worktree [路径]]` |
+| [`convert-to-plan`](#convert-to-plan) | 转换规划工件为 Issue 解决方案 | `/issue:convert-to-plan [-y] [--issue id] [--supplement] <来源>` |
+
+## 命令详解
+
+### new
+
+**功能**: 从 GitHub URL 或文本描述创建结构化 Issue，支持需求清晰度检测。
+
+**语法**:
+```
+/issue:new [-y|--yes] <github-url | 文本描述> [--priority 1-5]
+```
+
+**选项**:
+- `--priority 1-5`: 优先级（1=关键，5=低）
+
+**清晰度检测**:
+
+| 输入类型 | 清晰度 | 行为 |
+| --- | --- | --- |
+| GitHub URL | 3 | 直接创建 |
+| 结构化文本 | 2 | 直接创建 |
+| 长文本 | 1 | 部分澄清 |
+| 短文本 | 0 | 完全澄清 |
+
+**Issue 结构**:
+```typescript
+interface Issue {
+  id: string;                    // GH-123 或 ISS-YYYYMMDD-HHMMSS
+  title: string;
+  status: 'registered' | 'planned' | 'queued' | 'in_progress' | 'completed' | 'failed';
+  priority: number;              // 1-5
+  context: string;               // 问题描述（单一真相源）
+  source: 'github' | 'text' | 'discovery';
+  source_url?: string;
+
+  // 绑定
+  bound_solution_id: string | null;
+
+  // 反馈历史
+  feedback?: Array<{
+    type: 'failure' | 'clarification' | 'rejection';
+    stage: string;
+    content: string;
+    created_at: string;
+  }>;
+}
+```
+
+**示例**:
+```bash
+# 从 GitHub 创建
+/issue:new https://github.com/owner/repo/issues/123
+
+# 从文本创建（结构化）
+/issue:new "登录失败：预期成功，实际 500 错误"
+
+# 从文本创建（模糊 - 会询问）
+/issue:new "认证有问题"
+
+# 指定优先级
+/issue:new --priority 2 "支付超时问题"
+```
+
+### discover
+
+**功能**: 从多个角度（Bug、UX、测试、质量、安全、性能、可维护性、最佳实践）发现潜在 Issue。
+
+**语法**:
+```
+/issue:discover [-y|--yes] <路径模式> [--perspectives=bug,ux,...] [--external]
+```
+
+**选项**:
+- `--perspectives=维度`: 分析维度
+  - `bug`: 潜在 Bug
+  - `ux`: UX 问题
+  - `test`: 测试覆盖
+  - `quality`: 代码质量
+  - `security`: 安全问题
+  - `performance`: 性能问题
+  - `maintainability`: 可维护性
+  - `best-practices`: 最佳实践
+- `--external`: 使用 Exa 外部研究（安全、最佳实践）
+
+**示例**:
+```bash
+# 全面扫描
+/issue:discover src/
+
+# 特定维度
+/issue:discover src/auth/ --perspectives=security,bug
+
+# 带外部研究
+/issue:discover src/payment/ --perspectives=security --external
+```
+
+### discover-by-prompt
+
+**功能**: 通过用户提示发现 Issue，使用 Gemini 规划的迭代多代理探索，支持跨模块比较。
+
+**语法**:
+```
+/issue:discover-by-prompt [-y|--yes] <提示> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]
+```
+
+**选项**:
+- `--scope=路径`: 扫描范围
+- `--depth=深度`: standard 或 deep
+- `--max-iterations=N`: 最大迭代次数
+
+**示例**:
+```bash
+# 标准扫描
+/issue:discover-by-prompt "查找认证模块的问题"
+
+# 深度扫描
+/issue:discover-by-prompt "分析 API 性能瓶颈" --depth=deep
+
+# 指定范围
+/issue:discover-by-prompt "检查数据库查询优化" --scope=src/db/
+```
+
+### plan
+
+**功能**: 批量规划 Issue 解决方案，使用 issue-plan-agent（探索+规划闭环）。
+
+**语法**:
+```
+/issue:plan [-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]
+```
+
+**选项**:
+- `--all-pending`: 规划所有待规划的 Issue
+- `--batch-size=N`: 每批处理的 Issue 数量
+
+**示例**:
+```bash
+# 规划特定 Issue
+/issue:plan ISS-20240115-001,ISS-20240115-002
+
+# 规划所有待规划的 Issue
+/issue:plan --all-pending
+
+# 指定批次大小
+/issue:plan --all-pending --batch-size 5
+```
+
+### queue
+
+**功能**: 从绑定解决方案形成执行队列，使用 issue-queue-agent（解决方案级别）。
+
+**语法**:
+```
+/issue:queue [-y|--yes] [--queues <n>] [--issue <id>]
+```
+
+**选项**:
+- `--queues N`: 创建的队列数量
+- `--issue id`: 特定 Issue
+
+**示例**:
+```bash
+# 形成队列
+/issue:queue
+
+# 创建多个队列
+/issue:queue --queues 3
+
+# 特定 Issue
+/issue:queue --issue ISS-20240115-001
+```
+
+### execute
+
+**功能**: 执行队列，使用 DAG 并行编排（每个解决方案一次提交）。
+
+**语法**:
+```
+/issue:execute [-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]
+```
+
+**选项**:
+- `--queue id`: 队列 ID
+- `--worktree [路径]`: 可选的工作树路径
+
+**示例**:
+```bash
+# 执行队列
+/issue:execute --queue QUE-20240115-001
+
+# 使用工作树
+/issue:execute --queue QUE-20240115-001 --worktree ../feature-branch
+```
+
+### convert-to-plan
+
+**功能**: 转换规划工件（lite-plan、工作流会话、markdown）为 Issue 解决方案。
+
+**语法**:
+```
+/issue:convert-to-plan [-y|--yes] [--issue <id>] [--supplement] <来源>
+```
+
+**选项**:
+- `--issue id`: 绑定到现有 Issue
+- `--supplement`: 补充模式（添加到现有解决方案）
+
+**来源类型**:
+- lite-plan 工件
+- 工作流会话
+- Markdown 文件
+
+**示例**:
+```bash
+# 从 lite-plan 转换
+/issue:convert-to-plan .workflow/sessions/WFS-xxx/artifacts/lite-plan.md
+
+# 绑定到 Issue
+/issue:convert-to-plan --issue ISS-20240115-001 plan.md
+
+# 补充模式
+/issue:convert-to-plan --supplement additional-plan.md
+```
+
+### from-brainstorm
+
+**功能**: 从头脑风暴会话想法转换为 Issue 并生成可执行解决方案。
+
+**语法**:
+```
+/issue:from-brainstorm SESSION="会话-id" [--idea=<索引>] [--auto] [-y|--yes]
+```
+
+**选项**:
+- `--idea=索引`: 特定想法索引
+- `--auto`: 自动模式
+
+**示例**:
+```bash
+# 转换所有想法
+/issue:from-brainstorm SESSION="WFS-brainstorm-2024-01-15"
+
+# 转换特定想法
+/issue:from-brainstorm SESSION="WFS-brainstorm-2024-01-15" --idea=3
+
+# 自动模式
+/issue:from-brainstorm --auto SESSION="WFS-brainstorm-2024-01-15"
+```
+
+## Issue 工作流程
+
+```mermaid
+graph TD
+    A[发现 Issue] --> B[创建 Issue]
+    B --> C[规划解决方案]
+    C --> D[形成执行队列]
+    D --> E[执行队列]
+    E --> F{成功?}
+    F -->|是| G[完成]
+    F -->|否| H[反馈学习]
+    H --> C
+```
+
+## 相关文档
+
+- [工作流命令](./workflow.md)
+- [核心编排](./core-orchestration.md)
+- [团队系统](../../features/)
--- a/docs/zh/commands/claude/memory.md
+++ b/docs/zh/commands/claude/memory.md
@@ -0,0 +1,262 @@
+# Memory 命令
+
+## 一句话定位
+
+**Memory 命令是跨会话知识持久化系统** — 捕获上下文、更新记忆、生成文档，让 AI 记住项目。
+
+## 核心概念速览
+
+| 概念 | 说明 | 存放位置 |
+| --- | --- | --- |
+| **记忆包** | 结构化项目上下文 | MCP core_memory |
+| **CLAUDE.md** | 模块级项目指南 | 每个模块/目录 |
+| **Tips** | 快速笔记 | `MEMORY.md` |
+| **项目文档** | 生成的文档 | `docs/` 目录 |
+
+## 命令列表
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`compact`](#compact) | 压缩当前会话记忆为结构化文本 | `/memory:compact [可选: 会话描述]` |
+| [`tips`](#tips) | 快速笔记记录 | `/memory:tips <笔记内容> [--tag 标签] [--context 上下文]` |
+| [`load`](#load) | 通过 CLI 分析项目加载任务上下文 | `/memory:load [--tool gemini\|qwen] "任务上下文描述"` |
+| [`update-full`](#update-full) | 更新所有 CLAUDE.md 文件 | `/memory:update-full [--tool gemini\|qwen\|codex] [--path 目录]` |
+| [`update-related`](#update-related) | 更新 git 变更模块的 CLAUDE.md | `/memory:update-related [--tool gemini\|qwen\|codex]` |
+| [`docs-full-cli`](#docs-full-cli) | 使用 CLI 生成完整项目文档 | `/memory:docs-full-cli [路径] [--tool 工具]` |
+| [`docs-related-cli`](#docs-related-cli) | 生成 git 变更模块文档 | `/memory:docs-related-cli [--tool 工具]` |
+| [`style-skill-memory`](#style-skill-memory) | 从样式参考生成 SKILL 记忆包 | `/memory:style-skill-memory [包名] [--regenerate]` |
+
+## 命令详解
+
+### compact
+
+**功能**: 压缩当前会话记忆为结构化文本，提取目标、计划、文件、决策、约束、状态，并通过 MCP core_memory 工具保存。
+
+**语法**:
+```
+/memory:compact [可选: 会话描述]
+```
+
+**提取内容**:
+- 目标 (objective)
+- 计划 (plan)
+- 文件 (files)
+- 决策 (decisions)
+- 约束 (constraints)
+- 状态 (state)
+
+**示例**:
+```bash
+# 基础压缩
+/memory:compact
+
+# 带描述
+/memory:compact "用户认证实现会话"
+```
+
+### tips
+
+**功能**: 快速笔记记录命令，捕获想法、片段、提醒和洞察供后续参考。
+
+**语法**:
+```
+/memory:tips <笔记内容> [--tag <标签1,标签2>] [--context <上下文>]
+```
+
+**选项**:
+- `--tag=标签`: 标签（逗号分隔）
+- `--context=上下文`: 上下文信息
+
+**示例**:
+```bash
+# 基础笔记
+/memory:tips "记得使用 rate limiting 限制 API 调用"
+
+# 带标签
+/memory:tips "认证中间件需要处理 token 过期" --tag auth,api
+
+# 带上下文
+/memory:tips "使用 Redis 缓存用户会话" --context "登录优化"
+```
+
+### load
+
+**功能**: 委托给 universal-executor 代理，通过 Gemini/Qwen CLI 分析项目并返回 JSON 核心内容包用于任务上下文。
+
+**语法**:
+```
+/memory:load [--tool gemini|qwen] "任务上下文描述"
+```
+
+**选项**:
+- `--tool=工具`: 使用的 CLI 工具
+
+**输出**: JSON 格式的项目上下文包
+
+**示例**:
+```bash
+# 使用默认工具
+/memory:load "用户认证模块"
+
+# 指定工具
+/memory:load --tool gemini "支付系统架构"
+```
+
+### update-full
+
+**功能**: 更新所有 CLAUDE.md 文件，使用基于层的执行（Layer 3→1），批量代理处理（4 模块/代理）和 gemini→qwen→codex 回退。
+
+**语法**:
+```
+/memory:update-full [--tool gemini|qwen|codex] [--path <目录>]
+```
+
+**选项**:
+- `--tool=工具`: 使用的 CLI 工具
+- `--path=目录`: 特定目录
+
+**层结构**:
+- Layer 3: 项目级分析
+- Layer 2: 模块级分析
+- Layer 1: 文件级分析
+
+**示例**:
+```bash
+# 更新整个项目
+/memory:update-full
+
+# 更新特定目录
+/memory:update-full --path src/auth/
+
+# 指定工具
+/memory:update-full --tool qwen
+```
+
+### update-related
+
+**功能**: 更新 git 变更模块的 CLAUDE.md 文件，使用批量代理执行（4 模块/代理）和 gemini→qwen→codex 回退。
+
+**语法**:
+```
+/memory:update-related [--tool gemini|qwen|codex]
+```
+
+**选项**:
+- `--tool=工具`: 使用的 CLI 工具
+
+**示例**:
+```bash
+# 默认更新
+/memory:update-related
+
+# 指定工具
+/memory:update-related --tool gemini
+```
+
+### docs-full-cli
+
+**功能**: 使用 CLI 执行生成完整项目文档（Layer 3→1），批量代理处理（4 模块/代理）和 gemini→qwen→codex 回退，<20 模块使用直接并行。
+
+**语法**:
+```
+/memory:docs-full-cli [路径] [--tool <gemini|qwen|codex>]
+```
+
+**示例**:
+```bash
+# 生成整个项目文档
+/memory:docs-full-cli
+
+# 生成特定目录文档
+/memory:docs-full-cli src/
+
+# 指定工具
+/memory:docs-full-cli --tool gemini
+```
+
+### docs-related-cli
+
+**功能**: 使用 CLI 执行生成 git 变更模块文档，批量代理处理（4 模块/代理）和 gemini→qwen→codex 回退，<15 模块使用直接执行。
+
+**语法**:
+```
+/memory:docs-related-cli [--tool <gemini|qwen|codex>]
+```
+
+**示例**:
+```bash
+# 默认生成
+/memory:docs-related-cli
+
+# 指定工具
+/memory:docs-related-cli --tool qwen
+```
+
+### style-skill-memory
+
+**功能**: 从样式参考生成 SKILL 记忆包，便于加载和一致的设计系统使用。
+
+**语法**:
+```
+/memory:style-skill-memory [包名] [--regenerate]
+```
+
+**选项**:
+- `--regenerate`: 重新生成
+
+**示例**:
+```bash
+# 生成样式记忆包
+/memory:style-skill-memory my-design-system
+
+# 重新生成
+/memory:style-skill-memory my-design-system --regenerate
+```
+
+## Memory 系统工作流程
+
+```mermaid
+graph TD
+    A[会话中] --> B[捕获上下文]
+    B --> C{会话完成?}
+    C -->|是| D[压缩记忆]
+    C -->|否| E[继续工作]
+    D --> F[保存到 core_memory]
+    F --> G[更新 CLAUDE.md]
+    G --> H[生成文档]
+    H --> I[新会话开始]
+    I --> J[加载记忆包]
+    J --> K[恢复上下文]
+    K --> A
+```
+
+## CLAUDE.md 结构
+
+```markdown
+# 模块名称
+
+## 一句话定位
+模块的核心价值描述
+
+## 技术栈
+- 框架/库
+- 主要依赖
+
+## 关键文件
+- 文件路径: 说明
+
+## 代码约定
+- 命名规范
+- 架构模式
+- 最佳实践
+
+## 待办事项
+- 计划中的功能
+- 已知问题
+```
+
+## 相关文档
+
+- [Memory 记忆系统](../../features/memory.md)
+- [核心编排](./core-orchestration.md)
+- [工作流指南](../../guide/ch03-core-concepts.md)
--- a/docs/zh/commands/claude/session.md
+++ b/docs/zh/commands/claude/session.md
@@ -0,0 +1,256 @@
+# 会话管理命令
+
+## 一句话定位
+
+**会话管理命令是工作流的状态管理者** — 创建、跟踪、恢复和完成工作流会话。
+
+## 核心概念速览
+
+| 概念 | 说明 | 位置 |
+| --- | --- | --- |
+| **会话 ID** | 唯一标识符 (WFS-YYYY-MM-DD) | `.workflow/active/WFS-xxx/` |
+| **会话类型** | workflow, review, tdd, test, docs | 会话元数据 |
+| **会话状态** | active, paused, completed | workflow-session.json |
+| **工件** | 规划、任务、TODO 等文件 | 会话目录 |
+
+## 命令列表
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`start`](#start) | 发现现有会话或启动新工作流会话 | `/workflow:session:start [--type 类型] [--auto\|--new] [描述]` |
+| [`list`](#list) | 列出所有工作流会话 | `/workflow:session:list` |
+| [`resume`](#resume) | 恢复最近暂停的工作流会话 | `/workflow:session:resume` |
+| [`complete`](#complete) | 标记活动工作流会话为完成 | `/workflow:session:complete [-y] [--detailed]` |
+| [`solidify`](#solidify) | 将会话学习结晶为项目指南 | `/workflow:session:solidify [-y] [--type 类型] [--category 类别] "规则"` |
+
+## 命令详解
+
+### start
+
+**功能**: 发现现有会话或启动新工作流会话，支持智能会话管理和冲突检测。
+
+**语法**:
+```
+/workflow:session:start [--type <workflow|review|tdd|test|docs>] [--auto|--new] [可选: 任务描述]
+```
+
+**选项**:
+- `--type=类型`: 会话类型
+  - `workflow`: 标准实现（默认）
+  - `review`: 代码审查
+  - `tdd`: TDD 开发
+  - `test`: 测试生成/修复
+  - `docs`: 文档会话
+- `--auto`: 智能模式（自动检测/创建）
+- `--new`: 强制创建新会话
+
+**会话类型**:
+
+| 类型 | 描述 | 默认来源 |
+| --- | --- | --- |
+| `workflow` | 标准实现 | workflow-plan skill |
+| `review` | 代码审查 | review-cycle skill |
+| `tdd` | TDD 开发 | workflow-tdd skill |
+| `test` | 测试生成/修复 | workflow-test-fix skill |
+| `docs` | 文档会话 | memory-manage skill |
+
+**工作流程**:
+
+```mermaid
+graph TD
+    A[开始] --> B{项目状态存在?}
+    B -->|否| C[调用 workflow:init]
+    C --> D
+    B -->|是| D{模式}
+    D -->|默认| E[列出活动会话]
+    D -->|auto| F{活动会话数?}
+    D -->|new| G[创建新会话]
+    F -->|0| G
+    F -->|1| H[使用现有会话]
+    F -->|>1| I[用户选择]
+    E --> J{用户选择}
+    J -->|现有| K[返回会话 ID]
+    J -->|新建| G
+    G --> L[生成会话 ID]
+    L --> M[创建目录结构]
+    M --> N[初始化元数据]
+    N --> O[返回会话 ID]
+```
+
+**示例**:
+
+```bash
+# 发现模式 - 列出活动会话
+/workflow:session:start
+
+# 自动模式 - 智能选择/创建
+/workflow:session:start --auto "实现用户认证"
+
+# 新建模式 - 强制创建新会话
+/workflow:session:start --new "重构支付模块"
+
+# 指定类型
+/workflow:session:start --type review "审查认证代码"
+/workflow:session:start --type tdd --auto "实现登录功能"
+```
+
+### list
+
+**功能**: 列出所有工作流会话，支持状态过滤，显示会话元数据和进度信息。
+
+**语法**:
+```
+/workflow:session:list
+```
+
+**输出格式**:
+
+| 会话 ID | 类型 | 状态 | 描述 | 进度 |
+| --- | --- | --- | --- | --- |
+| WFS-2024-01-15 | workflow | active | 用户认证 | 5/10 |
+| WFS-2024-01-14 | review | paused | 代码审查 | 8/8 |
+| WFS-2024-01-13 | tdd | completed | TDD 开发 | 12/12 |
+
+**示例**:
+```bash
+# 列出所有会话
+/workflow:session:list
+```
+
+### resume
+
+**功能**: 恢复最近暂停的工作流会话，支持自动会话发现和状态更新。
+
+**语法**:
+```
+/workflow:session:resume
+```
+
+**工作流程**:
+
+```mermaid
+graph TD
+    A[开始] --> B[查找暂停会话]
+    B --> C{找到暂停会话?}
+    C -->|是| D[加载会话]
+    C -->|否| E[错误提示]
+    D --> F[更新状态为 active]
+    F --> G[返回会话 ID]
+```
+
+**示例**:
+```bash
+# 恢复最近暂停的会话
+/workflow:session:resume
+```
+
+### complete
+
+**功能**: 标记活动工作流会话为完成，归档并学习经验，更新清单并移除活动标志。
+
+**语法**:
+```
+/workflow:session:complete [-y|--yes] [--detailed]
+```
+
+**选项**:
+- `--detailed`: 详细模式，收集更多经验教训
+
+**工作流程**:
+
+```mermaid
+graph TD
+    A[开始] --> B[确认完成]
+    B --> C{详细模式?}
+    C -->|是| D[收集详细反馈]
+    C -->|否| E[收集基本反馈]
+    D --> F[生成学习文档]
+    E --> F
+    F --> G[归档会话]
+    G --> H[更新清单]
+    H --> I[移除活动标志]
+    I --> J[完成]
+```
+
+**示例**:
+```bash
+# 标准完成
+/workflow:session:complete
+
+# 详细完成
+/workflow:session:complete --detailed
+
+# 自动模式
+/workflow:session:complete -y
+```
+
+### solidify
+
+**功能**: 将会话学习和用户定义的约束结晶为永久项目指南。
+
+**语法**:
+```
+/workflow:session:solidify [-y|--yes] [--type <convention|constraint|learning>] [--category <类别>] "规则或洞察"
+```
+
+**选项**:
+- `--type=类型`:
+  - `convention`: 代码约定
+  - `constraint`: 约束条件
+  - `learning`: 经验学习
+- `--category=类别`: 类别名称（如 `authentication`, `testing`）
+
+**输出位置**:
+- 约定: `.workflow/specs/conventions/<category>.md`
+- 约束: `.workflow/specs/constraints/<category>.md`
+- 学习: `.workflow/specs/learnings/<category>.md`
+
+**示例**:
+```bash
+# 添加代码约定
+/workflow:session:solidify --type=convention --category=auth "所有认证函数必须使用 rate limiting"
+
+# 添加约束
+/workflow:session:solidify --type=constraint --category=database "不使用 N+1 查询"
+
+# 添加学习
+/workflow:session:solidify --type=learning --category=api "REST API 设计经验"
+```
+
+## 会话目录结构
+
+```
+.workflow/
+├── active/                        # 活动会话
+│   └── WFS-2024-01-15/           # 会话目录
+│       ├── workflow-session.json  # 会话元数据
+│       ├── tasks/                 # 任务定义
+│       ├── artifacts/             # 工件文件
+│       └── context/               # 上下文文件
+└── archived/                      # 归档会话
+    └── WFS-2024-01-14/
+```
+
+## 会话元数据
+
+```json
+{
+  "session_id": "WFS-2024-01-15",
+  "type": "workflow",
+  "status": "active",
+  "created_at": "2024-01-15T10:00:00Z",
+  "updated_at": "2024-01-15T14:30:00Z",
+  "description": "用户认证功能实现",
+  "progress": {
+    "total": 10,
+    "completed": 5,
+    "percentage": 50
+  }
+}
+```
+
+## 相关文档
+
+- [工作流命令](./workflow.md)
+- [核心编排](./core-orchestration.md)
+- [工作流基础](../../guide/ch04-workflow-basics.md)
--- a/docs/zh/commands/claude/ui-design.md
+++ b/docs/zh/commands/claude/ui-design.md
@@ -0,0 +1,307 @@
+# UI 设计命令
+
+## 一句话定位
+
+**UI 设计命令是界面原型生成系统** — 从样式提取、布局分析到原型组装，完整覆盖 UI 设计流程。
+
+## 核心概念速览
+
+| 概念 | 说明 | 存放位置 |
+| --- | --- | --- |
+| **设计运行** | 设计会话目录 | `.workflow/ui-design-runs/<run-id>/` |
+| **设计令牌** | 样式变量 | `design-tokens.json` |
+| **布局模板** | 结构定义 | `layouts/` |
+| **原型** | 生成的组件 | `prototypes/` |
+
+## 命令列表
+
+### 发现与提取
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`explore-auto`](#explore-auto) | 交互式探索性 UI 设计工作流 | `/workflow:ui-design:explore-auto [--input "值"] [--targets "列表"]` |
+| [`imitate-auto`](#imitate-auto) | 直接代码/图片输入的 UI 设计 | `/workflow:ui-design:imitate-auto [--input "值"] [--session id]` |
+| [`style-extract`](#style-extract) | 从参考图片或提示提取设计样式 | `/workflow:ui-design:style-extract [-y] [--design-id id]` |
+| [`layout-extract`](#layout-extract) | 从参考图片提取布局信息 | `/workflow:ui-design:layout-extract [-y] [--design-id id]` |
+| [`animation-extract`](#animation-extract) | 提取动画和过渡模式 | `/workflow:ui-design:animation-extract [-y] [--design-id id]` |
+
+### 导入与导出
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`import-from-code`](#import-from-code) | 从代码文件导入设计系统 | `/workflow:ui-design:import-from-code [--design-id id] [--session id] [--source path]` |
+| [`codify-style`](#codify-style) | 从代码提取样式并生成可共享引用包 | `/workflow:ui-design:codify-style <path> [--package-name name]` |
+| [`reference-page-generator`](#reference-page-generator) | 从设计运行生成多组件参考页面 | `/workflow:ui-design:reference-page-generator [--design-run path]` |
+
+### 生成与同步
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`generate`](#generate) | 组合布局模板与设计令牌生成原型 | `/workflow:ui-design:generate [--design-id id] [--session id]` |
+| [`design-sync`](#design-sync) | 同步最终设计系统引用到头脑风暴工件 | `/workflow:ui-design:design-sync --session <session_id>` |
+
+## 命令详解
+
+### explore-auto
+
+**功能**: 交互式探索性 UI 设计工作流，以样式为中心的批量生成，从提示/图片创建设计变体，支持并行执行和用户选择。
+
+**语法**:
+```
+/workflow:ui-design:explore-auto [--input "<值>"] [--targets "<列表>"] [--target-type "page|component"] [--session <id>] [--style-variants <数量>] [--layout-variants <数量>]
+```
+
+**选项**:
+- `--input=值`: 输入提示或图片路径
+- `--targets=列表`: 目标组件列表（逗号分隔）
+- `--target-type=类型`: page 或 component
+- `--session=id`: 会话 ID
+- `--style-variants=N`: 样式变体数量
+- `--layout-variants=N`: 布局变体数量
+
+**示例**:
+```bash
+# 页面设计探索
+/workflow:ui-design:explore-auto --input "现代电商首页" --target-type page --style-variants 3
+
+# 组件设计探索
+/workflow:ui-design:explore-auto --input "用户卡片组件" --target-type component --layout-variants 5
+
+# 多目标设计
+/workflow:ui-design:explore-auto --targets "header,sidebar,footer" --style-variants 2
+```
+
+### imitate-auto
+
+**功能**: UI 设计工作流，支持直接代码/图片输入进行设计令牌提取和原型生成。
+
+**语法**:
+```
+/workflow:ui-design:imitate-auto [--input "<值>"] [--session <id>]
+```
+
+**选项**:
+- `--input=值`: 代码文件路径或图片路径
+- `--session=id`: 会话 ID
+
+**示例**:
+```bash
+# 从代码模仿
+/workflow:ui-design:imitate-auto --input "./src/components/Button.tsx"
+
+# 从图片模仿
+/workflow:ui-design:imitate-auto --input "./designs/mockup.png"
+```
+
+### style-extract
+
+**功能**: 从参考图片或文本提示使用 Claude 分析提取设计样式，支持变体生成或精化模式。
+
+**语法**:
+```
+/workflow:ui-design:style-extract [-y|--yes] [--design-id <id>] [--session <id>] [--images "<glob>"] [--prompt "<描述>"] [--variants <数量>] [--interactive] [--refine]
+```
+
+**选项**:
+- `--images=glob`: 图片 glob 模式
+- `--prompt=描述`: 文本描述
+- `--variants=N`: 变体数量
+- `--interactive`: 交互模式
+- `--refine`: 精化模式
+
+**示例**:
+```bash
+# 从图片提取样式
+/workflow:ui-design:style-extract --images "./designs/*.png" --variants 3
+
+# 从提示提取
+/workflow:ui-design:style-extract --prompt "深色主题，蓝色主色调，圆角设计"
+
+# 交互精化
+/workflow:ui-design:style-extract --images "reference.png" --refine --interactive
+```
+
+### layout-extract
+
+**功能**: 从参考图片或文本提示使用 Claude 分析提取结构布局信息，支持变体生成或精化模式。
+
+**语法**:
+```
+/workflow:ui-design:layout-extract [-y|--yes] [--design-id <id>] [--session <id>] [--images "<glob>"] [--prompt "<描述>"] [--targets "<列表>"] [--variants <数量>] [--device-type <desktop|mobile|tablet|responsive>] [--interactive] [--refine]
+```
+
+**选项**:
+- `--device-type=类型`: desktop, mobile, tablet 或 responsive
+- 其他同 style-extract
+
+**示例**:
+```bash
+# 提取桌面布局
+/workflow:ui-design:layout-extract --images "desktop-mockup.png" --device-type desktop
+
+# 提取响应式布局
+/workflow:ui-design:layout-extract --prompt "三栏布局，响应式设计" --device-type responsive
+
+# 多变体
+/workflow:ui-design:layout-extract --images "layout.png" --variants 5
+```
+
+### animation-extract
+
+**功能**: 从提示推断和图片引用提取动画和过渡模式，用于设计系统文档。
+
+**语法**:
+```
+/workflow:ui-design:animation-extract [-y|--yes] [--design-id <id>] [--session <id>] [--images "<glob>"] [--focus "<类型>"] [--interactive] [--refine]
+```
+
+**选项**:
+- `--focus=类型`: 特定动画类型（如 fade, slide, scale）
+
+**示例**:
+```bash
+# 提取所有动画
+/workflow:ui-design:animation-extract --images "./animations/*.gif"
+
+# 提取特定类型
+/workflow:ui-design:animation-extract --focus "fade,slide" --interactive
+```
+
+### import-from-code
+
+**功能**: 从代码文件（CSS/JS/HTML/SCSS）导入设计系统，使用自动文件发现和并行代理分析。
+
+**语法**:
+```
+/workflow:ui-design:import-from-code [--design-id <id>] [--session <id>] [--source <path>]
+```
+
+**选项**:
+- `--source=路径`: 源代码目录
+
+**示例**:
+```bash
+# 从项目导入
+/workflow:ui-design:import-from-code --source "./src/styles/"
+
+# 指定设计 ID
+/workflow:ui-design:import-from-code --design-id my-design --source "./theme/"
+```
+
+### codify-style
+
+**功能**: 编排器从代码提取样式并生成可共享引用包，支持预览（自动文件发现）。
+
+**语法**:
+```
+/workflow:ui-design:codify-style <path> [--package-name <name>] [--output-dir <path>] [--overwrite]
+```
+
+**选项**:
+- `--package-name=名称`: 包名称
+- `--output-dir=路径`: 输出目录
+- `--overwrite`: 覆盖现有文件
+
+**示例**:
+```bash
+# 生成样式包
+/workflow:ui-design:codify-style ./src/styles/ --package-name my-design-system
+
+# 指定输出目录
+/workflow:ui-design:codify-style ./theme/ --output-dir ./design-packages/
+```
+
+### reference-page-generator
+
+**功能**: 从设计运行提取生成多组件参考页面和文档。
+
+**语法**:
+```
+/workflow:ui-design:reference-page-generator [--design-run <path>] [--package-name <name>] [--output-dir <path>]
+```
+
+**示例**:
+```bash
+# 生成参考页面
+/workflow:ui-design:reference-page-generator --design-run .workflow/ui-design-runs/latest/
+
+# 指定包名
+/workflow:ui-design:reference-page-generator --package-name component-library
+```
+
+### generate
+
+**功能**: 组装 UI 原型，将布局模板与设计令牌（默认动画支持）组合，纯组装器无新内容生成。
+
+**语法**:
+```
+/workflow:ui-design:generate [--design-id <id>] [--session <id>]
+```
+
+**示例**:
+```bash
+# 生成原型
+/workflow:ui-design:generate
+
+# 使用特定设计
+/workflow:ui-design:generate --design-id my-design
+```
+
+### design-sync
+
+**功能**: 同步最终设计系统引用到头脑风暴工件，准备供 `/workflow:plan` 消费。
+
+**语法**:
+```
+/workflow:ui-design:design-sync --session <session_id> [--selected-prototypes "<列表>"]
+```
+
+**选项**:
+- `--selected-prototypes=列表`: 选定的原型列表
+
+**示例**:
+```bash
+# 同步所有原型
+/workflow:ui-design:design-sync --session WFS-design-2024-01-15
+
+# 同步选定原型
+/workflow:ui-design:design-sync --session WFS-design-2024-01-15 --selected-prototypes "header,button,card"
+```
+
+## UI 设计工作流程
+
+```mermaid
+graph TD
+    A[输入] --> B{输入类型}
+    B -->|图片/提示| C[提取样式]
+    B -->|代码| D[导入样式]
+    C --> E[提取布局]
+    D --> E
+    E --> F[提取动画]
+    F --> G[设计运行]
+    G --> H[生成原型]
+    H --> I[同步到头脑风暴]
+    I --> J[规划工作流]
+```
+
+## 设计运行结构
+
+```
+.workflow/ui-design-runs/<run-id>/
+├── design-tokens.json       # 设计令牌
+├── layouts/                 # 布局模板
+│   ├── header.json
+│   ├── footer.json
+│   └── ...
+├── prototypes/              # 生成的原型
+│   ├── header/
+│   ├── button/
+│   └── ...
+└── reference-pages/         # 参考页面
+```
+
+## 相关文档
+
+- [核心编排](./core-orchestration.md)
+- [工作流命令](./workflow.md)
+- [头脑风暴](../../features/)
--- a/docs/zh/commands/claude/workflow.md
+++ b/docs/zh/commands/claude/workflow.md
@@ -0,0 +1,338 @@
+# 工作流命令
+
+## 一句话定位
+
+**工作流命令是 Claude_dms3 的执行引擎** — 提供从轻量级任务到复杂项目的完整工作流支持。
+
+## 命令列表
+
+### 轻量级工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`lite-lite-lite`](#lite-lite-lite) | 超轻量级多工具分析和直接执行 | `/workflow:lite-lite-lite [-y] <任务>` |
+| [`lite-plan`](#lite-plan) | 轻量级交互式规划工作流 | `/workflow:lite-plan [-y] [-e] "任务"` |
+| [`lite-execute`](#lite-execute) | 基于内存计划执行任务 | `/workflow:lite-execute [-y] [--in-memory] [任务]` |
+| [`lite-fix`](#lite-fix) | 轻量级 Bug 诊断和修复 | `/workflow:lite-fix [-y] [--hotfix] "Bug 描述"` |
+
+### 标准工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`plan`](#plan) | 5 阶段规划工作流 | `/workflow:plan [-y] "描述"\|file.md` |
+| [`execute`](#execute) | 协调代理执行工作流任务 | `/workflow:execute [-y] [--resume-session=ID]` |
+| [`replan`](#replan) | 交互式工作流重新规划 | `/workflow:replan [-y] [--session ID] [task-id] "需求"` |
+
+### 协作工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`multi-cli-plan`](#multi-cli-plan) | 多 CLI 协作规划 | `/workflow:multi-cli-plan [-y] <任务> [--max-rounds=N]` |
+| [`brainstorm-with-file`](#brainstorm-with-file) | 交互式头脑风暴 | `/workflow:brainstorm-with-file [-y] [-c] "想法"` |
+| [`analyze-with-file`](#analyze-with-file) | 交互式协作分析 | `/workflow:analyze-with-file [-y] [-c] "主题"` |
+| [`debug-with-file`](#debug-with-file) | 交互式假设驱动调试 | `/workflow:debug-with-file [-y] "Bug 描述"` |
+| [`unified-execute-with-file`](#unified-execute-with-file) | 通用执行引擎 | `/workflow:unified-execute-with-file [-y] [-p path] [上下文]` |
+
+### TDD 工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`tdd-plan`](#tdd-plan) | TDD 规划工作流 | `/workflow:tdd-plan "功能描述"` |
+| [`tdd-verify`](#tdd-verify) | 验证 TDD 工作流合规性 | `/workflow:tdd-verify [--session ID]` |
+
+### 测试工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`test-fix-gen`](#test-fix-gen) | 创建测试修复工作流会话 | `/workflow:test-fix-gen (session-id\|"描述"\|file.md)` |
+| [`test-gen`](#test-gen) | 从实现会话创建测试会话 | `/workflow:test-gen source-session-id` |
+| [`test-cycle-execute`](#test-cycle-execute) | 执行测试修复工作流 | `/workflow:test-cycle-execute [--resume-session=ID]` |
+
+### 审查工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`review`](#review) | 实现后审查 | `/workflow:review [--type=类型] [--archived] [session-id]` |
+| [`review-module-cycle`](#review-module-cycle) | 独立多维度代码审查 | `/workflow:review-module-cycle <路径> [--dimensions=维度]` |
+| [`review-session-cycle`](#review-session-cycle) | 基于会话的审查 | `/workflow:review-session-cycle [session-id] [--dimensions=维度]` |
+| [`review-cycle-fix`](#review-cycle-fix) | 自动修复审查发现 | `/workflow:review-cycle-fix <export-file\|review-dir>` |
+
+### 专用工作流
+
+| 命令 | 功能 | 语法 |
+| --- | --- | --- |
+| [`clean`](#clean) | 智能代码清理 | `/workflow:clean [-y] [--dry-run] ["焦点区域"]` |
+| [`init`](#init) | 初始化项目状态 | `/workflow:init [--regenerate]` |
+| [`plan-verify`](#plan-verify) | 验证规划一致性 | `/workflow:plan-verify [--session session-id]` |
+
+## 命令详解
+
+### lite-lite-lite
+
+**功能**: 超轻量级多工具分析和直接执行。简单任务无工件，复杂任务自动在 `.workflow/.scratchpad/` 创建规划文档。
+
+**语法**:
+```
+/workflow:lite-lite-lite [-y|--yes] <任务描述>
+```
+
+**使用场景**:
+- 超简单快速任务
+- 不需要规划文档的代码修改
+- 自动工具选择
+
+**示例**:
+```bash
+# 超简单任务
+/workflow:lite-lite-lite "修复 header 样式"
+
+# 自动模式
+/workflow:lite-lite-lite -y "更新 README 链接"
+```
+
+### lite-plan
+
+**功能**: 轻量级交互式规划工作流，支持内存规划、代码探索和执行到 lite-execute。
+
+**语法**:
+```
+/workflow:lite-plan [-y|--yes] [-e|--explore] "任务描述" | file.md
+```
+
+**选项**:
+- `-e, --explore`: 先执行代码探索
+
+**示例**:
+```bash
+# 基础规划
+/workflow:lite-plan "添加用户头像功能"
+
+# 带探索
+/workflow:lite-plan -e "重构认证模块"
+```
+
+### lite-execute
+
+**功能**: 基于内存计划、提示描述或文件内容执行任务。
+
+**语法**:
+```
+/workflow:lite-execute [-y|--yes] [--in-memory] ["任务描述" | file-path]
+```
+
+**选项**:
+- `--in-memory`: 使用内存计划
+
+**示例**:
+```bash
+# 执行任务
+/workflow:lite-execute "实现头像上传 API"
+
+# 使用内存计划
+/workflow:lite-execute --in-memory
+```
+
+### lite-fix
+
+**功能**: 轻量级 Bug 诊断和修复工作流，支持智能严重程度评估和可选的热修复模式。
+
+**语法**:
+```
+/workflow:lite-fix [-y|--yes] [--hotfix] "Bug 描述或 Issue 引用"
+```
+
+**选项**:
+- `--hotfix`: 热修复模式（生产事故快速修复）
+
+**示例**:
+```bash
+# Bug 修复
+/workflow:lite-fix "登录时出现 500 错误"
+
+# 热修复
+/workflow:lite-fix --hotfix "支付网关超时"
+```
+
+### plan
+
+**功能**: 5 阶段规划工作流，输出 IMPL_PLAN.md 和任务 JSON。
+
+**语法**:
+```
+/workflow:plan [-y|--yes] "文本描述" | file.md
+```
+
+**阶段**:
+1. 会话初始化
+2. 上下文收集
+3. 规范加载
+4. 任务生成
+5. 验证/重新规划
+
+**示例**:
+```bash
+# 从描述规划
+/workflow:plan "实现用户通知系统"
+
+# 从文件规划
+/workflow:plan requirements.md
+```
+
+### execute
+
+**功能**: 协调代理执行工作流任务，支持自动会话发现、并行任务处理和状态跟踪。
+
+**语法**:
+```
+/workflow:execute [-y|--yes] [--resume-session="session-id"]
+```
+
+**示例**:
+```bash
+# 执行当前会话
+/workflow:execute
+
+# 恢复并执行会话
+/workflow:execute --resume-session=WFS-2024-01-15
+```
+
+### replan
+
+**功能**: 交互式工作流重新规划，支持会话级工件更新和边界澄清。
+
+**语法**:
+```
+/workflow:replan [-y|--yes] [--session session-id] [task-id] "需求" | file.md [--interactive]
+```
+
+**示例**:
+```bash
+# 重新规划整个会话
+/workflow:replan --session=WFS-xxx "添加用户权限检查"
+
+# 重新规划特定任务
+/workflow:replan TASK-001 "改为使用 RBAC"
+```
+
+### multi-cli-plan
+
+**功能**: 多 CLI 协作规划工作流，使用 ACE 上下文收集和迭代交叉验证。
+
+**语法**:
+```
+/workflow:multi-cli-plan [-y|--yes] <任务描述> [--max-rounds=3] [--tools=gemini,codex] [--mode=parallel|serial]
+```
+
+**选项**:
+- `--max-rounds=N`: 最大讨论轮数
+- `--tools=工具`: 使用的 CLI 工具
+- `--mode=模式`: 并行或串行模式
+
+**示例**:
+```bash
+# 多 CLI 规划
+/workflow:multi-cli-plan "设计微服务架构"
+
+# 指定工具和轮数
+/workflow:multi-cli-plan --tools=gemini,codex --max-rounds=5 "数据库迁移方案"
+```
+
+### brainstorm-with-file
+
+**功能**: 交互式头脑风暴，多 CLI 协作、想法扩展和文档化思维演化。
+
+**语法**:
+```
+/workflow:brainstorm-with-file [-y|--yes] [-c|--continue] [-m|--mode creative|structured] "想法或主题"
+```
+
+**选项**:
+- `-c, --continue`: 继续现有会话
+- `-m, --mode=模式`: creative 或 structured
+
+**示例**:
+```bash
+# 创意头脑风暴
+/workflow:brainstorm-with-file --mode creative "用户增长策略"
+
+# 结构化头脑风暴
+/workflow:brainstorm-with-file --mode structured "API 版本控制方案"
+```
+
+### analyze-with-file
+
+**功能**: 交互式协作分析，有文档化的讨论、CLI 辅助探索和演化理解。
+
+**语法**:
+```
+/workflow:analyze-with-file [-y|--yes] [-c|--continue] "主题或问题"
+```
+
+**示例**:
+```bash
+# 分析主题
+/workflow:analyze-with-file "认证架构设计"
+
+# 继续讨论
+/workflow:analyze-with-file -c
+```
+
+### debug-with-file
+
+**功能**: 交互式假设驱动调试，有文档化的探索、理解演化和 Gemini 辅助修正。
+
+**语法**:
+```
+/workflow:debug-with-file [-y|--yes] "Bug 描述或错误信息"
+```
+
+**示例**:
+```bash
+# 调试 Bug
+/workflow:debug-with-file "WebSocket 连接随机断开"
+
+# 调试错误
+/workflow:debug-with-file "TypeError: Cannot read property 'id'"
+```
+
+### unified-execute-with-file
+
+**功能**: 通用执行引擎，消费任何规划/头脑风暴/分析输出，支持最小进度跟踪、多代理协调和增量执行。
+
+**语法**:
+```
+/workflow:unified-execute-with-file [-y|--yes] [-p|--plan <path>] [-m|--mode sequential|parallel] ["执行上下文"]
+```
+
+**示例**:
+```bash
+# 执行规划
+/workflow:unified-execute-with-file -p plan.md
+
+# 并行执行
+/workflow:unified-execute-with-file -m parallel
+```
+
+## 工作流程图
+
+```mermaid
+graph TD
+    A[任务输入] --> B{任务复杂度}
+    B -->|简单| C[Lite 工作流]
+    B -->|标准| D[Plan 工作流]
+    B -->|复杂| E[Multi-CLI 工作流]
+
+    C --> F[直接执行]
+    D --> G[规划] --> H[执行]
+    E --> I[多 CLI 讨论] --> G
+
+    F --> J[完成]
+    H --> J
+    I --> J
+```
+
+## 相关文档
+
+- [会话管理](./session.md)
+- [核心编排](./core-orchestration.md)
+- [工作流指南](../../guide/ch04-workflow-basics.md)
--- a/docs/zh/commands/codex/index.md
+++ b/docs/zh/commands/codex/index.md
@@ -0,0 +1,56 @@
+# Codex Prompts
+
+## 一句话定位
+
+**Codex Prompts 是 Codex CLI 使用的提示模板系统** — 标准化的提示格式确保一致的代码质量和审查效果。
+
+## 核心概念速览
+
+| 概念 | 说明 | 用途 |
+| --- | --- | --- |
+| **Prep 提示** | 项目上下文准备提示 | 分析项目结构、提取相关文件 |
+| **Review 提示** | 代码审查提示 | 多维度代码质量检查 |
+
+## Prompt 列表
+
+### Prep 系列
+
+| 提示 | 功能 | 用途 |
+| --- | --- | --- |
+| [`memory:prepare`](./prep.md#memory-prepare) | 项目上下文准备 | 为任务准备结构化项目上下文 |
+
+### Review 系列
+
+| 提示 | 功能 | 用途 |
+| --- | --- | --- |
+| [`codex-review`](./review.md#codex-review) | 交互式代码审查 | 使用 Codex CLI 进行代码审查 |
+
+## Prompt 模板格式
+
+所有 Codex Prompts 遵循标准 CCW CLI 提示模板：
+
+```
+PURPOSE: [目标] + [原因] + [成功标准] + [约束/范围]
+TASK: • [步骤 1] • [步骤 2] • [步骤 3]
+MODE: review
+CONTEXT: [审查目标描述] | Memory: [相关上下文]
+EXPECTED: [交付格式] + [质量标准]
+CONSTRAINTS: [关注约束]
+```
+
+## 字段说明
+
+| 字段 | 说明 | 示例 |
+| --- | --- | --- |
+| **PURPOSE** | 目的和原因 | "识别安全漏洞，确保代码安全" |
+| **TASK** | 具体步骤 | "• 扫描注入漏洞 • 检查认证逻辑" |
+| **MODE** | 执行模式 | analysis, write, review |
+| **CONTEXT** | 上下文信息 | "@CLAUDE.md @src/auth/**" |
+| **EXPECTED** | 输出格式 | "结构化报告，包含严重程度级别" |
+| **CONSTRAINTS** | 约束条件 | "关注可操作的建议" |
+
+## 相关文档
+
+- [Claude Commands](../claude/)
+- [CLI 调用系统](../../features/cli.md)
+- [代码审查](../../features/)
--- a/docs/zh/commands/codex/prep.md
+++ b/docs/zh/commands/codex/prep.md
@@ -0,0 +1,168 @@
+# Prep 提示
+
+## 一句话定位
+
+**Prep 提示是项目上下文准备的标准化模板** — 通过代理驱动分析生成结构化项目核心内容包。
+
+## 核心内容包结构
+
+```json
+{
+  "task_context": "任务上下文描述",
+  "keywords": ["关键词1", "关键词2"],
+  "project_summary": {
+    "architecture": "架构描述",
+    "tech_stack": ["技术1", "技术2"],
+    "key_patterns": ["模式1", "模式2"]
+  },
+  "relevant_files": [
+    {
+      "path": "文件路径",
+      "relevance": "相关性说明",
+      "priority": "high|medium|low"
+    }
+  ],
+  "integration_points": [
+    "集成点1",
+    "集成点2"
+  ],
+  "constraints": [
+    "约束1",
+    "约束2"
+  ]
+}
+```
+
+## memory:prepare
+
+**功能**: 委托给 universal-executor 代理，通过 Gemini/Qwen CLI 分析项目并返回 JSON 核心内容包用于任务上下文。
+
+**语法**:
+```
+/memory:prepare [--tool gemini|qwen] "任务上下文描述"
+```
+
+**选项**:
+- `--tool=工具`: 指定 CLI 工具（默认：gemini）
+  - `gemini`: 大上下文窗口，适合复杂项目分析
+  - `qwen`: Gemini 的替代方案，具有相似能力
+
+**执行流程**:
+
+```mermaid
+graph TD
+    A[开始] --> B[分析项目结构]
+    B --> C[加载文档]
+    C --> D[提取关键词]
+    D --> E[发现文件]
+    E --> F[CLI 深度分析]
+    F --> G[生成内容包]
+    G --> H[加载到主线程记忆]
+```
+
+**代理调用提示**:
+```
+## Mission: Prepare Project Memory Context
+
+**Task**: Prepare project memory context for: "{task_description}"
+**Mode**: analysis
+**Tool Preference**: {tool}
+
+### Step 1: Foundation Analysis
+1. Project Structure: get_modules_by_depth.sh
+2. Core Documentation: CLAUDE.md, README.md
+
+### Step 2: Keyword Extraction & File Discovery
+1. Extract core keywords from task description
+2. Discover relevant files using ripgrep and find
+
+### Step 3: Deep Analysis via CLI
+Execute Gemini/Qwen CLI for deep analysis
+
+### Step 4: Generate Core Content Package
+Return structured JSON with required fields
+
+### Step 5: Return Content Package
+Load JSON into main thread memory
+```
+
+**示例**:
+
+```bash
+# 基础用法
+/memory:prepare "在当前前端基础上开发用户认证功能"
+
+# 指定工具
+/memory:prepare --tool qwen "重构支付模块API"
+
+# Bug 修复上下文
+/memory:prepare "修复登录验证错误"
+```
+
+**返回的内容包**:
+
+```json
+{
+  "task_context": "在当前前端基础上开发用户认证功能",
+  "keywords": ["前端", "用户", "认证", "auth", "login"],
+  "project_summary": {
+    "architecture": "TypeScript + React 前端，Vite 构建系统",
+    "tech_stack": ["React", "TypeScript", "Vite", "TailwindCSS"],
+    "key_patterns": [
+      "通过 Context API 进行状态管理",
+      "使用 Hooks 的函数组件模式",
+      "API 调用封装在自定义 hooks 中"
+    ]
+  },
+  "relevant_files": [
+    {
+      "path": "src/components/Auth/LoginForm.tsx",
+      "relevance": "现有登录表单组件",
+      "priority": "high"
+    },
+    {
+      "path": "src/contexts/AuthContext.tsx",
+      "relevance": "认证状态管理上下文",
+      "priority": "high"
+    },
+    {
+      "path": "CLAUDE.md",
+      "relevance": "项目开发标准",
+      "priority": "high"
+    }
+  ],
+  "integration_points": [
+    "必须与现有 AuthContext 集成",
+    "遵循组件组织模式: src/components/[Feature]/",
+    "API 调用应使用 src/hooks/useApi.ts 包装器"
+  ],
+  "constraints": [
+    "保持向后兼容",
+    "遵循 TypeScript 严格模式",
+    "使用现有 UI 组件库"
+  ]
+}
+```
+
+## 质量检查清单
+
+生成内容包前验证：
+- [ ] 有效的 JSON 格式
+- [ ] 所有必需字段完整
+- [ ] relevant_files 包含最少 3-10 个文件
+- [ ] project_summary 准确反映架构
+- [ ] integration_points 清晰指定集成路径
+- [ ] keywords 准确提取（3-8 个关键词）
+- [ ] 内容简洁，避免冗余（< 5KB 总计）
+
+## 记忆持久化
+
+- **会话范围**: 内容包在当前会话有效
+- **后续引用**: 所有后续代理/命令都可以访问
+- **重新加载需要**: 新会话需要重新执行 `/memory:prepare`
+
+## 相关文档
+
+- [Memory 命令](../claude/memory.md)
+- [Review 提示](./review.md)
+- [CLI 调用系统](../../features/cli.md)
--- a/docs/zh/commands/codex/review.md
+++ b/docs/zh/commands/codex/review.md
@@ -0,0 +1,197 @@
+# Review 提示
+
+## 一句话定位
+
+**Review 提示是代码审查的标准化模板** — 多维度代码质量检查，确保代码符合最佳实践。
+
+## 审查维度
+
+| 维度 | 检查项 | 严重程度 |
+| --- | --- | --- |
+| **正确性** | 逻辑错误、边界条件、类型安全 | Critical |
+| **安全性** | 注入漏洞、认证、输入验证 | Critical |
+| **性能** | 算法复杂度、N+1 查询、缓存机会 | High |
+| **可维护性** | SOLID 原则、代码重复、命名规范 | Medium |
+| **文档** | 注释完整性、README 更新 | Low |
+
+## codex-review
+
+**功能**: 使用 Codex CLI 通过 ccw 端点进行交互式代码审查，支持可配置的审查目标、模型和自定义指令。
+
+**语法**:
+```
+/cli:codex-review [--uncommitted|--base <分支>|--commit <sha>] [--model <模型>] [--title <标题>] [提示]
+```
+
+**参数**:
+- `--uncommitted`: 审查已暂存、未暂存和未跟踪的更改
+- `--base <分支>`: 与基础分支比较更改
+- `--commit <sha>`: 审查特定提交引入的更改
+- `--model <模型>`: 覆盖默认模型（gpt-5.2, o3, gpt-4.1, o4-mini）
+- `--title <标题>`: 审查摘要的可选提交标题
+
+**注意**: 目标标志和提示互斥（见约束部分）
+
+### 审查焦点选择
+
+| 焦点 | 模板 | 关键检查 |
+| --- | --- | --- |
+| **综合审查** | 通用模板 | 正确性、风格、Bug、文档 |
+| **安全焦点** | 安全模板 | 注入、认证、验证、暴露 |
+| **性能焦点** | 性能模板 | 复杂度、内存、查询、缓存 |
+| **代码质量** | 质量模板 | SOLID、重复、命名、测试 |
+
+### 提示模板
+
+#### 综合审查模板
+
+```
+PURPOSE: 综合代码审查以识别问题、改进质量并确保最佳实践；成功 = 可操作的反馈和清晰的优先级
+TASK: • 审查代码正确性和逻辑错误 • 检查编码标准和一致性 • 识别潜在 Bug 和边界情况 • 评估文档完整性
+MODE: review
+CONTEXT: {目标描述} | Memory: 来自 CLAUDE.md 的项目约定
+EXPECTED: 结构化审查报告，包含：严重程度级别（Critical/High/Medium/Low）、file:line 引用、具体改进建议、优先级排名
+CONSTRAINTS: 关注可操作的反馈
+```
+
+#### 安全焦点模板
+
+```
+PURPOSE: 安全焦点代码审查以识别漏洞和安全风险；成功 = 所有安全问题记录有修复方案
+TASK: • 扫描注入漏洞（SQL、XSS、命令） • 检查认证和授权逻辑 • 评估输入验证和清理 • 识别敏感数据暴露风险
+MODE: review
+CONTEXT: {目标描述} | Memory: 安全最佳实践、OWASP Top 10
+EXPECTED: 安全报告，包含：漏洞分类、适用的 CVE 引用、修复代码片段、风险严重程度矩阵
+CONSTRAINTS: 安全优先分析 | 标记所有潜在漏洞
+```
+
+#### 性能焦点模板
+
+```
+PURPOSE: 性能焦点代码审查以识别瓶颈和优化机会；成功 = 可衡量的改进建议
+TASK: • 分析算法复杂度（Big-O） • 识别内存分配问题 • 检查 N+1 查询和阻塞操作 • 评估缓存机会
+MODE: review
+CONTEXT: {目标描述} | Memory: 性能模式和反模式
+EXPECTED: 性能报告，包含：复杂度分析、瓶颈识别、优化建议及预期影响、基准建议
+CONSTRAINTS: 性能优化焦点
+```
+
+#### 代码质量模板
+
+```
+PURPOSE: 代码质量审查以改进可维护性和可读性；成功 = 更清晰、更易维护的代码
+TASK: • 评估 SOLID 原则遵守情况 • 识别代码重复和抽象机会 • 审查命名约定和清晰度 • 评估测试覆盖率影响
+MODE: review
+CONTEXT: {目标描述} | Memory: 项目编码标准
+EXPECTED: 质量报告，包含：原则违规、重构建议、命名改进、可维护性评分
+CONSTRAINTS: 代码质量和可维护性焦点
+```
+
+### 使用示例
+
+#### 直接执行（无交互）
+
+```bash
+# 使用默认设置审查未提交的更改
+/cli:codex-review --uncommitted
+
+# 与主分支比较
+/cli:codex-review --base main
+
+# 审查特定提交
+/cli:codex-review --commit abc123
+
+# 使用自定义模型
+/cli:codex-review --uncommitted --model o3
+
+# 安全焦点审查
+/cli:codex-review --uncommitted security
+
+# 完整选项
+/cli:codex-review --base main --model o3 --title "认证功能" security
+```
+
+#### 交互模式
+
+```bash
+# 启动交互式选择（引导流程）
+/cli:codex-review
+```
+
+### 约束和验证
+
+**重要**: 目标标志和提示互斥
+
+Codex CLI 有一个约束，目标标志（`--uncommitted`, `--base`, `--commit`）不能与位置 `[PROMPT]` 参数一起使用：
+
+```
+error: the argument '--uncommitted' cannot be used with '[PROMPT]'
+error: the argument '--base <BRANCH>' cannot be used with '[PROMPT]'
+error: the argument '--commit <SHA>' cannot be used with '[PROMPT]'
+```
+
+**有效组合**:
+
+| 命令 | 结果 |
+| --- | --- |
+| `codex review "关注安全"` | ✓ 自定义提示，审查未提交（默认） |
+| `codex review --uncommitted` | ✓ 无提示，使用默认审查 |
+| `codex review --base main` | ✓ 无提示，使用默认审查 |
+| `codex review --commit abc123` | ✓ 无提示，使用默认审查 |
+| `codex review --uncommitted "提示"` | ✗ 无效 - 互斥 |
+| `codex review --base main "提示"` | ✗ 无效 - 互斥 |
+| `codex review --commit abc123 "提示"` | ✗ 无效 - 互斥 |
+
+**有效示例**:
+```bash
+# ✓ 有效: 仅提示（默认审查未提交）
+ccw cli -p "关注安全" --tool codex --mode review
+
+# ✓ 有效: 仅目标标志（无提示）
+ccw cli --tool codex --mode review --uncommitted
+ccw cli --tool codex --mode review --base main
+ccw cli --tool codex --mode review --commit abc123
+
+# ✗ 无效: 目标标志带提示（会失败）
+ccw cli -p "审查这个" --tool codex --mode review --uncommitted
+```
+
+## 焦点区域映射
+
+| 用户选择 | 提示焦点 | 关键检查 |
+| --- | --- | --- |
+| 综合审查 | 全面 | 正确性、风格、Bug、文档 |
+| 安全焦点 | 安全优先 | 注入、认证、验证、暴露 |
+| 性能焦点 | 优化 | 复杂度、内存、查询、缓存 |
+| 代码质量 | 可维护性 | SOLID、重复、命名、测试 |
+
+## 错误处理
+
+### 无更改可审查
+
+```
+未找到审查目标的更改。建议：
+- 对于 --uncommitted: 先进行一些代码更改
+- 对于 --base: 确保分支存在并有分歧
+- 对于 --commit: 验证提交 SHA 存在
+```
+
+### 无效分支
+
+```bash
+# 显示可用分支
+git branch -a --list | head -20
+```
+
+### 无效提交
+
+```bash
+# 显示最近提交
+git log --oneline -10
+```
+
+## 相关文档
+
+- [Prep 提示](./prep.md)
+- [CLI 工具命令](../claude/cli.md)
+- [代码审查](../../features/)
--- a/docs/zh/commands/index.md
+++ b/docs/zh/commands/index.md
@@ -0,0 +1,34 @@
+# Commands Overview
+
+## 一句话定位
+
+**Commands 是 Claude_dms3 的命令系统** — 包含 Claude Code Commands 和 Codex Prompts 两大类别，提供从规范到实现到测试到审查的完整命令行工具链。
+
+## 命令分类
+
+| 类别 | 说明 | 路径 |
+|------|------|------|
+| **Claude Commands** | Claude Code 扩展命令 | `/commands/claude/` |
+| **Codex Prompts** | Codex CLI 提示词 | `/commands/codex/` |
+
+## 快速导航
+
+### Claude Commands
+
+- [核心编排](/commands/claude/) - ccw, ccw-coordinator
+- [工作流](/commands/claude/workflow) - workflow 系列命令
+- [会话管理](/commands/claude/session) - session 系列命令
+- [Issue](/commands/claude/issue) - issue 系列命令
+- [Memory](/commands/claude/memory) - memory 系列命令
+- [CLI](/commands/claude/cli) - cli 系列命令
+- [UI 设计](/commands/claude/ui-design) - ui-design 系列命令
+
+### Codex Prompts
+
+- [Prep](/commands/codex/prep) - prep-cycle, prep-plan
+- [Review](/commands/codex/review) - review 提示
+
+## 相关文档
+
+- [Skills](/skills/) - 技能系统
+- [Features](/features/spec) - 核心功能