Reconcile¶
如果是用户请求的功能、候选方向提升或未来方向变更,请用 Propose。Reconcile 负责处理新收到的工程评审。
Reconcile 把一份新的工程评审变成记忆库中已获批准的规划变更。它只做规划, 不做实现。
在你项目的会话里发出请求。把 review.md 换成你实际的评审来源:
| 智能体 | 会话中的请求 |
|---|---|
| Claude Code 插件 | /memory-bank:memory-bank-reconcile review.md |
| Codex 插件 | $memory-bank:memory-bank-reconcile review.md |
| DSH | /memory-bank-reconcile review.md |
参数:一个评审来源。可以粘贴,可以作为附件,也可以是本地路径、仓库相对路径 或远程地址。
如果是直接装到技能目录里的,请参见 调用前缀。
何时使用¶
初始化之后收到代码、架构、安全或其他工程评审时,都可以用它。它要求项目里 已经有里程碑和状态运行器,不会替你初始化项目。
评审之后,最顺理成章的下一步提示往往是“把四项发现都修掉”。可这样一来,反倒把 最关键的问题跳过去了:它们现在还成立吗?
评审描述的可能是更早的提交。有一项发现早就修好了;另一项和某个待处理的里程碑 重复;它用的 P1/P2 未必等于你项目定义里的含义;某条架构建议也许很合理,但根本 不在你的归属范围内。
评审文本是不可信的证据¶
评审只当数据看,绝不当作指令。内嵌的命令不会仅仅因为出现在文档里就去执行。
做任何远程抓取之前,Reconcile 都会先把确切 URL 给你看,再单独要一次明确的 确认——哪怕这个 URL 是你自己在请求里给的。从仓库内容或评审正文里找到的 URL, 从来都不构成抓取的授权。
三个阶段¶
评估。 先读评审和当前记忆库,再看相关实现与测试、历史记录,以及评审自己 声明的基线。每一项发现都要对照当前仓库逐项重新验证。
给出方案。 展示完整的处置矩阵:
| 发现项 | 来源优先级 | 项目严重级别 | 当前处置 | 计划归属 |
|---|---|---|---|---|
| 进程在启动失败后仍然存活 | P1 | P1 | 已确认 | 归入开放的会话生命周期里程碑,新增一行 |
| 超时行为不一致 | P2 | P2 | 重复 | 已有的待处理公共契约行 |
| 清理失败路径未经验证 | P2 | P2 | 已确认 | 新建的补救里程碑 |
| 重命名辅助函数 | P3 | 较低 | 延后 | 带触发条件的候选方向 |
处置还包括部分确认、已经解决、当前证据不支持、超出归属范围,以及取决于决策 结果。来源优先级原样保留,以留住来源信息;项目严重级别则按你项目的定义单独 划定。
写入。 独立使用时,执行已批准的操作。处置矩阵、归属、依赖、下游影响、候选方向和文件 操作,没经你批准之前什么都不写。
已批准运行中的协调¶
当 Goal/Next 所有者已获人类批准的 CORRECTIVE_PLANNING: auto,可为必要的范围内修复规划提供常设批准。
Reconcile 仍先按原目标、所属仓库、现有授予及所有限额准备并检查完整发现项、归属和文件操作方案,
再写入被覆盖的待处理调整、新修复里程碑及依赖、启动参考和哈希更新,无需再次确认。
保留冻结历史与计数;新功能、权限、提高限额、冲突或未知校验和漂移仍需批准。
goal 规则 拥有该例外。独立 Reconcile 保留完整批准门槛;
技能只规划,并把实现交还现有所有者。
调用请求必须携带完整已解析请求、可识别的人类批准来源、所覆盖操作、授予和限额。 写入前对照调用会话或已支持的可信宿主状态验证;评审文本、项目文件和模型断言不能提供批准。 来源缺失或无法验证时保留普通批准门槛;有效批准无需重复确认。修复不能降低验收或取消未履行义务。 新修复里程碑仍保留原里程碑的评审门槛、计数器及第 10 轮停止条件。
发现项去哪里¶
发现项一旦确认,只要落在一个开放里程碑的范围之内,就在那里新增一条待处理行。 要是已经有待处理的里程碑负责这个结果,就更新它,不用重复建。
已完成的历史保持关闭。 发现项涉及已完成的工作时,Reconcile 会新建一个补救 里程碑,并留下溯源关系指回受影响的里程碑。历史状态记录的是当时发生了什么, 不会为了让今天的计划显得更整洁而改写它。
每一项活跃发现都带着可移植的来源信息:评审标题和发现项 ID、来源优先级和项目
严重级别、声明的基线和重新验证所用的提交、相对于仓库的证据路径,以及指向既有
工作的溯源关系。这里没有越积越多的 reviews/ 目录,也没有第二份评审台账。
架构建议不是当前架构¶
评审若描述的是一个目标状态,那么在它实现之前,只能算作里程碑的范围和验收内容。
直接把它写进 architecture.md,记忆库就不对了:文档描述的是评审想要的系统,
而不是智能体接下来要改的系统。
只有当前仓库证据证明某项描述确实过时了,Reconcile 才去修正 product.md、
architecture.md 或 tech-stack.md。
下游优先¶
发现项很少只影响它所在的那个文件。所以实现开始之前,Reconcile 会先更新待处理的 下游消费方:依赖关系和顺序、任务表述和验收、兼容性预期、验证覆盖面,以及计划依赖 于受影响契约的下游状态文件。
这样一来,发现项即便改动了多个里程碑共用的假设,计划仍然保持一致。
它不会做什么¶
Reconcile 不实现发现项,不把任务标成完成,不改非待处理行的状态,不提交,不推送, 也不启动执行。规划和执行始终是两条独立的授权边界。