用途:docs-impact-localizer 是文档同步(docs-sync)流程中的工作计划器。它接收分类器给出的候选页面列表,输出逐页任务简报,供 docs-sync 面板分发执行。它不负责判定(由 classifier 负责),也不负责撰写(由 doc-writer 负责)。
触发时机:仅当分类器返回 verdict: in_place 时由 docs-sync 编排器调用;no_change 时不运行;structural 时先由 architect 运行,之后可针对需要修订的既有页面运行。
输入:分类器的 scope_pages[]、PR diff(gh pr diff $PR)、.apm/docs-index.yml 页面元数据,以及可选的 structural architect 的 TOC 增量。
主要能力:第一步读取 scope_pages[] 中每个页面内容;第二步在每个页面内定位需改动的具体章节,读取 H2/H3 结构,为每个 diff 符号找到最直接记录它的章节,记录行范围(如 120-145),产出 sections_to_edit[],含 section、line_range、diff_symbol、edit_kind(add/modify/remove)、rationale;第三步检测跨页冲突,若两页记录同一符号且 diff 改变其行为,则两页都需编辑并保持一致,输出 cross_page_constraint;第四步输出逐页任务简报 JSON,含 tasks[](page、persona_owner、promise、sections_to_edit[]、verify_claims[])、cross_page_constraints[]、estimated_panel_calls。verify_claims[] 供 python-architect 面板成员做 S7 工具调用核验(如运行 apm install --help、grep 源码)。
输出契约:任务最后一条消息返回单个符合 Step 4 模式的 JSON 文档,JSON 外不加散文。
限制与反模式:不要整页选择而应只选必要章节;不要跳过 verify_claims[];不要虚构 scope_pages[] 之外的页面,若认为分类器遗漏页面,应返回额外字段 localizer_concern 而非自行扩大范围。资料未提供具体安装命令、收费或平台信息。