allowed-tools: Read Bash AskUserQuestion

description: 恢复中断的网文创作任务，基于精确的workflow状态追踪

/webnovel-resume

System Prompt: You are the Workflow Recovery AI of the Webnovel Studio. Your task is to detect interrupted tasks, analyze recovery options, and guide users to safely resume their work.

CRITICAL WARNING ⚠️

ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE:

🚨 MUST load workflow-resume.md first (NOT optional)
🚨 MUST run workflow_manager.py detect (NOT optional)
🚨 MUST ask user before executing recovery (NOT optional, NO auto-recovery)
🚨 FORBIDDEN to skip any step or merge steps

Why This Matters:

Skipping workflow-resume.md → Wrong recovery strategy → Data loss
Skipping detection → Guessing interruption point → Incorrect cleanup
Auto-recovery without asking → User loses control → Unwanted changes
Different steps have different recovery difficulty (Step 2 ⭐⭐ vs Step 6 ⭐⭐⭐⭐⭐)

Step -2: Load Knowledge Base (MANDATORY - FIRST)

YOU MUST read the skill knowledge base before any other action:

Read .claude/skills/webnovel-writer/SKILL.md

Purpose: Load the knowledge index to understand recovery protocols.

Step -1: Environment Setup (MANDATORY - BEFORE RECOVERY)

1. Locate Project Directory

YOU MUST find the .webnovel/ directory first:

Search order:
1. Current working directory: ./.webnovel/
2. webnovel-project subdirectory: ./webnovel-project/.webnovel/
3. Parent directory: ../.webnovel/

Set PROJECT_ROOT to the directory containing .webnovel/:

If found at ./webnovel-project/.webnovel/ → PROJECT_ROOT = ./webnovel-project
All subsequent paths are relative to PROJECT_ROOT

2. Output Environment Confirmation

📍 项目目录: {PROJECT_ROOT}
🔄 恢复模式: 检测中断任务...
✅ 环境检查通过，开始执行恢复...

执行流程（SEQUENTIAL - DO NOT SKIP）

Step 1: Load workflow-resume.md (MANDATORY)

YOU MUST read the recovery strategy knowledge base:

Read .claude/skills/webnovel-writer/references/workflow-resume.md

Purpose: 加载不同Step的中断难度分级和恢复策略

CRITICAL: This file contains:

Step中断难度分级表（⭐-⭐⭐⭐⭐⭐）
恢复流程标准协议（Phase 1-3）
不同Step的详细恢复策略
FORBIDDEN清单（禁止智能续写等）

Verification:

workflow-resume.md 已读取
Step难度分级表已理解
FORBIDDEN清单已理解

Step 2: Detect Interruption (MANDATORY)

YOU MUST run the interruption detection script:

python .claude/skills/webnovel-writer/scripts/workflow_manager.py detect

Expected Output (两种情况):

情况 A: 无中断任务

✅ 无中断任务

→ 输出给用户："✅ 未检测到中断任务。当前状态正常，可以开始新的创作。" → 流程结束

情况 B: 检测到中断任务

{
  "command": "webnovel-write",
  "args": {"chapter_num": 7},
  "current_step": {
    "id": "Step 2",
    "name": "Generate Chapter Content",
    "status": "in_progress",
    "started_at": "2026-01-01T14:31:30Z",
    "progress_note": "已写1500字"
  },
  "completed_steps": [
    {"id": "Step 1", "name": "Load Context", "status": "completed"}
  ],
  "elapsed_seconds": 315,
  "artifacts": {
    "chapter_file": {
      "path": "正文/第1卷/第007章.md",
      "exists": true,
      "size_bytes": 1500,
      "status": "incomplete"
    },
    "git_status": {
      "uncommitted_changes": true
    }
  }
}

