@modus-ai/modus 0.2.6 → 0.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modus-ai/modus",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Modus — Business-grounded AI coding accelerator for CodeBuddy IDE",
   "keywords": [
     "ai",

package/templates/commands/harness.md

@@ -12,6 +12,9 @@
   --help                    显示完整帮助（中文）
   --project <name>          指定项目（多项目 workspace 使用）
   --story <tapd-url>        与直接传 URL 等价（alias）
+  --domain <names>          预设业务域（逗号分隔），跳过域确认交互
+  --from-plan <name>        从已批准的 plan.md 接力，跳过 SA01（需求分析）和 SA02（设计方案），
+                            直接从 SA03 代码开发开始（★ 新增，配合 /modus:plan --continue 使用）
   --skip <agents>           跳过指定 SubAgent（逗号分隔，如 "04-perf,05-security"）
   --loop1-only              仅执行 Loop 1，不触发 Loop 2 自动修复
   --resume                  从最后完成的 SubAgent 断点继续
@@ -20,6 +23,9 @@
   --no-deploy               跳过 07-deploy SubAgent（仅交付到 pre 环境）
   --max-loop2 <n>           Loop 2 最大重入次数（默认 3，填 0 禁用 Loop 2）
   --notify <channel>        完成后通知渠道（wework|dingtalk|slack）
+  --show-progress           实时输出结构化进度事件到 modus/sessions/events.jsonl（★ 新增）
+  --force                   跳过所有人工确认节点（Codex 平台自动开启）
+  --verbose                 输出 SubAgent 详细执行日志
 ```
 
 ## 使用示例
@@ -31,6 +37,9 @@
 /modus:harness https://tapd.cn/.../1234 --loop1-only
 /modus:harness https://tapd.cn/.../1234 --resume
 /modus:harness https://tapd.cn/.../1234 --max-loop2 0 --no-deploy
+/modus:harness --from-plan my-feature                      # 从技术评审接力（★ 新增）
+/modus:harness https://tapd.cn/.../1234 --show-progress    # 实时进度事件（★ 新增）
+/modus:harness https://tapd.cn/.../1234 --force            # Codex 无人值守模式
 ```
 
 **Step Final:** SubAgent 00 (Mode D) — ARCHIVE knowledge extraction

package/templates/commands/plan.md

@@ -12,7 +12,10 @@
   --help                    显示完整帮助（中文）
   --story <tapd-url>        关联 TAPD Story（自动填写背景，写入 HANDOFF story_id）
   --project <name>          指定项目（多项目 workspace 使用）
-  --design                  仅生成技术评估文档（design.md），不生成 tasks（技术方案评审场景）
+  --design                  设计评审模式：只生成技术评审文档（plan.md），status=pending_review，
+                            不触发代码生成（★ 适合复杂需求在开发前做技术评审）
+  --continue <name>         接力模式：读取已批准的 plan.md，自动触发
+                            /modus:harness --from-plan <name>（跳过 SA01+SA02）（★ 新增）
   --quick                   跳过澄清 3 问，直接生成 plan（适合简单任务）
   --enhance                 生成 plan 前强制刷新相关 Skill（hash 检查）
   --no-build                归档模式：生成 plan.md 但不触发 Build 确认循环
@@ -27,11 +30,27 @@
 /modus:plan 需要支持歌曲批量导出为 Excel
 /modus:plan --story https://tapd.cn/.../stories/view/123 新增艺人等级评定功能
 /modus:plan --design 评估版权对账系统的重构方案
+/modus:plan --design --story https://tapd.cn/.../123456   # 设计评审模式（★ 新增）
+/modus:plan --continue my-feature                         # 评审通过，接力 harness 开发（★ 新增）
 /modus:plan --quick 修复版权审核列表分页 bug
 /modus:plan --read-only 分析中央曲库同步的架构方案
 /modus:plan --resume batch-export 继续上次中断的规划
 ```
 
+## 设计评审 → 代码开发 完整链路
+
+```
+/modus:plan --design [story-url]
+  ↓
+生成 plan.md（status: pending_review，不触发代码生成）
+  ↓ 人工评审通过后
+/modus:plan --continue {name}
+  ↓ 自动调用
+/modus:harness --from-plan {name}（跳过 SA01 需求分析 + SA02 设计方案）
+  ↓
+直接从 SA03 代码开发开始
+```
+
 ## 执行流程概览
 
 ```

package/templates/commands/upgrade.md

@@ -33,6 +33,7 @@
 
 | 版本 | 主要变更 |
 |------|---------|
+| v4.0.0 | plan --design 设计评审节点；plan --continue + harness --from-plan 接力机制；HANDOFF protocol schema v1.3（plan 专用字段）；Progress Event Protocol（events.jsonl）；AGENTS.md 自动生成（modus update 驱动，不再手动维护） |
 | v3.2.0 | 跨 Skill 路径全面统一到 `modus/knowledge/biz-*/`；步骤编号规范化（禁止小数步骤）；modus-analyst 产出路径更正到 `modus/stories/{id}/harness/`；modus-plan 双路径产出规则（Story 模式 vs 独立模式） |
 | v3.1.0 | 知识库路径迁移：`.codebuddy/skills/modus-biz-*` → `modus/knowledge/biz-*`；新增工作区顶层路由 `modus/workspace-catalog.md`；HANDOFF 协议升级到 schema v1.1 |
 | v3.0.0 | 多项目工作区支持（modus-workspace.yaml）；引用式适配（不复制知识） |
@@ -49,6 +50,65 @@
 ⑥ 输出迁移完成报告
 ```
 
+## v3.x → v4.0 迁移详细步骤
+
+运行 `/modus:upgrade --target 4.0.0` 时自动执行以下步骤：
+
+```
+Step 1: 备份
+  创建 modus/backup/{YYYYMMDD}-v3.x/ 目录
+  复制所有现有 Skill 文件和 config.yaml 到备份目录
+
+Step 2: HANDOFF 格式兼容检查
+  扫描 modus/stories/*/harness/*.md 中的旧版 HTML 注释块（<!--HANDOFF...-->）
+  自动转换为 YAML frontmatter 格式（schema v1.1 → v1.2/v1.3）
+  输出：「已迁移 N 个产物文件到 YAML frontmatter 格式」
+
+Step 3: plan 产物字段补全
+  扫描 modus/plans/*/plan.md
+  在 HANDOFF frontmatter 中补充新字段（design_mode/status/continue_token/risk_level/estimated_effort）
+  默认值：design_mode=false, status=complete, continue_token=""
+
+Step 4: harness 命令 Skill 更新
+  更新 modus-harness Skill：添加 --from-plan 处理逻辑
+  更新 modus-plan Skill：添加 --design 分支 + --continue 接力逻辑
+  输出：「已更新 modus-harness / modus-plan Skill 模板」
+
+Step 5: 初始化进度事件目录
+  创建 modus/sessions/ 目录（若不存在）
+  创建 modus/sessions/events.jsonl（若不存在，初始化为空文件）
+  输出：「已初始化 Progress Event 日志：modus/sessions/events.jsonl」
+
+Step 6: AGENTS.md 自动生成（Codex 平台）
+  若 config.yaml platforms 含 codex，重新生成 AGENTS.md：
+  融合：workspace-catalog + constitution.hard_rules + 最新命令参数集
+  输出：「AGENTS.md 已重新生成（Codex 平台适配）」
+
+Step 7: 更新 modus/config.yaml
+  将 modus_version 更新为 "4.0.0"
+  输出迁移完成报告
+```
+
+**迁移完成报告示例：**
+
+```
+✅ Modus v4.0.0 升级完成
+
+迁移内容：
+  ✓ HANDOFF 格式：N 个产物文件已转换为 YAML frontmatter
+  ✓ plan 产物：M 个 plan.md 已补充 v4.0 专用字段
+  ✓ Skill 更新：modus-harness / modus-plan 已更新
+  ✓ 进度事件：modus/sessions/events.jsonl 已初始化
+  ✓ AGENTS.md：已重新生成（若 codex 已启用）
+
+备份位置：modus/backup/{YYYYMMDD}-v3.x/
+
+新功能使用方式：
+  设计评审模式：/modus:plan --design [story-url]
+  接力开发：   /modus:plan --continue {name}
+  进度监控：   /modus:harness ... --show-progress
+```
+
 ## 执行此命令
 
 读取并执行 `.codebuddy/skills/modus-upgrade/SKILL.md` 中的完整流程。

package/templates/skills/modus-harness/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: modus-harness
-description: Use this skill when executing /modus:harness command to run the full dual-loop multi-agent Harness from requirements analysis to deployment. Acts as the orchestrator coordinating SubAgents 00-07. Trigger on /modus:harness command or when user provides a TAPD Story URL and wants automated end-to-end delivery.
+description: Use this skill when executing /modus:harness command to run the full dual-loop multi-agent Harness from requirements analysis to deployment. Acts as the orchestrator coordinating SubAgents 00-07. Trigger on /modus:harness command or when user provides a TAPD Story URL and wants automated end-to-end delivery. Also handles --from-plan relay (skip SA01+SA02, read plan.md as dev input) and --show-progress (write events.jsonl).
 allowed-tools: Read, Write, Glob, Bash, Task
 disable: false
 ---
@@ -61,6 +61,67 @@ Orchestrator 每步只需读 HANDOFF 块（≤ 20 行），而非整份 MD 文
 
 ---
 
+## 参数解析（优先执行，Step 1 之前）
+
+**首先**检测用户输入中的参数标志，设置后续行为开关：
+
+```
+--help           → 输出帮助文档，结束执行
+--from-plan X    → FROM_PLAN_MODE=true，PLAN_NAME=X（进入 from-plan 接力路径，见下方）
+--show-progress  → SHOW_PROGRESS=true（每个关键节点写入 events.jsonl）
+--domain X       → FORCED_DOMAINS=X（逗号分隔，跳过域确认交互）
+--skip X         → SKIP_AGENTS=X（逗号分隔的 SubAgent ID）
+--loop1-only     → LOOP1_ONLY=true
+--resume         → RESUME=true
+--dry-run        → DRY_RUN=true
+--force          → FORCE=true（跳过人工确认，Codex 平台自动开启）
+--no-deploy      → NO_DEPLOY=true
+--max-loop2 N    → MAX_LOOP2=N（默认 3）
+--verbose        → VERBOSE=true
+--project X      → PROJECT=X
+```
+
+**FROM_PLAN 接力路径（--from-plan 时，替代 Step 2 的标准澄清流程）：**
+
+```
+Step P1：读取 plan.md
+  路径：modus/plans/{PLAN_NAME}/plan.md
+  读取 HANDOFF frontmatter 验证：
+    → design_mode = true 且 status ∈ {approved, continued}
+    → 若 status = pending_review：
+        提示「plan 尚未批准（status=pending_review），请先完成技术评审后再 --continue」
+        输出「如需强制继续，运行：/modus:harness --from-plan {name} --force」
+        若 FORCE=false：结束执行
+  提取关键内容：
+    → domains：传给知识注入（SA00）
+    → story_id：用于工作目录路径（若 plan.md 有 story_id）
+    → 「实现 Todos」章节 → 作为 SA03 的代码开发计划（替代 01-analysis + 02-design Sprint 拆分）
+    → 「技术方案评审 → 推荐方案」→ 作为 SA03 的架构决策参考
+    → 「已知风险」→ 传递给 SA07 代码评审作为审查重点
+    → continue_token：记录到工作目录 .harness-state.yaml
+
+Step P2：初始化工作目录
+  若 plan.md 含 story_id：工作目录 = modus/stories/{story_id}/harness/
+  若无 story_id：工作目录 = modus/plans/{PLAN_NAME}/harness/
+
+Step P3：输出接力摘要
+  🚀 从 plan --from-plan 接力启动
+     plan：modus/plans/{PLAN_NAME}/plan.md
+     continue_token：{token}
+     跳过：SA01（需求分析）+ SA02（设计方案）
+     直接执行：SA00（知识注入）→ SA03（代码开发）→ SA04/05/06（并行审计）→ SA07（评审）→ SA08（部署）
+
+Step P4：设置 SKIP_AGENTS = ["01", "02"]（强制跳过 SA01 + SA02）
+  并将 plan.md 的「实现 Todos」封装为 FROM_PLAN_CONTEXT，注入 SA03 执行时的任务描述
+
+写入进度事件（若 SHOW_PROGRESS=true）：
+  {"ts":"...","type":"plan_relay","plan_name":"{PLAN_NAME}","continue_token":"{token}","skipped_stages":["01-analysis","02-design"]}
+
+完成后进入标准 Step 1（项目宪法 + 前置检查），跳过 Step 2（澄清意图）。
+```
+
+---
+
 ## 执行流程
 
 ### Step 1：项目宪法 + 前置检查
@@ -158,11 +219,20 @@ last_updated: "{ISO 8601 时间戳}"
 
 将 Skill 内容（已加载的完整 SKILL.md）和 constitution.hard_rules 一起传递给 SubAgent 01 作为背景知识。
 
+**FROM_PLAN_MODE 特殊处理：**
+
+若 FROM_PLAN_MODE=true，在输出启动摘要时补充 plan 上下文说明：
+
 ```
-[Harness Orchestrator 启动]
-Story: {id} | 工作目录: modus/stories/{id}/harness/
-知识注入: order[verified→已更新] | payment[proven→已读取] | user[新建 draft]
-Constitution: {N} 条硬性规则已加载
+[Harness Orchestrator 启动 — plan 接力模式]
+plan：modus/plans/{PLAN_NAME}/plan.md（continue_token: {token}）
+工作目录: {工作目录}
+跳过: SA01（需求分析）→ SA02（设计方案）
+知识注入: {domains}[...] | Constitution: {N} 条硬性规则已加载
+
+📋 SA03 将读取 plan.md 中的「实现 Todos」作为代码开发输入：
+   {plan.md 中 Todos 章节前 3 条预览}
+   ...（共 N 条 Todo）
 ```
 
 ---
@@ -313,17 +383,27 @@ feat: {业务摘要}
 
 ## 调度 CoT（每次行动前循环执行）
 
-1. 扫描 `modus/stories/{story-id}/harness/` 目录，列出已有 HANDOFF frontmatter
+1. 扫描工作目录，列出已有 HANDOFF frontmatter
 2. 只需读各文件的 HANDOFF frontmatter（≤ 20 行），对照串行顺序确定当前阶段
 3. 检查当前阶段的 Gate 条件是否满足（优先读 HANDOFF，必要时读全文）。**每个 Gate 仅在对应 SubAgent 完成后单独执行，互相独立，不同时触发**：
-   - Gate A0：**当 SubAgent 01 写入 `01-analysis.md` 后**，检查该文件 HANDOFF 块的 `gate_status` 字段，确保 = "passed"（需求分析质量门，独立于 Gate A0.5）
-   - Gate A0.5：**当 SubAgent 02 写入 `02-design-brief.md` 后**，检查 `gate_status ∈ {passed, warning}`；`failed` 时重入 SubAgent 02，最多 2 次
+   - Gate A0：**当 SubAgent 01 写入 `01-analysis.md` 后**，检查该文件 HANDOFF 块的 `gate_status` 字段，确保 = "passed"（需求分析质量门，独立于 Gate A0.5）。**FROM_PLAN_MODE 时跳过此 Gate**（SA01 已跳过）
+   - Gate A0.5：**当 SubAgent 02 写入 `02-design-brief.md` 后**，检查 `gate_status ∈ {passed, warning}`；`failed` 时重入 SubAgent 02，最多 2 次。**FROM_PLAN_MODE 时跳过此 Gate**（SA02 已跳过）
    - Gate A：执行 `constitution.build_command`（如 `mvn clean compile -q -DskipTests`），检查 exit code = 0；失败时重入 SubAgent 03，最多 3 次
    - Gate B：扫描 harness/ 目录，检查 `04-test-report.md`、`05-perf-report.md`、`06-security-report.md` 的 HANDOFF `artifact_status` 均为 `complete`；各报告 `gate_status ≠ "failed"`；06（安全审计）有严重/高危则强制拦截；超时（30 分钟）上报用户
    - Gate C：读 `cr-report.md` HANDOFF，检查 `issues` 数组为空或全为 P3；有 P1/P2 时从 `issues[].affected_sprint` 定位受影响 Sprint，触发 Loop 2 精准重入 SubAgent 03
 4. Gate 通过 → 调用下一个 SubAgent 的 Skill（传递 constitution + 相关 Skill 内容）
-   - 调用 SubAgent 03 时，必须同时传入 `02-design-brief.md` 内容
+   - 调用 SubAgent 03 时：
+     - **标准模式**：必须同时传入 `02-design-brief.md` 内容
+     - **FROM_PLAN_MODE**：传入 plan.md 的「实现 Todos」+ 「推荐方案」作为等价输入，代替 02-design-brief.md
 5. Gate 失败 → 按规则处理（重入/上报）
 6. 输出本轮进度卡片
 7. 若 SubAgent 08 完成且 `08-deploy-status.md` HANDOFF `artifact_status = complete` → 触发 ARCHIVE 知识提取（SubAgent 00 模式 D），进入 Step 4
-8. 等待 SubAgent 写入产出物，重复步骤 1
+8. **进度事件写入（SHOW_PROGRESS=true 时，在步骤 4/5/7 后各执行一次）：**
+   向 `modus/sessions/events.jsonl` 追加事件（JSON Lines 格式，见 `modus/docs/protocol.md §七`）：
+   - SubAgent 开始执行前：写入 `stage_start` 事件
+   - SubAgent 完成后：写入 `stage_done` 事件
+   - Gate 检查完成后：写入 `gate` 事件
+   - Gate A 编译检查后：写入 `compile` 事件
+   - Loop 2 触发时：写入 `loop2_start` 事件
+   - 全流程完成时：写入 `harness_done` 事件
+9. 等待 SubAgent 写入产出物，重复步骤 1

package/templates/skills/modus-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: modus-plan
-description: Use this skill when executing /modus:plan command to generate a single structured plan.md backed by up-to-date business Skills. Trigger on /modus:plan command or when user wants to plan a feature with full business context. Loads Skill domains first, falls back to platform rules + source scan, then asks 0-3 targeted questions (no padding — only ask when truly needed) before generating the plan. Ends with a Build confirmation loop where user can iterate on plan.md before executing code generation.
+description: Use this skill when executing /modus:plan command to generate a single structured plan.md backed by up-to-date business Skills. Trigger on /modus:plan command or when user wants to plan a feature with full business context. Loads Skill domains first, falls back to platform rules + source scan, then asks 0-3 targeted questions (no padding — only ask when truly needed) before generating the plan. Ends with a Build confirmation loop where user can iterate on plan.md before executing code generation. Also handles --design mode (design-review-only, no code gen) and --continue mode (relay plan.md to harness).
 allowed-tools: Read, Write, Glob, Bash
 disable: false
 ---
@@ -13,6 +13,41 @@ disable: false
 
 功能规划入口。通过**两层知识检索**获取业务上下文，先评估需求复杂度自动分级（simple/medium/complex），再基于加载的知识向用户提出 0–3 个精准澄清问题（按需提问，禁止凑数），最终生成单一 `plan.md` 规划文档。文档生成后进入 Build 确认循环，用户可反复修改直至满意后触发代码执行，并将本次规划中的新知识回写到 Skill（后置更新）。
 
+支持两种特殊模式（v4.0 新增）：
+- **`--design` 设计评审模式**：仅生成技术评审文档，`status: pending_review`，不触发代码生成
+- **`--continue <name>` 接力模式**：读取已批准的 plan.md，直接接力触发 `harness --from-plan`
+
+---
+
+## 参数解析（优先执行，Step 0 之前）
+
+**首先**检测用户输入中的参数标志，决定执行路径：
+
+```
+--help        → 输出帮助文档，结束执行
+--design      → DESIGN_MODE=true（进入设计评审分支，见「Design Mode 流程」）
+--continue X  → CONTINUE_MODE=true，PLAN_NAME=X（进入接力分支，见「Continue 流程」）
+--quick       → QUICK_MODE=true（跳过域确认和澄清问题）
+--story X     → STORY_ID=X（关联 TAPD Story）
+--project X   → PROJECT=X（多项目指定）
+--enhance X   → ENHANCE_DOMAIN=X（前置强制刷新指定域 Skill）
+--no-build    → NO_BUILD=true（生成 plan.md 后跳过 Build 循环）
+--read-only   → READ_ONLY=true（同 NO_BUILD，永远不触发代码生成）
+--resume X    → RESUME_NAME=X（断点续跑）
+--complexity X → FORCED_COMPLEXITY=X
+```
+
+**路由决策树：**
+
+```
+检测到 --continue X？
+  是 → 跳转到「Continue 流程」（完整独立流程，不执行 Step 0-9）
+
+检测到 --design？
+  是 → 执行 Step 0→Step 1→Step 2→Step 3→Step 4→Step 5→Step 6→Design Mode Step 7（生成 plan.md 后暂停）
+  否 → 执行标准流程（Step 0 → Step 9）
+```
+
 ---
 
 ## 执行流程
@@ -348,6 +383,89 @@ created: {ISO8601时间戳}
 
 ---
 
+### Step 7（Design Mode 分支）：设计评审模式产出 ⏸️ 【人工审批节点】
+
+> **仅在 DESIGN_MODE=true 时执行此分支，替代标准 Step 8（Build 循环）。**
+
+**生成额外的技术评审内容：**
+
+在标准 plan.md 基础上，追加以下章节（design mode 专属）：
+
+```markdown
+## 技术方案评审
+
+### 需求解读（5W1H）
+| 维度 | 内容 |
+|------|------|
+| Who | {谁发起/谁受益} |
+| What | {要做什么} |
+| Why | {业务价值/驱动因素} |
+| When | {预期上线时间/Sprint} |
+| Where | {涉及系统/服务范围} |
+| How | {核心实现思路} |
+
+### 技术方案对比（3 个候选方案）
+
+| | 方案 A（推荐） | 方案 B | 方案 C |
+|---|---|---|---|
+| 实现思路 | ... | ... | ... |
+| 优点 | ... | ... | ... |
+| 缺点/风险 | ... | ... | ... |
+| 实现成本 | ... | ... | ... |
+
+**推荐方案：方案 A**
+理由：{1-2 句话}
+
+### 影响范围（方法级）
+| 文件 | 类/方法 | 变更类型 | 影响说明 |
+|------|--------|---------|---------|
+| {路径} | {类名.方法名} | 新增/修改/删除 | {说明} |
+
+### API 契约草稿
+{若有接口新增/修改，列出方法签名}
+
+### 技术风险点
+| 风险 | 等级 | 应对方案 |
+|------|------|---------|
+| {风险描述} | P1/P2 | {方案} |
+
+### 估时
+- 预估工作量：{XS/S/M/L/XL}（{N 个工作日}）
+- 主要耗时点：{1-2 句话}
+```
+
+**写入 HANDOFF frontmatter（design mode 专用字段）：**
+
+```yaml
+---
+schema_version: "1.2"
+agent: "plan"
+design_mode: true
+status: "pending_review"
+risk_level: "{low|medium|high}"
+estimated_effort: "{XS|S|M|L|XL}"
+continue_token: ""
+---
+```
+
+**输出并暂停：**
+
+```
+✅ 技术评审文档已生成：modus/plans/{name}/plan.md
+   设计模式：ON | 状态：pending_review | 风险：{level} | 估时：{effort}
+
+──────────────────────────────────────────
+📋 评审文档包含：需求解读 / 3 个候选方案 / 影响范围 / API 草稿 / 风险点 / 估时
+
+⏸️ 等待人工技术评审。评审通过后运行：
+   /modus:plan --continue {name}
+──────────────────────────────────────────
+```
+
+⏸️ **等待人工确认** — 此时**不触发任何代码生成**，整个 Design Mode 流程到此结束。
+
+---
+
 ### Step 8：Build 确认循环 ⏸️ 【人工审批节点】
 
 plan.md 生成后，展示结果并进入确认循环：
@@ -474,3 +592,92 @@ modus/
 │           ├── .modus-state.yaml    ← status: archived
 │           └── plan.md
 ```
+
+---
+
+## Continue 流程（--continue 模式，独立完整流程）
+
+> **触发条件：** 用户运行 `/modus:plan --continue <name>` 时进入此流程。
+
+### Continue Step 1：读取 plan.md 并验证状态
+
+```
+读取 modus/plans/{name}/plan.md 的 HANDOFF frontmatter：
+  → 检查 design_mode = true（不是 design 模式的 plan 不能用 --continue）
+  → 检查 status ∈ {pending_review, approved}（已完成或已 continued 的不重复触发）
+  → 若 status = continued：提示「此 plan 已接力，是否重新触发？[y/N]」
+
+若 plan.md 不存在 → 报错：
+  ❌ 未找到 plan：modus/plans/{name}/plan.md
+     请先运行 /modus:plan --design 生成技术评审文档
+```
+
+### Continue Step 2：展示接力确认
+
+```
+准备接力 harness：
+
+📋 plan：{name}
+   状态：{pending_review → 即将变更为 approved}
+   业务域：{domains}
+   风险等级：{risk_level}
+   估时：{estimated_effort}
+
+⚡ 接力后将跳过：SA01（需求分析）+ SA02（设计方案）
+   直接从：SA03 代码开发 开始
+
+SA03 将读取 plan.md 中的「实现 Todos」作为代码开发计划。
+是否确认接力？[Y/n]（--force 时自动确认）
+```
+
+### Continue Step 3：生成 continue_token 并更新状态
+
+```
+生成 continue_token：{name}:{YYYYMMDD}
+更新 plan.md frontmatter：
+  status: "approved" → 写入后立即变更为 "continued"
+  continue_token: "{name}:{YYYYMMDD}"
+
+写入 .modus-state.yaml：
+  status: continued
+  continued_at: {ISO8601 时间戳}
+  harness_triggered: true
+```
+
+### Continue Step 4：接力触发 harness
+
+输出启动提示：
+
+```
+🚀 plan --continue 接力启动
+   规划文件：modus/plans/{name}/plan.md
+   传递标记：[FROM_PLAN: {name} | token: {continue_token}]
+   跳过阶段：SA01（需求分析）+ SA02（设计方案）
+   直接启动：SA03 代码开发
+
+启动 /modus:harness --from-plan {name}...
+```
+
+以如下格式构造 harness 的入参（在**当前上下文中**直接继续执行 modus-harness Skill）：
+
+```
+/modus:harness --from-plan {name}
+
+传递上下文：
+  plan_file: modus/plans/{name}/plan.md
+  continue_token: {token}
+  domains: {plan.md 中的 domains}
+  constitution: {当前 config.yaml constitution}
+  skip_agents: ["01", "02"]
+```
+
+`modus-harness` Skill 检测到 `--from-plan` 时，读取 plan.md 中的以下内容作为 SA03 的输入：
+- 「实现 Todos」→ 作为代码开发计划（替代 01-analysis.md + 02-design-brief.md 中的 Sprint 拆分）
+- 「技术方案评审 → 推荐方案」→ 作为架构决策（替代 SA02 的设计方案）
+- 「已知风险」→ 传递给 SA07（代码评审）作为审查重点
+
+### Continue Step 5：写入进度事件（若 events.jsonl 存在）
+
+```json
+{"ts":"{ISO8601}","type":"plan_relay","plan_name":"{name}","continue_token":"{token}","skipped_stages":["01-analysis","02-design"]}
+```