Task Resume Skill
Project Root Guard(必须先确认)
- 必须在项目根目录执行(需存在
.webnovel/state.json) - 若当前目录不存在该文件,先询问用户项目路径并
cd进入 - 进入后设置变量:
$PROJECT_ROOT = (Resolve-Path ".").Path
Workflow Checklist
Copy and track progress:
任务恢复进度:
- [ ] Step 1: 加载恢复协议 (cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-resume/references/workflow-resume.md")
- [ ] Step 2: 加载数据规范 (cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-resume/references/system-data-flow.md")
- [ ] Step 3: 确认上下文充足
- [ ] Step 4: 检测中断状态
- [ ] Step 5: 展示恢复选项 (AskUserQuestion)
- [ ] Step 6: 执行恢复
- [ ] Step 7: 继续任务 (可选)
Reference Loading Levels (strict, lazy)
- L0: 不加载任何参考,直到确认存在中断恢复需求。
- L1: 只加载恢复协议主文件。
- L2: 仅在数据一致性检查时加载数据规范。
L1 (minimum)
references/workflow-resume.md
L2 (conditional)
references/system-data-flow.md(仅在需要核对状态字段/恢复策略时)
Step 1: 加载恢复协议(必须执行)
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-resume/references/workflow-resume.md"
核心原则(读取后应用):
- 禁止智能续写: 上下文丢失风险高
- 必须检测后恢复: 不猜测中断点
- 必须用户确认: 不自动恢复
Step 2: 加载数据规范
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-resume/references/system-data-flow.md"
Step 3: 确认上下文充足
检查清单:
- 恢复协议已理解
- Step 难度分级已知
- 状态结构已理解
- "删除重来" vs "智能续写" 原则已明确
如有缺失 → 返回对应 Step
Step 难度分级(来自 workflow-resume.md)
| Step | 难度 | 恢复策略 |
|---|---|---|
| Step 1 | ⭐ | 直接重新执行 |
| Step 1.5 | ⭐ | 重新设计 |
| Step 2A | ⭐⭐ | 删除半成品,重新开始 |
| Step 2B | ⭐⭐ | 继续适配或回到 2A |
| Step 3 | ⭐⭐⭐ | 用户决定:重审或跳过 |
| Step 4 | ⭐⭐ | 继续润色或删除重写 |
| Step 5 | ⭐⭐ | 重新运行(幂等) |
| Step 6 | ⭐⭐⭐ | 检查暂存区,决定提交/回滚 |
Step 4: 检测中断状态
python "${CLAUDE_PLUGIN_ROOT}/scripts/workflow_manager.py" detect
输出情况:
- 无中断 → 结束流程,通知用户
- 检测到中断 → 继续 Step 5
Step 5: 展示恢复选项(必须执行)
展示给用户:
- 任务命令和参数
- 中断时间和已过时长
- 已完成步骤
- 当前(中断)步骤
- 剩余步骤
- 恢复选项及风险等级
示例输出:
🔴 检测到中断任务:
任务:/webnovel-write 7
中断位置:Step 2 - 章节内容生成中
已完成:
✅ Step 1: 上下文加载
未完成:
⏸️ Step 2: 章节内容(已写1500字)
⏹️ Step 3-7: 未开始
恢复选项:
A) 删除半成品,从Step 1重新开始(推荐)
B) 回滚到Ch6,放弃Ch7所有进度
请选择(A/B):
Step 6: 执行恢复
选项 A - 删除重来(推荐):
python "${CLAUDE_PLUGIN_ROOT}/scripts/workflow_manager.py" cleanup --chapter {N} --confirm
python "${CLAUDE_PLUGIN_ROOT}/scripts/workflow_manager.py" clear
选项 B - Git 回滚:
git -C "$PROJECT_ROOT" reset --hard ch{N-1:04d}
python "${CLAUDE_PLUGIN_ROOT}/scripts/workflow_manager.py" clear
Step 7: 继续任务(可选)
如用户选择立即继续:
/{original_command} {original_args}
特殊场景
Step 6 中断(成本高)
恢复选项:
A) 重新执行双章审查(成本:~$0.15)⚠️
B) 跳过审查,继续下一章(可后续补审)
Step 4 中断(部分状态)
⚠️ state.json 可能部分更新
A) 检查并修复 state.json
B) 回滚到上一章(安全)
长时间中断(>1小时)
⚠️ 中断已超过1小时
上下文丢失风险高
建议重新开始而非续写
禁止事项
- ❌ 智能续写半成品内容
- ❌ 自动选择恢复策略
- ❌ 跳过中断检测
- ❌ 不验证就修复 state.json