用途：将 Plans.md 中的计划任务与实际实现情况（Git 提交、变更文件、Agent Trace）对照，检测进度偏差并更新任务标记，同时输出进度摘要与回顾。
主要能力：校验 Plans.md 格式（缺失或 v1 三列格式会提示用 harness-plan create 重建 v2）；并行收集 Plans.md 状态、git status/diff/log 与 agent-trace 记录；通过 Agent Trace 分析最近编辑文件并与任务匹配；检测「已完成却标 cc:WIP」「已动工却标 cc:TODO」「标完成却未提交」等偏差，并给出更新建议表；输出各状态计数与进度率；指定 --snapshot 时把当前进度保存为带时间戳的 JSON 快照并与上次对比；检测多个 cc:WIP、未处理 pm:依頼中、WIP 长期未更新等异常；默认执行回顾（估计精度、阻塞原因、质量标记命中率、范围变动），可用 --no-retro 跳过，并写入 harness-mem。
用法：执行 harness-sync 进行进度同步加回顾；harness-sync --no-retro 仅同步；harness-sync --snapshot 保存快照；harness-sync --plan roadmap 同步指定命名计划。触发器包括 sync-status、where am I、check progress。多 Plans.md 仓库可用 scripts/plan-registry.sh list 确认目标。
限制：依赖 Plans.md 与 .claude/state/agent-trace.jsonl 等文件存在；未提供安装方式、收费、平台与效果数据。