---
name: remediation-planner
description: 整改计划制定 Skill。将差距报告、审核发现、或不兼容分析转化为有优先级、有验收标准的可执行整改计划。每个步骤配对验证方法，防止「计划没有验证」的情况。触发词：「基于这个分析制定整改计划」「怎么修复这些问题」「制定改进方案」「这些差距怎么补」「把发现转成行动计划」。
---

# 整改计划制定（remediation-planner）

> 把分析结论变成可执行、可验证的行动计划。
> 没有验收标准的计划不算计划。
> 基于 closure-orchestration-package 的 remediation-planner-verifier 本地化。

---

## 激活后立即执行

```
Step 1  读取输入
        需要：
        - 差距报告 / 审核报告 / 发现清单（来自 architecture-gap-mapper / verifier / arch-destroyer 等）
        - 约束条件（时间/资源/技术限制）
        - 现有真源文档或代码结构

Step 2  按依赖和严重度分组
        
        【P0 阻断级】不处理会导致系统无法正常运行
        【P1 重要级】影响核心功能或重大风险
        【P2 优化级】改善体验或减少技术债
        
        同时识别依赖关系：哪些问题必须先解决，才能处理其他问题

Step 3  拆解为最小安全步骤
        每个步骤必须：
        - 有明确的负责角色（哪个 Skill/Role 执行）
        - 有明确的写入范围（allowed_write_set）
        - 有明确的完成判断标准（done_criteria）
        - 不能一步改超过 3 个独立的模块

Step 4  为每个步骤配对验证方法
        每个整改步骤必须对应一个验证步骤：
        - 文档修改 → 读者能否按文档走通？
        - 代码修改 → 测试是否通过？
        - 架构调整 → gap-mapper 能否确认差距已消除？

Step 5  标注 branch 结构建议
        输出建议的 branch 划分（供 project-retrospective 参考）：
        - 哪些步骤可以并行（互不影响的独立 branch）
        - 哪些步骤必须串行（有依赖的 branch）

Step 6  输出整改计划文档
        写入：[相关目录]/remediation-plan-YYYYMMDD.md
```

---

## 输出格式

```markdown
# 整改计划

**制定日期**：YYYY-MM-DD
**输入来源**：[差距报告/审核报告名称]
**约束条件**：[时间/资源/技术]

## P0 阻断级整改（必须优先处理）

### P0-01 [整改项名称]
- **问题**：[描述]
- **负责**：[Skill/Role]
- **写入范围**：[文件列表]
- **完成标准**：[可验证条件]
- **验证方法**：[如何验证已修复]
- **依赖**：[必须在此之前完成的项目]

## P1 重要级整改

[同上格式]

## P2 优化级整改

[同上格式]

## 建议 Branch 结构

```
并行 branch：
  branch-A: [P0-01 + P0-02]（无依赖关系）
  branch-B: [P1-01]（与A无交叉）

串行 branch：
  branch-C: P0-03（依赖 branch-A 完成）
```

## 验收总清单

所有 P0/P1 项通过验证后，整改才算完成。
```

---

## 注意事项

- **没有验证标准的步骤不写入计划**：每步必须配验证方法
- **最小步骤原则**：一步只做一件事，方便单独验证和回滚
- **branch 边界清晰**：并行的步骤不能写同一真源

---

## 变更记录

### v1.0 — 2026-03-19 — 初始创建

**根因**：审核/分析类 Skill（verifier/arch-destroyer/architecture-gap-mapper）产出发现报告后，缺乏一个专门将发现转化为可执行计划的 Skill。基于外部包 remediation-planner-verifier 本地化，加入 branch 结构建议。

**验证状态**：🔵 待验证