damage-control

故障控制

概述

为会话中途遇到状态异常的 Agent 提供恢复协议。故障控制涵盖四类故障：Agent 崩溃并在磁盘上留下部分工作、上下文窗口溢出导致状态丢失、合并冲突阻碍工作推进，以及需要协调的常规会话状态损坏。

此技能不会预防故障，而是规定故障发生后该如何处理，确保恢复过程一致、可审计，且不会悄然丢弃工作。

适用场景

• Agent 进程崩溃，导致文件状态未知
• 会话达到上下文限制，无法加载先前的决策
• git merge 或 git rebase 产生了 Agent 无法自动解决的冲突
• 观察到的状态（磁盘上的文件、任务列表、git 索引）与预期状态不一致
• 下游 Agent 报告缺少本应由上游生成的产物

不适用场景

• 开始工作前的主动风险评估（改用 Skill(leyline:risk-classification)）
• 故障发生后的战略架构决策（改用 Skill(attune:war-room)）
• 单次工具调用中的常规错误处理（改用 Skill(leyline:error-patterns)）

故障分诊

使用此决策树选择正确的模块：

flowchart TD
    A[Failure detected] --> B{Agent process crashed\nor exited unexpectedly?}
    B -->|Yes| C[modules/crash-recovery.md]
    B -->|No| D{Context limit hit or\nprior decisions unavailable?}
    D -->|Yes| E[modules/context-overflow.md]
    D -->|No| F{git merge / rebase /\ncherry-pick conflicts?}
    F -->|Yes| G[modules/merge-conflict-resolution.md]
    F -->|No| H{State internally inconsistent?\ntask list vs disk vs git index}
    H -->|Yes| I[modules/state-reconciliation.md]
    H -->|No| J[No damage-control needed]

如果存在多种重叠的故障类型，请先使用 state-reconciliation.md 建立已知基线，然后 处理具体故障类型。

风险评估清单

执行 Level 1 及以上级别的任务前，请完成 modules/risk-assessment-checklist.md 中的风险评估 清单。回答以下五个问题：

1. 生产环境中可能出现什么故障？ 列出具体故障 场景。
2. 如何快速检测到故障？ 监控、警报、 日志。
3. 最快且安全的回滚方式是什么？ 按步骤说明 操作流程。
4. 什么依赖项可能使此计划失效？ 外部 依赖项。
5. 哪个假设最不确定？ 计划中最薄弱的环节。

Level 1（观察）及以上级别必须完成。完整模板和示例请参阅 modules/risk-assessment-checklist.md。

模块参考

• crash-recovery.md：Agent 崩溃后的分诊、检查点检查，以及 安全恢复或回滚。
• context-overflow.md：上下文窗口耗尽时重建决策上下文的 操作流程。
• merge-conflict-resolution.md：git 冲突的分类与 解决策略，包括升级至人工审核。
• state-reconciliation.md：协调任务列表、git 索引和磁盘上 产物之间不一致状态的协议。
• risk-assessment-checklist.md：Level 1 及以上级别任务的 执行前检查清单。

集成模式

# In your skill's frontmatter
dependencies: [leyline:damage-control]

识别出故障类型后，调用相应模块：

# Crash detected
Skill(leyline:damage-control) → modules/crash-recovery.md

# Context limit reached
Skill(leyline:damage-control) → modules/context-overflow.md

对于管理多个 Agent 的编排器，无论是否发生故障，都应在每个会话边界调用 state-reconciliation。这样可以在下一个工作阶段开始前建立经过验证的检查点。

退出标准

• Agent 状态明确无误（不存在未知的部分写入）
• Git 索引干净，或所有冲突均已解决
• 任务列表准确反映所有任务的实际完成状态
• 下游 Agent 所需的所有产物均已就绪并经过验证
• 如果已回滚，则回滚已提交，且已在任务列表中记录回滚范围
• 如果需要升级至人工审核，则会话结束前已生成升级记录