任务恢复 · 卡死体检与救援【律令·本地零联网】
任务救援与卡死恢复：任务状态损坏/卡死/与清单对不上时的体检，含诊断、状态修复、快照回滚、预览式修复与差异比对。
免费 · 开源许可 BUSL-1.1 · 本地执行，安装后不产生任何外部网络请求
去安装 →这个技能做什么
本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。
任务恢复
子命令
| 子命令 | 作用 |
|---|---|
diagnose | 体检：僵尸 running、孤儿/幽灵项、churn、结构损坏 |
snapshot | 给状态文件打快照（逐字节副本 + sha256） |
repair | 按规则修复（默认预览，--yes 落盘，改前 .bak） |
diff | 比对两份状态（快照或状态文件） |
rollback | 从快照回滚状态文件（默认预览） |
snaps | 列出快照 |
工作流建议
- 收到「任务不对」的报告时：先
diagnose，不要直接repair --yes。诊断结果本身就区分了「能自动修」和「要人来定」。 - 动手前先快照：任何
repair --yes之前先snapshot。出事了能rollback，且快照是逐字节副本，diff出来的差异完全可信。 - 改完必须复核：
repair --yes之后重跑diagnose，确认verdict与issue_count的变化符合预期。 - 交付时要说清楚：
- 区分「已自动修复」与「仅报告、需人工裁决」——
churn和phantom永远属于后者； - 若
verdict说剩余项需人工裁决，不能说「已修复完毕」； order_without_item这类丢失的信息补不回来，要明确告知影响面。
自检清单
repair/rollback不加--yes时，文件 sha256 是否确实未变？- 落盘前是否有
.bak（backup字段非空）？ repair --yes后是否重跑了diagnose复核？- 交付时是否说明了哪些是「仅报告、需人工裁决」（churn / phantom）？
- 若有
order_without_item，是否明确告知这部分的进度信息已不可恢复？
---
任务恢复 · 律令科技（深圳）有限公司 (@lexord-technology) · Proprietary · © 2026
与相邻技能的关系
本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：
| 用户要做的事 | 转交给 | 转交话术 |
|---|---|---|
| 要恢复到断点继续跑 | resume-runner | 「断点续跑交给 resume-runner」 |
| 要重新估算进度与 ETA | progress-tracker | 「进度追踪交给 progress-tracker」 |
| 损坏的是批量任务 | batch-runner | 「批量调度交给 batch-runner」 |
反向边界：修复默认先快照 + 预览差异，确认后才落盘；支持回滚。不做无快照的就地修复。
你是一个任务状态的急救员：任务崩了、卡了、状态文件和清单对不上了，你来判断「哪些能自动修、哪些必须人来定」。核心原则：先诊断再动手、默认只预览不落盘、能自动的才自动、拿不准的如实报告不装作能修。
标签
任务恢复任务救援状态修复卡死恢复快照回滚
安装方式
- 打开 SkillHub 上的技能页，点击安装；
- 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
- 在你的 Agent 里直接说出使用场景即可触发，例如「任务卡死、状态文件坏了、任务恢复」。
network: none，运行过程中不发起任何外部网络请求，也不上传你的文件与数据。你可以断网运行来验证这一点。同类技能
常见问题
按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。
任务恢复 · 卡死体检与救援 能帮我做什么？
任务救援与卡死恢复：任务状态损坏/卡死/与清单对不上时的体检，含诊断、状态修复、快照回滚、预览式修复与差异比对。
常见的触发场景有：任务卡死、状态文件坏了、任务恢复。
完整说明、版本记录和安装方式在 SkillHub 上的「任务恢复 · 卡死体检与救援」页面。
它明确不做什么？什么情况该转给别的技能？
本包只做职责范围内的事。下面这些情况它会明确转给兄弟技能，而不是硬做：
- 要恢复到断点继续跑 → 转给 resume-runner
- 要重新估算进度与 ETA → 转给 progress-tracker
- 损坏的是批量任务 → 转给 batch-runner
反向边界：修复默认先快照 + 预览差异，确认后才落盘；支持回滚。不做无快照的就地修复。
用之前得注意什么？有什么红线？
每次执行前要过的自检项：
- repair / rollback 不加 --yes 时，文件 sha256 是否确实未变？
- 落盘前是否有 .bak（backup 字段非空）？
- repair --yes 后是否重跑了 diagnose 复核？
- 交付时是否说明了哪些是「仅报告、需人工裁决」（churn / phantom）？
装上之后怎么用？
安装后，在支持 SkillHub 的 AI 客户端（如 WorkBuddy）里直接使用即可。
触发方式：对话里提到「任务卡死、状态文件坏了、任务恢复」等场景，或把相关文件发给 AI，它就会自动响应。
也可以直接跑脚本，典型用法：python scripts/task_recovery.py <子命令> [参数]（完整参数见包内说明）。
或从客户端的「已安装技能」列表里手动唤起。
怎么验证它真的没有联网？
不发一个网络包——包的 frontmatter 声明 network: none，不声明就没有联网能力。三条验证路径任选：
① 安装后把网断掉再跑一遍，功能照常——它本来就没打算联网；
② 用抓包工具（Wireshark / Fiddler）观察该技能进程，零外部连接；
③ 直接翻源码：job_state.py、task_recovery.py 等源码全部公开可预览，没有一行网络代码。这是能逐行核对的技术事实，不是宣传口号。
要付费吗？要 API Key 吗？
不需要 API Key，全部技能免费安装。
许可为 BUSL-1.1：BUSL-1.1 源码可见，个人及企业内部可自由使用（含内部生产环境）；发布满 4 年自动转为 Apache-2.0。详见随包 LICENSE.md。
什么环境能跑？需要装依赖吗？
Windows / macOS / Linux 都能跑。
纯 Python 标准库实现，不需要 pip install 任何东西，也就没有环境冲突要调。
唯一前置是本机装了 Python 3；客户端（如 WorkBuddy）会替你调用，一般不用手动敲命令。
它会不会乱动我的电脑？高危操作怎么办？
四项诚实承诺写死在每个包里：算不出就说算不出；高危动作强制人工确认（阻断而非提示，不是弹窗问一句就放行）；幂等断点，绝不重复副作用；全程留痕可审计。
这类工具包只读取你指定的输入，结果写到输出目录，不改原文件；每一步动作留痕可查。
遇到问题怎么反馈？
执行 · 门禁 · 账单 · 可靠 —— 四块拼图，覆盖 Agent 落地全链路
去企业页 →