用途:检测并重新对齐 .workflow/ 工件与代码现实之间的漂移,通常在代码重构之后使用。与 manage-knowledge-audit(检查知识库内部矛盾)互补,本技能关注代码与文档之间的不一致。
主要能力:核心工作流为时间线重建、漂移评分、四路并行扫描、分诊、应用。扫描器包括 roadmap-scanner、spec-scanner、codebase-scanner、artifact-scanner,识别多种漂移类型并给出 P0/P1/P2 严重级别与证据(代码现实、文档声明、git 引用)。
使用方式:命令如将 "" 作为占位,可传 --scope all --since 2026-04-01、--scope spec --depth deep、--auto-archive、--report、--dry-run、--continue 等。外层标志有 -y 跳过确认、-c N 并发数(默认 4)。内层标志有 --scope、--since、--depth(shallow/deep)、--dry-run、--report、--auto-archive。先运行 maestro timeline --since <date> --json 生成 timeline.json。
输出与限制:输出到 .workflow/.csv-wave/{session-id}/ 与 .workflow/.drift-realign/,所有写入必须限于 .workflow/ 元数据或备份目录,绝不修改源代码文件。--report 与 --dry-run 不写文件、不更新 state.json。需要 git 仓库与 .workflow/state.json,缺失时报错中止。