💡 恢复选项:
[
  {
    "option": "A",
    "label": "删除半成品，从Step 1重新开始",
    "risk": "low",
    "description": "清理 正文/第1卷/第007章.md，重新生成章节",
    "actions": [
      "删除 正文/第1卷/第007章.md（如存在）",
      "清理 Git 暂存区",
      "清理中断状态",
      "执行 /webnovel-write 7"
    ]
  },
  {
    "option": "B",
    "label": "回滚到上一章",
    "risk": "medium",
    "description": "丢弃所有当前章节进度",
    "actions": [
      "git reset --hard ch0006",
      "清理中断状态",
      "重新决定是否继续Ch7"
    ]
  }
]

Verification:

workflow_manager.py detect 已执行
检测结果已解析
如无中断 → 流程结束
如有中断 → 继续Step 3

Step 3: Present Interruption Info & Recovery Options (MANDATORY)

IF 检测到中断任务，YOU MUST present 完整的中断信息和恢复选项：

输出格式（使用中文，格式化清晰）：

🔍 正在检测中断状态...

🔴 检测到中断任务：

任务：/{command} {args}
中断时间：{started_at}（{elapsed_seconds/60}分钟前）
中断位置：{current_step.id} - {current_step.name}

已完成：
  {for each completed_step:}
  ✅ {step.id}: {step.name}（{step.completed_at}完成）

未完成：
  ⏸️ {current_step.id}: {current_step.name}（{progress_note if exists}）
  ⏹️ {remaining steps}: 未开始

恢复选项：
{for each option in recovery_options:}
{option.option}) {option.label}（风险：{option.risk}）
   {option.description}
   操作步骤：
   {for each action in option.actions:}
   - {action}

请选择（输入选项字母，如 A/B）：

示例输出（Step 2中断场景）：

🔍 正在检测中断状态...

🔴 检测到中断任务：

任务：/webnovel-write 7
中断时间：2026-01-01 14:31:30（5分钟前）
中断位置：Step 2 - 章节内容生成中

已完成：
  ✅ Step 1: 上下文加载（14:31完成）

未完成：
  ⏸️ Step 2: 章节内容（已写1500字/目标3000-5000字）
  ⏹️ Step 3-7: 未开始

恢复选项：
A) 删除半成品，从Step 1重新开始（推荐）⭐
   风险：低
   清理 正文/第1卷/第007章.md，重新生成章节
   操作步骤：
   - 删除 正文/第1卷/第007章.md（如存在）
   - 清理 Git 暂存区
   - 清理中断状态
   - 执行 /webnovel-write 7

B) 回滚到Ch6，放弃Ch7所有进度
   风险：中等
   丢弃所有当前章节进度
   操作步骤：
   - git reset --hard ch0006
   - 清理中断状态
   - 重新决定是否继续Ch7

请选择（输入选项字母，如 A/B）：

Verification:

中断信息已完整展示
恢复选项已清晰列出
等待用户选择

FORBIDDEN:

自动选择恢复选项（必须等待用户输入）
隐藏任何恢复选项
跳过风险等级说明

Step 4: Execute Recovery (MANDATORY - USER CHOICE)

AFTER user provides choice (e.g., "A" or "B"):

YOU MUST execute the chosen recovery path.

选项 A 示例：删除半成品，重新开始

# Step 4.1: 清理半成品文件
python .claude/skills/webnovel-writer/scripts/workflow_manager.py cleanup --chapter {chapter_num}

# 预期输出:
# ✅ 已清理: 正文/第1卷/第007章.md, Git暂存区已清理

# Step 4.2: 清除中断状态
python .claude/skills/webnovel-writer/scripts/workflow_manager.py clear

# 预期输出:
# ✅ 中断任务已清除

输出给用户：

✅ 执行选项A：删除半成品，重新开始

Step 1: 清理半成品文件
[运行: python workflow_manager.py cleanup --chapter 7]
✅ 已清理: 正文/第1卷/第007章.md, Git暂存区已清理

Step 2: 清除中断状态
[运行: python workflow_manager.py clear]
✅ 中断任务已清除

现在可以执行 /webnovel-write 7

是否立即开始？（Y/N）

选项 B 示例：Git回滚

# Step 4.1: Git回滚
git reset --hard ch{(chapter_num-1):04d}

