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
输出格式
# 整改计划
**制定日期**: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 结构建议。
验证状态:🔵 待验证