batch-code-scanlisted

# Batch Code Scan 先读取 `../../shared/human-plan-protocol.md`，并遵守共享 Human Plan 协议。 `batch-code-scan` 负责一次性建立当前项目的可行动问题库存，并把问题拆成多个 draft Human Plan。它不是“找一个最严重问题”，也不是无限展开审计报告；重点是完整覆盖、清晰分组、避免重复扫描。它可以被用户手动当作库存/分发入口使用，也可以被 `/human-plan:loop` 当作串行 batch 的扫描入口使用。 ## 调用模式 - **手动调用**：用户直接执行 `/human-plan:batch-code-scan` 时，默认只建立库存、Plan 文件和 `batch-index.md`，输出真实 Plan Ref、依赖、建议顺序，以及可选的 `/human-plan:worktree <Plan Ref>` 分发建议；不自动写入 `state.json.active_plan_ref`，不强制进入串行 loop，除非用户明确要求“继续推进第一个/最高优先级 Plan”。 - **loop 调用**：由 `/human-plan:loop` 触发时，`batch-code-scan` 只负责创建或复用库存，然后按 loop 协议选择第一个 `pending` Plan，写入 `state.json.active_plan_ref`，把 `state.json.batch_status` 设为 `active`，进入串行闭环。 ## 扫描策略 - 先建立覆盖面：主要目录、入口、页面、接口、数据流、状态管理、配置、构建、部署、脚本和关键依赖。 - 按风险类型扫描：正确性、数据一致性、兼容性、权限安全、性能、错误恢复、重试超时、缓存、并发、可维护性、重复抽象和前端体验风险。 - 不在发现一两个严重问题后停止；必须继续覆盖其他主要模块。 - 记录跳过范围和原因，避免库存被误认为全覆盖。 - 如果存在未完成批次索引，先读取并复用；除非用户明确要求刷新，或代码已在批次扫描后发生明显变化，不重新全量扫描。 ## 问题库存 - 每个库存项必须有短标题、证据位置、严重级别、影响面和归属 Plan Ref。 - 严重级别按用户影响、数据风险、触达频率、恢复成本和修改确定性判断。 - 低优先级但真实可行动的问题也进入库存；无证据的猜测不进入库存。 - 批次索引只保存分发所需信息，不展开完整分析过程。 ## 拆分 Plan - 一个候选 Plan 只覆盖一个连贯修复范围。 - 共享根因、共享契约或必须一起改才有意义的问题可以合并。 - 无共同边界、可以独立处理的问题必须拆开；是否并行取决于调用模式，手动分发可走 worktree，loop 内按索引顺序串行推进。 - 会互相冲突、共享同一抽象或依赖前置改造的计划必须标清依赖顺序。 - 每个候选 Plan 只写问题价值、目标结果、边界、依赖和验收结果，不写实现步骤。 ## 批次索引必须包含 - Batch ID、扫描范围和扫描时间。 - 扫描覆盖面、跳过项及原因。 - 完整问题库存。 - 每个候选 Plan 的标题、包含问题、严重级别、影响面、Plan Ref、建议顺序、依赖和是否适合独立 worktree。 - 计划之间的依赖、冲突和建议执行顺序。 - 推进方式：手动调用时给出库存和分发建议；loop 调用时选取最高优先级 Plan 自动进入 `/human-plan:dev <Plan Ref>`，