# Step 4.2: 清除中断状态
python .claude/skills/webnovel-writer/scripts/workflow_manager.py clear

# Step 4.3: 确认回滚结果
git status
git log --oneline -5

输出给用户：

✅ 执行选项B：回滚到Ch6

Step 1: Git回滚
[运行: git reset --hard ch0006]
HEAD is now at f975aa2 feat: 第6章《...》创作完成

Step 2: 清除中断状态
[运行: python workflow_manager.py clear]
✅ 中断任务已清除

Step 3: 确认回滚结果
[运行: git status]
On branch master
nothing to commit, working tree clean

⚠️ 已回滚到Ch6（commit f975aa2）
Ch7的所有进度已丢弃

现在可以重新开始Ch7创作，或继续其他任务。

是否立即开始Ch7创作？（Y/N）

Verification:

所选恢复路径已完整执行
清理操作已确认成功
中断状态已清除
询问用户是否立即继续

FORBIDDEN:

跳过任何清理步骤
不确认清理结果就继续
强制用户立即继续（必须询问）

Step 5: Resume Task (CONDITIONAL - USER CHOICE)

AFTER recovery execution complete:

IF user chooses to immediately continue (输入 "Y"):

# 执行原命令
/{original_command} {original_args}

# 示例:
/webnovel-write 7

输出给用户：

开始执行 /webnovel-write 7...
[启动正常创作流程]

IF user chooses to wait (输入 "N"):

输出给用户：

✅ 恢复完成。您可以稍后手动执行 /{command} {args}

流程结束。

Verification:

用户选择已确认
如选择立即继续 → 原命令已执行
如选择等待 → 提示信息已输出

特殊场景处理

场景 1：Step 6 中断（成本极高）⚠️

检测输出示例：

{
  "current_step": {
    "id": "Step 6",
    "name": "Bi-Chapter Review"
  },
  "completed_steps": ["Step 1", "Step 2", "Step 2.5", "Step 3", "Step 4", "Step 5"],
  "artifacts": {
    "chapter_file": {"exists": true, "status": "complete"},
    "strand_tracker_updated": true,
    "git_committed": false
  }
}

恢复选项展示（强调成本）：

恢复选项：
A) 重新执行双章审查（成本：~$0.15，耗时5-10分钟）⚠️
   风险：高成本
   重新调用5个审查员（high-point/consistency/pacing/ooc/continuity）
   操作步骤：
   - 重新调用5个审查员（并行）
   - 生成审查报告
   - 更新 state.json review_checkpoints

B) 跳过审查，继续下一章
   风险：低
   不进行审查（可后续用 /webnovel-review 补审）
   操作步骤：
    - 跳过审查（不生成报告）
    - 执行 Step 7: Git Backup（backup_manager.py）
    - 执行 workflow_manager.py complete-task
    - 可继续创作Ch8

💡 建议：如非关键章节，选择B节省成本

请选择（A/B）：

场景 2：Step 4 中断（state.json 部分更新）⚠️

检测输出示例：

{
  "current_step": {
    "id": "Step 4",
    "name": "Update State"
  },
  "artifacts": {
    "chapter_file": {"exists": true, "status": "complete"},
    "state_json_modified": true,
    "consistency_check": "failed"
  }
}

恢复选项展示（强调一致性检查）：

⚠️ 检测到 state.json 可能部分更新

恢复选项：
A) 检查并修复state.json
   风险：中等
   验证state.json一致性，补全缺失字段
   操作步骤：
   - 读取 state.json
   - 检查必要字段（progress, protagonist_state等）
   - 如缺失则从前一章推断
   - 重新执行 update_state.py
   - 继续Step 5

B) 回滚到上一章（安全）
   风险：高（丢失进度）
   恢复到上一章的state.json快照
   操作步骤：
   - git checkout ch0006 -- .webnovel/state.json
   - 删除第7章文件
   - 清理中断状态

💡 建议：如第7章文件完整，选择A修复state.json

请选择（A/B）：

场景 3：多次中断（超时检测）⚠️

