用途:当项目采用中央清单文件登记关联制品时,扫描清单并对比物理文件,检测三类漂移:悬挂引用(清单有、文件无)、未登记(文件有、清单无)、命名不符(同 slug 路径不一致)。成功标准包括扫描全部符合 glob 的清单、逐份对比、输出三类漂移且不自动写入。\n\n主要能力:按规范解析产出路径(默认 docs/calibration/work-item-manifest-alignment.md)与清单 glob(默认 docs/process-management/now/*.md,可由 ARTIFACT_NORMS.md 覆盖)。第 0 阶段做前置检查,无清单文件则停止并诊断;第 1 阶段解析清单声明的子制品引用并构建 manifest 到 declared_file_paths 映射;第 2 阶段检查物理存在并交叉对比;第 2.5 阶段按 D1 至 D6 分支判定,优先级 D1>D6>D2/D4>D3>D5;第 3 阶段输出 Markdown 报告,含三类漂移分组表格、建议动作和末尾 YAML fenced drift_summary 供 plan-next 消费。\n\n使用方式:输入项目路径(默认 CWD),可选 manifest glob 与 artifact_norms_path;运行后阅读报告并按建议手动修正清单或文件。适用场景:纯清单项目定期健康检查、plan-next G3 漂移深入诊断、迭代收尾盘点、迁移到清单风格后的初次对齐。\n\n限制:v1.0.0 只读,不写清单、不创建删除移动制品;无清单文件时必须停止并诊断;不负责模式识别(discover-docs-norms)、模式选择(define-docs-norms)、清单维护(未来 v2.x)、归档重命名(tidy-repo)和漂移修正规划(align-planning);下游路由由用户或 plan-next 处理。
align-work-item-manifest
设计与创作
更新于 10-16 06:50