用途:该技能用于校准(reconcile)工作流状态文件,确保检查点被正确更新,防止工作流边界处的“检查点失忆”。它只在检测到状态漂移或用户显式执行 /reconcile [PluginName?] 时调用,正常检查点完成由 plugin-workflow 内部处理。
主要能力:采用五阶段编排模式——上下文检测、规则加载、差距分析、报告生成、修复执行。上下文检测优先读取 .continue-here.md 的 YAML frontmatter(workflow、stage、status、phase),其次读取 PLUGINS.md 中的状态表情,最后通过文件系统分析推断工作流。规则加载使用 jq 从 assets/reconciliation-rules.json 中仅提取所需段落,例如 jq '.["plugin-workflow"].stages["2"]' reconciliation-rules.json。差距分析检查必需文件是否存在、状态文件是否最新、PLUGINS.md 状态是否匹配、以及 git 状态是否存在未提交变更,并将差距聚合为结构化报告。
使用方式:用户运行 /reconcile [PluginName?],或由其他技能检测到状态漂移时触发。报告生成后会展示决策菜单并等待用户选择,绝不自动继续。菜单选项按差距严重程度分为无差距、轻微差距(仅时间戳漂移)、重大差距(文件缺失或未提交)三类,用户可选择自动修复、先查看差异、仅更新文件不提交、仅更新 .continue-here.md 或跳过。
适用场景:状态文件不同步、子代理完成后缺少交接文件、工作流之间切换、需要验证检查点连续性时。
限制:无法检测上下文时会阻塞并提示提供插件名;工作流未在 reconciliation-rules.json 中定义时会报错“Unknown workflow”;在 plugin-workflow 的 Stage 1-3 期间禁止修复契约文件(.ideas/*.md),会警告契约不可变并建议完成当前阶段或回滚到 Stage 0;git 操作失败会显示错误并返回决策菜单。参考文件包括 reconciliation-rules.json、handoff-formats.md、reconciliation-examples.md。