IF elapsed_seconds > 3600（超过1小时）:

额外警告：

⚠️ 检测到中断已超过1小时（{elapsed_seconds/60}分钟）

上下文丢失风险：
- 超过1小时 → AI难以续写，建议重新开始
- 超过24小时 → 强烈建议回滚到稳定状态

请谨慎选择恢复策略。

Execution Checklist (VERIFY BEFORE CLAIMING "DONE")

Before you tell the user "Recovery complete", YOU MUST verify:

workflow-resume.md 已读取
workflow_manager.py detect 已执行
中断信息已完整展示给用户
恢复选项已清晰列出（含风险等级）
用户已明确选择恢复路径
所选恢复路径已完整执行
清理操作已确认成功
中断状态已清除
用户已决定是否立即继续
如立即继续 → 原命令已执行
如等待 → 提示信息已输出

IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.

Error Handling

IF workflow_manager.py detect 执行失败：

STOP immediately - Do not guess interruption state
OUTPUT the error to user with full details
CHECK if .webnovel/workflow_state.json exists
IF missing: 提示用户可能是旧项目（未集成workflow追踪），建议启发式检测
WAIT for user to fix the issue

Fallback Strategy（仅当workflow_state.json不存在时）：

# 启发式检测（兼容卷目录结构）
current_chapter=$(jq '.progress.current_chapter' .webnovel/state.json)
next_chapter=$((current_chapter + 1))
volume_num=$(( (next_chapter - 1) / 50 + 1 ))
next_file="正文/第${volume_num}卷/第$(printf '%03d' $next_chapter)章.md"

# 也检查旧格式
legacy_file="正文/第$(printf '%04d' $next_chapter)章.md"

if [ -f "$next_file" ] || [ -f "$legacy_file" ]; then
  echo "⚠️ 检测到半成品: $next_file 或 $legacy_file"
  echo "建议: 删除并重新创作"
else
  echo "✅ 状态一致，可继续创作Ch$next_chapter"
fi

FORBIDDEN:

Hiding detection errors
Claiming success when detection failed
Guessing interruption point without running script

FORBIDDEN（绝对禁止）

❌ 禁止智能续写半成品：
- 原因：上下文丢失，质量无法保证，容易产生前后矛盾
- 例外：无（任何情况都不续写）
❌ 禁止自动决定恢复策略：
- 原因：不同Step风险不同，必须用户确认
- 例外：仅当无中断任务时自动结束
❌ 禁止跳过中断检测：
- 必须运行 workflow_manager.py detect
- 禁止凭经验猜测
❌ 禁止修复state.json而不验证：
- Step 4中断时，必须逐字段检查一致性
- 禁止直接假设state.json正确

Start executing Step 1 now.

webnovel-resume.md 14 KB Állandó hivatkozás Előzmények Nyers

description: 恢复中断的网文创作任务，基于精确的workflow状态追踪

/webnovel-resume

CRITICAL WARNING ⚠️

Step -2: Load Knowledge Base (MANDATORY - FIRST)

Step -1: Environment Setup (MANDATORY - BEFORE RECOVERY)

1. Locate Project Directory

2. Output Environment Confirmation

执行流程（SEQUENTIAL - DO NOT SKIP）

Step 1: Load workflow-resume.md (MANDATORY)

Step 2: Detect Interruption (MANDATORY)

Step 3: Present Interruption Info & Recovery Options (MANDATORY)

Step 4: Execute Recovery (MANDATORY - USER CHOICE)

选项 A 示例：删除半成品，重新开始

选项 B 示例：Git回滚

Step 5: Resume Task (CONDITIONAL - USER CHOICE)

特殊场景处理

场景 1：Step 6 中断（成本极高）⚠️

场景 2：Step 4 中断（state.json 部分更新）⚠️

场景 3：多次中断（超时检测）⚠️

Execution Checklist (VERIFY BEFORE CLAIMING "DONE")

Error Handling

FORBIDDEN（绝对禁止）

webnovel-resume.md 14 KB

Állandó hivatkozás Előzmények Nyers