{"name":"write_to_file","arguments":{"path":"_bmad-output/analysis/ANALYSIS-20261022-document-test-governance.md","content":"# 文档、测试与跨宿主入口治理：旧任务对账及新方案裁决\n\n- 日期：2026-10-22。\n- 交付性质：分析与治理提案；不是实施、冻结、归档或宿主验收回执。\n- 旧契约：[`pending_implementation_plan.md`](../pending_implementation_plan.md:1)，标识 BMAD-V4-ATTENDED-CLEANUP-20261021-01。\n- 旧决策：[`ADR-20261021-v4-attended-repair-and-repository-cleanup.md`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:3)。\n- 指定研究输入：[`bmad-document-test-optimse.md`](../../docs/Ralph-Wiggum-Loop/bmad-document-test-optimse.md:3)。\n- 本次授权：只读对账旧任务；保存必要分析与 PROPOSED 决策；形成治理及迁移契约。用户随后明确确认，冻结保全和默认入口交接交给获准工程入口，不自动启动；实际文件迁移以后另行授权。\n- 本报告不改变旧计划、旧 ADR、项目事实基线、生产文件、分发目标或当前宿主配置。没有执行终端、测试、探针、安装或 Git 操作。\n\n## 1. 最小充分结论\n\n旧任务不能按完成收尾：最新回读仍为 BLOCKED，旧 ADR 仍为 PROPOSED；宿主验收明确未完成，部分本地验收只有历史摘要，没有取得原始回执。保留旧验收，不重复清理，不通过冻结消除未完成义务。依据见旧[`计划阶段与未决项`](../pending_implementation_plan.md:79)和旧[`ADR 接受边界`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:87)。\n\n推荐“职责分离的通用入口与目标布局＋薄宿主适配＋分阶段迁移”。当前可结晶设计，不能宣布运行可行门禁全部通过。新计划仍以默认入口为目标，须在工程完成旧计划保全及引用交接之后接入；本报告的交接契约不是第二份活动计划。\n\n必要非目标：不迁移或删除现有资产，不取消旧验收，不自动启动冻结工程，不实施 Cline/Roo 适配，不新增终端权限，不将研究材料中的目录名称、评分或比例冒充行业标准。\n\n## 2. 三遍阅读与证据分层\n\n### 第一遍：范围、职责和验收\n\n问题是长期资产、临时过程、当前契约和宿主入口职责混用，不是测试文件或日期命名本身有错。研究材料提出的痛点作为用户问题线索；材料中其他私有项目的截图、缺陷和因果推断不外推为本仓库事实。\n\n当前契约要求保留语言封装、回归能力、历史决策、唯一证据和跨宿主接管。成功不能用目录数量、新增测试数量为零或文件数减半定义。\n\n### 第二遍：依据等级\n\n- 用户授权：本轮结晶与最新冻结交接确认；不等同于工程已经执行。\n- 当前源码事实：模式白名单、校验器、测试断言、分发映射及 CI 文本可以定位；不等同于通过或加载。\n- 历史摘要：旧计划保存的阶段通过摘要和平台调用标识；未取得原始结果时不能认定已重新核验有效。\n- 外部一手资料：当前检索返回的官方文档与作者原文片段；没有目标安装版本、固定源码版本和宿主交互回执。\n- 逻辑推断：职责分离和保全先行可以降低已识别的覆盖风险；未测量维护成本或模型效果。\n- 未知：现有改动与历史回执是否一致、目标宿主实际加载与权限行为、研究中部分作者归因及完整原文。\n\n### 第三遍：虚拟重实现\n\n先切入口会丢失旧任务定位；先移动文件会破坏硬编码路径和测试发现；仅合并测试可能丢断言或白盒访问；仅忽略目录可能屏蔽唯一证据；只放通用入口不能证明宿主自动加载。故先保全与契约适配，再分批迁移，分别验证静态、磁盘分发和真实宿主交互。该推演不是实测。\n\n## 3. 旧任务逐阶段、逐验收对账\n\n### 判定口径\n\n“已完成且证据有效”须能核对原始命令、工作目录、实际退出状态、关键输出、目标及适用输入；历史摘要不代替原始回执。当前没有取得足以将某一完整工程阶段重新登记为该类别的原始证据。已有历史记录保留，不据此推断过去没有执行。\n\n| 阶段／验收 | 本轮判定 | 依据及覆盖范围 | 最小剩余事项 |\n|---|---|---|---|\n| 阶段 0：接管、所有权和在途边界 | 有历史摘要；当前写入边界缺证据 | [`计划`](../pending_implementation_plan.md:72)明确进程名称检查不足以证明绑定资产安全写入；清理边界调用标识见[`计划`](../pending_implementation_plan.md:67) | 工程在实际写入前只核对相关所有权、现有改动和在途操作，不由分析运行终端 |\n| 阶段 1，AC-1：分析入口一致性 | 静态候选存在；完整验收缺原始回执 | [`技能`](../../bmad-suite-v4/skills/ana-solo/SKILL.md:23)、[`模式`](../../bmad-suite-v4/roo/settings/custom_modes.yaml:5)、[`返修回归`](../../tests/roo_contracts/test_v4_analysis_repair.py:38) | 找回已有原始结果，核对覆盖版本；只在证据失效或确有缺口时定向重验 |\n| 阶段 1，AC-2：实验交接与失败不推进 | 静态契约可定位；运行结果缺证据 | [`工程规则`](../../bmad-suite-v4/roo/rules-bmad-engineer/01-bmad-engineer-core.md:5)和[`对账流程`](../../bmad-suite-v4/skills/bmad/references/procedures/state-reconcile.md:27) | 保留宿主和模型行为未验证边界，不把关键词断言当作行为证明 |\n| 阶段 1，AC-3：模板与元数据 | 接口静态可定位；本轮未运行校验 | [`模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md:17)、[`校验器`](../../scripts/validate-roo-contracts.py:172) | 核对已有校验回执与当前候选，未知会话标识保持空值 |\n| 阶段 1，AC-4：旧报告返修与引用 | 修订报告存在；历史审校摘要存在 | [`返修分析`](ANALYSIS-20261021-v4-backpressure-repair.md:9)保存缺陷、修正和引用；其正文不是测试回执 | 工程对齐原始差异及范围，保护用户改动，不重新执行报告清理 |\n| 阶段 1，AC-5：静态及隔离分发通过 | 历史摘要，原始回执缺失 | [`计划`](../pending_implementation_plan.md:89)记载三组通过及调用标识；[`隔离用例`](../../tests/roo_distribution/test_v4_analysis_distribution.py:16)只覆盖隔离磁盘资产 | 取得对应结果并核对适用输入；不继承为当前宿主绿灯 |\n| 阶段 2，AC-6：真实宿主切换与加载 | 明确未完成、待目标与权限实例化 | [`计划`](../pending_implementation_plan.md:91)及[`未决项`](../pending_implementation_plan.md:161) | 明确 IDE/扩展版本、部署根、配置范围、预检、重载、新会话及只读/结晶交互，另由工程验收 |\n| 阶段 3，AC-7：清理范围与删除后回归 | 缺完整清理与即时回归原始证据 | [`计划`](../pending_implementation_plan.md:100)定义授权范围与门禁，当前目录或文件缺席不能证明清理验收 | 优先找回已有清理结果、范围与删除后回归；不为补证重复删除 |\n| 阶段 3/4，AC-9：V5 源码退役、历史保留及拒绝边界 | 部分静态实现可定位；完整验收缺证据 | [`版本映射`](../../scripts/suite_versions.py:28)、[`普通入口身份检查`](../../bs.sh:241)、[`CI 退役回归入口`](../../.github/workflows/ci.yml:137) | 对齐旧源码退役、保留资产和拒绝无副作用回执，不恢复 V5 或误删历史 |\n| 阶段 4，AC-8：唯一 V4、缓存、锁、事务与调用方 | 静态实现及断言存在；本轮无运行结果 | [`安装`](../../install.sh:13)、[`分发`](../../bs.sh:386)、[`源采集`](../../scripts/deployment_source.py:29)、[`CI 契约`](../../tests/roo_contracts/test_ci_contracts.py:97) | 核对相关真实回归、语法结果与环境；缺证据只阻塞依赖它的裁决 |\n| 阶段 5，AC-10及接受、完成归档 | 未完成；不能闭环 | [`计划`](../pending_implementation_plan.md:118)与旧[`ADR`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:91)保留全部必需门禁 | 保全未完成项；真实宿主验收未通过前不接受旧 ADR，不完成归档 |\n\n### 检索边界与错误分类\n\n已对工作区材料检索旧计划标识及所列历史调用标识；返回的相关命中为计划、ADR 和分析摘要，未取得该 V4 任务的原始命令回执。指定验证目录的顶层列举包含历史阶段目录，不能仅凭日期认定其中证据属于当前任务，也不为本次决策加载全部 V5 历史。\n\n原生读取已取得本轮列明的规则、技能、模板、源码、CI 和报告。先前若干调用因中断未完成，后续必要读取已经补齐；中断不等于文件缺失。对已成功读取对象，没有收到权限拒绝或磁盘错误；不能将未取得回执解释为磁盘文件确定不存在。\n\n[`项目事实文件`](../project-context.md:1)首行含字面换行转义，并有历史路径表述；这是可读文本的格式与陈旧信息问题，不是已证明的磁盘错误或 YAML 损坏。本轮不修写事实基线。\n\n### 冻结交接条件\n\n最新用户确认允许工程进行冻结保全与默认入口交接，不要求旧任务先完成才能暂停保全；但不允许用冻结伪造完成。工程须保留阶段 2、阶段 3/4缺证据及最终收尾义务，旧 ADR 保持 PROPOSED。\n\n只有保全完整、目标不覆盖、源版本未变、关联引用安全交接的实际成功回执齐备，才释放默认入口。源变化、保全失败或唯一证据无法定位时保留源，停止入口替换。旧任务恢复须另获授权、新建保留来源的实例并重验。\n\n## 4. 研究材料重新裁决\n\n### 有效方法及归因边界\n\n- 按关注领域组织规范、按需加载，常驻入口只保存导航与稳定操作纪律：作为本项目设计原则采纳，不承诺固定窗口占用或自动加载。\n- 上游上下文约束与下游测试、类型检查、静态检查、构建反馈分别设计并组合。Huntley 名下的一手仓库给出下游背压及项目具体命令的说明；不据此证明本仓库效果。[6](cite:6)\n- 有意识压缩过程材料，保留当前契约、全部未完成事项、来源与未知：作为治理原则采纳。Dex Horthy 的具体归因和“完成后必须物理删除”说法未取得一手证据，不作作者事实。\n- 优先复用与内聚已有测试，不要求源码与测试一对一；持久回归与临时验证按用途、断言、缺陷及复现价值分类。\n- Huntley 的测试压缩到规范的方法明确针对跨语言移植；不是删除日常回归的依据。[11](cite:11)\n\n### 否决、降级及更正\n\n研究输入中固定窗口比例、行数阈值、成功率变化、97/98 分、全部门禁 PASS、100% 加载、“无未知”、测试新增必须为零、源码测试一对一、只保留 ACCEPTED ADR、完成自动改需求及删除计划的说法均不作为当前事实或验收。\n\nGo 测试分类不能将包内部未导出成员与 internal 目录导入范围混为同一限制；迁出是否可行须看包、模块、访问及工具链。文件名称带工单号不证明断言无价值，构建标签也不能让包外测试凭空获得未导出成员访问权。本报告不引用未取得的语言官方原文，不宣称已完成跨语言实测。\n\n本轮此前普通答复中的外部引用编号与 HumanLayer、定时运行终端行为归因没有相应已返回证据，撤回其证据效力。本报告仅使用已返回的一手来源片段；未取得的正文、目标版本和运行行为均明确保留未知。\n\n## 5. DM：硬门禁与实质候选\n\n| 硬门禁 | 当前事实与约束 | 裁决 |\n|---|---|---|\n| 权限 | [`模式白名单`](../../bmad-suite-v4/roo/settings/custom_modes.yaml:8)允许现有分析、ADR、历史计划与默认入口；新根入口和规范目录不在分析写入范围 | 本轮只写获准分析和提案；运行时限制效果未知 |\n| 旧活动计划保护 | 用户确认工程保全交接，未授权分析自行替换 | 本轮保持原入口；工程成功保全前阻塞新活动计划保存 |\n| 语言兼容 | 当前主要是 Shell、Python、Markdown；Go 为方法论适配场景 | 保留白盒同包和项目测试机制；没有跨语言实测通过结论 |\n| 回归不丢失 | 已有调用方、属性和副作用回归可定位 | 迁移须核对语义、发现与执行；源码存在不代表迁移后通过 |\n| 证据留存 | 历史原始回执不完整可得 | 不删除唯一证据；原始证据整理及适用输入核对待工程 |\n| 引用与路径 | 模式正则、默认路径、校验器及分发必需资产均硬编码 | 先修改相关契约与回归，再迁移；当前新路径兼容未通过 |\n| 宿主支持 | 有官方 Plan/Act 概述，安装版本和实际接口未知 | 可提出条件设计；目标版本与交互验收阻塞宿主实施 |\n\n| 候选 | 优点 | 代价与硬门禁 | 裁决 |\n|---|---|---|---|\n| A：保留旧布局，补职责与生命周期 | 复用路径、模板和测试，迁移风险低 | 通用入口和跨宿主发现仍需桥接与验收 | 过渡与失败回退方案，不宣称零配置接管 |\n| B：通用入口与目标布局，薄适配、分阶段迁移 | 明确资产职责，避免上下文双写，允许逐阶段保全 | 需先适配路径、加载和分发契约；宿主行为未知 | 推荐条件方案；当前仅结晶，不通过全部执行门禁 |\n| C：激进集中、合并或忽略产物 | 表面目录较少 | 机械迁 Go 白盒、丢回归/唯一回执、覆盖未完成计划或抹去 ADR 历史违反必要约束 | 这些变体硬门禁淘汰；不能靠删断言或豁免验收通过 |\n\n采用定性比较，无测量则不评分、不承诺提速或防幻觉百分比。若 B 的目标路径或宿主加载不支持，退回 A 的既有路径与显式读取，不强推物理迁移。\n\n现有[`DM 参考`](../../bmad-suite-v4/skills/ana-solo/references/decision-matrix.md:13)仍强制权重、固定候选数量和最高分裁决，与当前非机械证据规则冲突。新治理工程应精确修订该下层资产及相关断言；本轮不修改，不将它扩大为旧清理必须重做的理由。\n\n## 6. 目标布局与资产边界\n\n下列均为候选契约，不宣称已创建或行业统一标准。目录最终搬迁另获工程授权。\n\n| 职责 | 候选定位 | 提交、分发及保留边界 |\n|---|---|---|\n| 稳定项目入口 | [`AGENTS.md`](../../AGENTS.md) | 单一权威导航、纪律、构建与验证入口；不放逐轮进度，不整体复制事实基线 |\n| 领域规范 | [`specs/`](../../specs/) | 当前需求、接口、不变量、验收及相关 ADR 引用；项目内容不全局分发 |\n| 架构决策 | 过渡保留[`现有 ADR 目录`](../adrs/)，目标候选[`docs/adrs/`](../../docs/adrs/) | 保存必要 PROPOSED、ACCEPTED、历史及替代关系；不镜像规范或状态 |\n| 活动契约 | 过渡继续[`默认计划`](../pending_implementation_plan.md:1)，后续候选[`plans/pending_implementation_plan.md`](../../plans/pending_implementation_plan.md) | 单一活动入口；后续路径变更须显式确认并适配消费者 |\n| 历史计划 | 过渡[`archive/plans/`](../archive/plans/)，后续候选[`plans/archive/`](../../plans/archive/) | 完成含日期与唯一标识；冻结另加 frozen 后缀且保留未完成状态；敏感信息审查后决定同步，不能仅靠本地副本 |\n| 分析与旧报告 | 过渡[`analysis/`](../)，后续候选[`docs/analysis/`](../../docs/analysis/) | 保留证据、比较和未知；当前/历史/被替代/待核验分开标识，默认不加载历史，不等于删除 |\n| 持久测试及夹具 | 复用[`tests/`](../../tests/)与必要同包 Go 测试 | 必需回归随工程版本保留和提交；本仓库 CI 可见，不默认随插件运行分发 |\n| 临时工作区 | 过渡[`scratch/`](../scratch/)，后续候选[`.scratch/`](../../.scratch/) | 草稿与一次性探针按任务授权；忽略规则不是权限或证据可信度保证 |\n| 持久证据 | 过渡[`verification/`](../verification/)；目标目录暂不迁 | 原始回执可能是一手证据；摘要是解释。先保留来源、适用范围及唯一依赖，再裁决脱敏、同步与保留 |\n\n表中分析目录的过渡位置以本报告所在的现有 analysis 目录为准；不借此创建额外活跃计划。\n\n### 测试治理\n\n1. Python 默认集中，先复用当前测试分组；允许确有语言、工具或项目机制依据的例外，不强迫新建 unit/backpressure 等空层级。\n2. Go 白盒测试需访问未导出成员时留在业务包；黑盒与跨组件测试按合法模块、导入及发现机制集中，不为整洁导出内部状态、复制实现或削弱断言。\n3. 持久回归按缺陷、契约、不变量及必要 I/O/所有权/锁/恢复边界判定。跨组件安全回放可能同样是持久资产，不能归为一次性垃圾。\n4. 临时探针与运行输出分别治理。探针可不提交，但必要发现须形成可复现长期断言或保留唯一来源；原始输出不得混入测试源码目录充当回归。\n5. 模块/契约与测试多对多，先复用规范及目录验证入口；无真实检索困难不增加映射文件，不维护第二份状态账本。\n6. 优先内聚已有测试，不强制表驱动、源码一对一或单个巨型测试文件；数量减少不是验收，语义、发现和必要边界保留才是。\n\n### 方法论、规范与决策\n\n全局方法论只规定稳定授权、证据和治理原则；项目事实与需求属于项目。助手可以依据证据提出项目需求，不必全部手写，也不必等背压失败后才产生；重大变化由用户确认。动态背压发现不自动升级为全局规则。\n\n领域规范保存当前约束，ADR 保存为什么作出重要取舍。有效既有决策直接引用；只有新取舍才新建提案。测试通过不自动修改需求、接受 ADR 或登记项目事实。\n\n## 7. Cline Plan/Act 与 Roo 薄适配\n\nCline 官方概述将 Plan 描述为不改变文件的探索与规划，将 Act 描述为实施计划；因此不能把 Plan 直接保存分析文档当作已支持能力。[2](cite:2)\n\n| 问题 | 当前裁决 | 后续验收 |\n|---|---|---|\n| Plan 能否原生保存文档 | 未取得目标版本写入接口证据；默认会话交付。保存文档可另通过范围明确的获准写入步骤，不能借终端绕过 | 固定安装版本，核对工具与拒绝/允许回执 |\n| Plan 终端是否真正受限 | Insufficient evidence；官方模式名称不是执行级隔离证明，不能宣称终端不可能写入 | 目标版本源码与授权隔离交互分别核对 |\n| 点击 Act 是否授权 | 仅表示能力/交互切换；只有用户批准的具体计划、阶段和范围才构成本项目实施授权 | 记录输入、切换、绑定计划和工具审批；不自动授予安装、迁移、部署、提交 |\n| 规则是否自动加载 | 未取得目标版本加载机制及当前宿主结果 | 固定版本与规则位置，确认有效内容与优先级 |\n| 技能是否自动调用 | 技能发现、加载及模型调用分别未知；规则加载不等同技能执行 | 不要求用户记内部命令，但需行为路由验收 |\n| 模式条件字段 | 没有取得实际 schema，不提供猜测字段 | 按目标版本一手文档及源码实例化，不预造配置 |\n| Roo 权限适配 | 保留现有受限模式；静态白名单及版本执行效果分开 | 获准文档写入、生产/终端拒绝与工程验证分别记录 |\n\n本轮研究基于当前官方材料片段，不绑定未知安装版本，不宣称目标稳定版本已经确认。优先采用单一项目权威内容和薄宿主桥接；旧事实基线只引用、不双写、不在本轮改为根入口。\n\n当前[`源分发器`](../../scripts/deployment_source.py:81)将套件普通文件映射到 Gemini 插件和规则、Roo 规则与显式模式目标，未提供 Cline 专用映射。故“Cline 已安装/已加载”不是现状；新增适配必须保留现有所有权、源复核、锁与事务，不复制部署框架。\n\n## 8. DR 反向审查与修订\n\n| 反例 | 必须保留的修订 |\n|---|---|\n| 旧计划仍阻塞 | 可研究新任务；原入口在工程成功保全前不替换，未完成项不消失 |\n| 迁移中断或进程状态不明 | 分批出口，保留源、备份和诊断；不能声明全完成 |\n| 源内容并发变化 | 入口交接和批次写入前复核，变化停止，不覆盖他人改动 |\n| 相对引用失效 | 逐消费者核对引用；完整原始冻结副本保留原目录语境，禁止直接执行历史命令 |\n| 测试发现或 CI 收集丢失 | 迁移前后比较语义与发现范围；非零不是唯一充分条件，不删必需断言 |\n| Go 私有成员访问失败 | 留同包或否决迁出，不导出内部状态与复制实现 |\n| 唯一回执误删 | 清理前查引用和唯一依赖，先完整保全；摘要不能替代原始证据 |\n| 默认代理误读历史 | 活动入口指向明确，历史默认按需；忽略配置不承诺全部工具隐身 |\n| 全局规则污染项目 | 只全局分发方法论，项目需求、证据及私有内容保留项目边界 |\n| 宿主规则未加载 | 无法确认则显式读取及人工绑定，保持未知，不由磁盘文件推断加载 |\n\n## 9. 分阶段迁移与默认入口交接契约\n\n本节是供工程实例化的契约，不是已经保存的新活动计划。复用[`现有计划模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md:1)，候选新标识 BMAD-DOCUMENT-TEST-GOVERNANCE-20261022-01；状态 DRAFT、场景 structural、影响 M、会话空值、关联本轮 PROPOSED ADR。没有创建的新验证资产保持待创建，已有入口可用不等于通过。\n\n### F0：旧任务保全与入口释放\n\n- 依赖：最新冻结交接授权、工程实际权限、源与目标当前身份及所有权。\n- 源：[`旧活动计划`](../pending_implementation_plan.md:1)。目标候选：[`plan-20261022-BMAD-V4-ATTENDED-CLEANUP-20261021-01-frozen.md`](../archive/plans/plan-20261022-BMAD-V4-ATTENDED-CLEANUP-20261021-01-frozen.md)。若已占用，选择新唯一后缀，不覆盖。\n- 完整保存原字节并验证一致，保留所有未完成义务、证据缺口和源目录语境。冻结语义用保全后的历史说明与已核验任务记录表达，不伪造旧计划完成，也不猜校验器不支持的 FROZEN 枚举。\n- 核对旧[`ADR`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:6)、旧[`返修报告`](ANALYSIS-20261021-v4-backpressure-repair.md:5)及其他旧身份引用，修订导航不修订历史接受记录，不写事实基线。\n- 取得完整保存及最终源复核回执后，才在默认入口实例化新计划。未成功时保留旧入口，本轮分析不执行该步骤。\n\n### F1：治理契约与路径适配\n\n- 依赖：新计划身份、范围和本阶段工程授权。\n- 预期范围：[`分析技能`](../../bmad-suite-v4/skills/ana-solo/SKILL.md)、[`工程技能`](../../bmad-suite-v4/skills/bmad/SKILL.md)、[`DM 参考`](../../bmad-suite-v4/skills/ana-solo/references/decision-matrix.md)、相关共享与 Roo 规则、[`模式配置`](../../bmad-suite-v4/roo/settings/custom_modes.yaml)、[`计划模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md)、[`校验器`](../../scripts/validate-roo-contracts.py)及[`README.md`](../../README.md)。\n- 相关测试范围：[`规则契约`](../../tests/roo_contracts/)、[`分发回归`](../../tests/roo_distribution/)。按最终改动选用现有断言，必要新行为用例先创建；不固定数量，不盲跑全库。\n- 不移动内容先改职责和消费者；新增路径允许范围应精确，不扩分析终端权限。只修改方法论与模板，不将项目规范全局分发。\n- 出口：现有入口兼容、拒绝路径和新路径规则有真实相关回执；未知宿主行为不被静态结果替代。\n\n### F2：薄宿主桥接的设计与隔离验证\n\n- 依赖：指定 Cline/Roo 版本、原生规则/技能接口及明确隔离范围；本轮无启动授权。\n- 预期范围：仅获准项目内桥接、模板及相关分发消费者。真实全局宿主路径不实例化，不提供猜测 mode 条件字段。\n- 验证项目入口单源、规则发现与技能调用分离、Plan 会话分析与获准文档保存分离、Act 绑定具体计划及审批；Roo 保留权限组和受限路径适配。\n- 未取得接口则保留方案 A 的显式读取，不创建第二份项目上下文，不用软链接绕过现有物理分发拒绝边界。\n\n### F3：文档、测试和证据的分批迁移\n\n- 依赖：另行生产迁移授权、最终逐文件清单、引用及唯一证据盘点；本轮仅设计。\n- 每项清单记录源、目标、用途、必要引用、发现/调用方、所有权、保全方式及失败恢复；不存在的目标标待实现，不虚构全部文件清单。\n- 测试优先复用现有集中结构，允许必要 Go 同包；文档逐项分类为当前、历史、被替代或待核验。证据目标未裁决前保持原位。\n- 出口：引用与测试发现可用、必要语义和副作用回归保留、跨机器证据策略明确；失败只恢复本批次获准改动，保留其他用户差异，不进行全库恢复。\n\n### F4：明确目标的宿主验收与阶段交付\n\n- 依赖：独立真实宿主授权、目标版本、写入范围和交互入口；不由 Act 点击、安装或重载自动授权。\n- 验收：有效规则身份、只读任务无持久写入、获准文档保存、生产与终端拒绝边界、工程验证、第三方资产保留，分别记录输入、请求和实际结果。\n- 旧阶段 2 是否可复用新结果必须核对旧目标与验收，不能自动以新任务通过代替旧任务。\n- 仅当前全部必需义务有真实证据才交付阶段；新 ADR 接受、事实更新、提交推送及完成归档分别按授权处理。\n\n### 已定位验证入口与执行纪律\n\n工程接管在仓库根，使用已有 [`validate-roo-contracts.py`](../../scripts/validate-roo-contracts.py:233)显式校验实际绑定计划：GNU timeout 的 30 秒上限、2 秒强杀宽限、Python 禁止字节码、标准输入封闭。命令参数必须使用工程实际保存并绑定的路径，不把本报告当作计划传入。\n\n相关规则与 CI 验证复用[`test_v4_analysis_repair.py`](../../tests/roo_contracts/test_v4_analysis_repair.py:38)和[`test_ci_contracts.py`](../../tests/roo_contracts/test_ci_contracts.py:13)；分发影响复用[`test_v4_analysis_distribution.py`](../../tests/roo_distribution/test_v4_analysis_distribution.py:16)以及实际受影响的所有权、身份、锁、缓存和恢复用例。改变布局后先适配真实用例及收集入口，不能保留失效路径后称验证可用。\n\n具体可执行命令及新增验证资产由工程在默认计划实例化时填写，本报告不复制另一套命令流水。探测、验证、构建分别限时 15、30、600 秒，串行前台、输入封闭；本地缺依赖则阻塞，环境准备不得隐式联网。回执保留工作目录、命令、退出、输出、目标、适用输入、非零收集与必需项无跳过；已有有效且未受影响的证据不重复执行。\n\n## 10. 停止条件与保留未知\n\n当前足以决定职责分离、拒绝激进删测及先保全后交接；无需以未经授权的实测为结晶前提。仍未知的目标版本、自动加载、实际权限、原始旧回执和逐文件迁移范围，分别阻塞对应工程步骤，不阻塞本报告的条件决策。\n\n新活动计划尚未保存：默认入口仍由旧任务占用，用户未选择另一个并行活动入口。工程保全及交接成功后才保存新契约；本轮只保存报告与必要决策提案，不将报告或归档目录伪装为活动计划。\n\n## 11. 外部证据索引\n\n- [2](cite:2) Cline 官方 Plan & Act Mode：本轮返回模式概述片段；不作为目标安装版本或终端隔离证据。\n- [6](cite:6) Geoffrey Huntley 名下 how-to-ralph-wiggum 一手仓库：本轮返回下游背压及项目具体命令片段；不引用未核实的整段 Playbook 原句。\n- [11](cite:11) Geoffrey Huntley 的 porting 原文：本轮返回跨语言移植及测试压缩片段；不外推为删除日常回归。\n- Dex Horthy/HumanLayer 一手原文未取得，相关检索因预算限制没有返回来源；作者归因保留未知。本报告没有采用非一手聚合材料或编造来源编号。\n"}}

{"name":"write_to_file","arguments":{"path":"_bmad-output/analysis/ANALYSIS-20261022-document-test-governance.md","content":"# 文档、测试与跨宿主入口治理：旧任务对账及新方案裁决\n\n- 日期：2026-10-22。\n- 交付性质：分析与治理提案；不是实施、冻结、归档或宿主验收回执。\n- 旧契约：[`pending_implementation_plan.md`](../pending_implementation_plan.md:1)，标识 BMAD-V4-ATTENDED-CLEANUP-20261021-01。\n- 旧决策：[`ADR-20261021-v4-attended-repair-and-repository-cleanup.md`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:3)。\n- 指定研究输入：[`bmad-document-test-optimse.md`](../../docs/Ralph-Wiggum-Loop/bmad-document-test-optimse.md:3)。\n- 本次授权：只读对账旧任务；保存必要分析与 PROPOSED 决策；形成治理及迁移契约。用户随后明确确认，冻结保全和默认入口交接交给获准工程入口，不自动启动；实际文件迁移以后另行授权。\n- 本报告不改变旧计划、旧 ADR、项目事实基线、生产文件、分发目标或当前宿主配置。没有执行终端、测试、探针、安装或 Git 操作。\n\n## 1. 最小充分结论\n\n旧任务不能按完成收尾：最新回读仍为 BLOCKED，旧 ADR 仍为 PROPOSED；宿主验收明确未完成，部分本地验收只有历史摘要，没有取得原始回执。保留旧验收，不重复清理，不通过冻结消除未完成义务。依据见旧[`计划阶段与未决项`](../pending_implementation_plan.md:79)和旧[`ADR 接受边界`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:87)。\n\n推荐“职责分离的通用入口与目标布局＋薄宿主适配＋分阶段迁移”。当前可结晶设计，不能宣布运行可行门禁全部通过。新计划仍以默认入口为目标，须在工程完成旧计划保全及引用交接之后接入；本报告的交接契约不是第二份活动计划。\n\n必要非目标：不迁移或删除现有资产，不取消旧验收，不自动启动冻结工程，不实施 Cline/Roo 适配，不新增终端权限，不将研究材料中的目录名称、评分或比例冒充行业标准。\n\n## 2. 三遍阅读与证据分层\n\n### 第一遍：范围、职责和验收\n\n问题是长期资产、临时过程、当前契约和宿主入口职责混用，不是测试文件或日期命名本身有错。研究材料提出的痛点作为用户问题线索；材料中其他私有项目的截图、缺陷和因果推断不外推为本仓库事实。\n\n当前契约要求保留语言封装、回归能力、历史决策、唯一证据和跨宿主接管。成功不能用目录数量、新增测试数量为零或文件数减半定义。\n\n### 第二遍：依据等级\n\n- 用户授权：本轮结晶与最新冻结交接确认；不等同于工程已经执行。\n- 当前源码事实：模式白名单、校验器、测试断言、分发映射及 CI 文本可以定位；不等同于通过或加载。\n- 历史摘要：旧计划保存的阶段通过摘要和平台调用标识；未取得原始结果时不能认定已重新核验有效。\n- 外部一手资料：当前检索返回的官方文档与作者原文片段；没有目标安装版本、固定源码版本和宿主交互回执。\n- 逻辑推断：职责分离和保全先行可以降低已识别的覆盖风险；未测量维护成本或模型效果。\n- 未知：现有改动与历史回执是否一致、目标宿主实际加载与权限行为、研究中部分作者归因及完整原文。\n\n### 第三遍：虚拟重实现\n\n先切入口会丢失旧任务定位；先移动文件会破坏硬编码路径和测试发现；仅合并测试可能丢断言或白盒访问；仅忽略目录可能屏蔽唯一证据；只放通用入口不能证明宿主自动加载。故先保全与契约适配，再分批迁移，分别验证静态、磁盘分发和真实宿主交互。该推演不是实测。\n\n## 3. 旧任务逐阶段、逐验收对账\n\n### 判定口径\n\n“已完成且证据有效”须能核对原始命令、工作目录、实际退出状态、关键输出、目标及适用输入；历史摘要不代替原始回执。当前没有取得足以将某一完整工程阶段重新登记为该类别的原始证据。已有历史记录保留，不据此推断过去没有执行。\n\n| 阶段／验收 | 本轮判定 | 依据及覆盖范围 | 最小剩余事项 |\n|---|---|---|---|\n| 阶段 0：接管、所有权和在途边界 | 有历史摘要；当前写入边界缺证据 | [`计划`](../pending_implementation_plan.md:72)明确进程名称检查不足以证明绑定资产安全写入；清理边界调用标识见[`计划`](../pending_implementation_plan.md:67) | 工程在实际写入前只核对相关所有权、现有改动和在途操作，不由分析运行终端 |\n| 阶段 1，AC-1：分析入口一致性 | 静态候选存在；完整验收缺原始回执 | [`技能`](../../bmad-suite-v4/skills/ana-solo/SKILL.md:23)、[`模式`](../../bmad-suite-v4/roo/settings/custom_modes.yaml:5)、[`返修回归`](../../tests/roo_contracts/test_v4_analysis_repair.py:38) | 找回已有原始结果，核对覆盖版本；只在证据失效或确有缺口时定向重验 |\n| 阶段 1，AC-2：实验交接与失败不推进 | 静态契约可定位；运行结果缺证据 | [`工程规则`](../../bmad-suite-v4/roo/rules-bmad-engineer/01-bmad-engineer-core.md:5)和[`对账流程`](../../bmad-suite-v4/skills/bmad/references/procedures/state-reconcile.md:27) | 保留宿主和模型行为未验证边界，不把关键词断言当作行为证明 |\n| 阶段 1，AC-3：模板与元数据 | 接口静态可定位；本轮未运行校验 | [`模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md:17)、[`校验器`](../../scripts/validate-roo-contracts.py:172) | 核对已有校验回执与当前候选，未知会话标识保持空值 |\n| 阶段 1，AC-4：旧报告返修与引用 | 修订报告存在；历史审校摘要存在 | [`返修分析`](ANALYSIS-20261021-v4-backpressure-repair.md:9)保存缺陷、修正和引用；其正文不是测试回执 | 工程对齐原始差异及范围，保护用户改动，不重新执行报告清理 |\n| 阶段 1，AC-5：静态及隔离分发通过 | 历史摘要，原始回执缺失 | [`计划`](../pending_implementation_plan.md:89)记载三组通过及调用标识；[`隔离用例`](../../tests/roo_distribution/test_v4_analysis_distribution.py:16)只覆盖隔离磁盘资产 | 取得对应结果并核对适用输入；不继承为当前宿主绿灯 |\n| 阶段 2，AC-6：真实宿主切换与加载 | 明确未完成、待目标与权限实例化 | [`计划`](../pending_implementation_plan.md:91)及[`未决项`](../pending_implementation_plan.md:161) | 明确 IDE/扩展版本、部署根、配置范围、预检、重载、新会话及只读/结晶交互，另由工程验收 |\n| 阶段 3，AC-7：清理范围与删除后回归 | 缺完整清理与即时回归原始证据 | [`计划`](../pending_implementation_plan.md:100)定义授权范围与门禁，当前目录或文件缺席不能证明清理验收 | 优先找回已有清理结果、范围与删除后回归；不为补证重复删除 |\n| 阶段 3/4，AC-9：V5 源码退役、历史保留及拒绝边界 | 部分静态实现可定位；完整验收缺证据 | [`版本映射`](../../scripts/suite_versions.py:28)、[`普通入口身份检查`](../../bs.sh:241)、[`CI 退役回归入口`](../../.github/workflows/ci.yml:137) | 对齐旧源码退役、保留资产和拒绝无副作用回执，不恢复 V5 或误删历史 |\n| 阶段 4，AC-8：唯一 V4、缓存、锁、事务与调用方 | 静态实现及断言存在；本轮无运行结果 | [`安装`](../../install.sh:13)、[`分发`](../../bs.sh:386)、[`源采集`](../../scripts/deployment_source.py:29)、[`CI 契约`](../../tests/roo_contracts/test_ci_contracts.py:97) | 核对相关真实回归、语法结果与环境；缺证据只阻塞依赖它的裁决 |\n| 阶段 5，AC-10及接受、完成归档 | 未完成；不能闭环 | [`计划`](../pending_implementation_plan.md:118)与旧[`ADR`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:91)保留全部必需门禁 | 保全未完成项；真实宿主验收未通过前不接受旧 ADR，不完成归档 |\n\n### 检索边界与错误分类\n\n已对工作区材料检索旧计划标识及所列历史调用标识；返回的相关命中为计划、ADR 和分析摘要，未取得该 V4 任务的原始命令回执。指定验证目录的顶层列举包含历史阶段目录，不能仅凭日期认定其中证据属于当前任务，也不为本次决策加载全部 V5 历史。\n\n原生读取已取得本轮列明的规则、技能、模板、源码、CI 和报告。先前若干调用因中断未完成，后续必要读取已经补齐；中断不等于文件缺失。对已成功读取对象，没有收到权限拒绝或磁盘错误；不能将未取得回执解释为磁盘文件确定不存在。\n\n[`项目事实文件`](../project-context.md:1)首行含字面换行转义，并有历史路径表述；这是可读文本的格式与陈旧信息问题，不是已证明的磁盘错误或 YAML 损坏。本轮不修写事实基线。\n\n### 冻结交接条件\n\n最新用户确认允许工程进行冻结保全与默认入口交接，不要求旧任务先完成才能暂停保全；但不允许用冻结伪造完成。工程须保留阶段 2、阶段 3/4缺证据及最终收尾义务，旧 ADR 保持 PROPOSED。\n\n只有保全完整、目标不覆盖、源版本未变、关联引用安全交接的实际成功回执齐备，才释放默认入口。源变化、保全失败或唯一证据无法定位时保留源，停止入口替换。旧任务恢复须另获授权、新建保留来源的实例并重验。\n\n## 4. 研究材料重新裁决\n\n### 有效方法及归因边界\n\n- 按关注领域组织规范、按需加载，常驻入口只保存导航与稳定操作纪律：作为本项目设计原则采纳，不承诺固定窗口占用或自动加载。\n- 上游上下文约束与下游测试、类型检查、静态检查、构建反馈分别设计并组合。Huntley 名下的一手仓库给出下游背压及项目具体命令的说明；不据此证明本仓库效果。[6](cite:6)\n- 有意识压缩过程材料，保留当前契约、全部未完成事项、来源与未知：作为治理原则采纳。Dex Horthy 的具体归因和“完成后必须物理删除”说法未取得一手证据，不作作者事实。\n- 优先复用与内聚已有测试，不要求源码与测试一对一；持久回归与临时验证按用途、断言、缺陷及复现价值分类。\n- Huntley 的测试压缩到规范的方法明确针对跨语言移植；不是删除日常回归的依据。[11](cite:11)\n\n### 否决、降级及更正\n\n研究输入中固定窗口比例、行数阈值、成功率变化、97/98 分、全部门禁 PASS、100% 加载、“无未知”、测试新增必须为零、源码测试一对一、只保留 ACCEPTED ADR、完成自动改需求及删除计划的说法均不作为当前事实或验收。\n\nGo 测试分类不能将包内部未导出成员与 internal 目录导入范围混为同一限制；迁出是否可行须看包、模块、访问及工具链。文件名称带工单号不证明断言无价值，构建标签也不能让包外测试凭空获得未导出成员访问权。本报告不引用未取得的语言官方原文，不宣称已完成跨语言实测。\n\n本轮此前普通答复中的外部引用编号与 HumanLayer、定时运行终端行为归因没有相应已返回证据，撤回其证据效力。本报告仅使用已返回的一手来源片段；未取得的正文、目标版本和运行行为均明确保留未知。\n\n## 5. DM：硬门禁与实质候选\n\n| 硬门禁 | 当前事实与约束 | 裁决 |\n|---|---|---|\n| 权限 | [`模式白名单`](../../bmad-suite-v4/roo/settings/custom_modes.yaml:8)允许现有分析、ADR、历史计划与默认入口；新根入口和规范目录不在分析写入范围 | 本轮只写获准分析和提案；运行时限制效果未知 |\n| 旧活动计划保护 | 用户确认工程保全交接，未授权分析自行替换 | 本轮保持原入口；工程成功保全前阻塞新活动计划保存 |\n| 语言兼容 | 当前主要是 Shell、Python、Markdown；Go 为方法论适配场景 | 保留白盒同包和项目测试机制；没有跨语言实测通过结论 |\n| 回归不丢失 | 已有调用方、属性和副作用回归可定位 | 迁移须核对语义、发现与执行；源码存在不代表迁移后通过 |\n| 证据留存 | 历史原始回执不完整可得 | 不删除唯一证据；原始证据整理及适用输入核对待工程 |\n| 引用与路径 | 模式正则、默认路径、校验器及分发必需资产均硬编码 | 先修改相关契约与回归，再迁移；当前新路径兼容未通过 |\n| 宿主支持 | 有官方 Plan/Act 概述，安装版本和实际接口未知 | 可提出条件设计；目标版本与交互验收阻塞宿主实施 |\n\n| 候选 | 优点 | 代价与硬门禁 | 裁决 |\n|---|---|---|---|\n| A：保留旧布局，补职责与生命周期 | 复用路径、模板和测试，迁移风险低 | 通用入口和跨宿主发现仍需桥接与验收 | 过渡与失败回退方案，不宣称零配置接管 |\n| B：通用入口与目标布局，薄适配、分阶段迁移 | 明确资产职责，避免上下文双写，允许逐阶段保全 | 需先适配路径、加载和分发契约；宿主行为未知 | 推荐条件方案；当前仅结晶，不通过全部执行门禁 |\n| C：激进集中、合并或忽略产物 | 表面目录较少 | 机械迁 Go 白盒、丢回归/唯一回执、覆盖未完成计划或抹去 ADR 历史违反必要约束 | 这些变体硬门禁淘汰；不能靠删断言或豁免验收通过 |\n\n采用定性比较，无测量则不评分、不承诺提速或防幻觉百分比。若 B 的目标路径或宿主加载不支持，退回 A 的既有路径与显式读取，不强推物理迁移。\n\n现有[`DM 参考`](../../bmad-suite-v4/skills/ana-solo/references/decision-matrix.md:13)仍强制权重、固定候选数量和最高分裁决，与当前非机械证据规则冲突。新治理工程应精确修订该下层资产及相关断言；本轮不修改，不将它扩大为旧清理必须重做的理由。\n\n## 6. 目标布局与资产边界\n\n下列均为候选契约，不宣称已创建或行业统一标准。目录最终搬迁另获工程授权。\n\n| 职责 | 候选定位 | 提交、分发及保留边界 |\n|---|---|---|\n| 稳定项目入口 | [`AGENTS.md`](../../AGENTS.md) | 单一权威导航、纪律、构建与验证入口；不放逐轮进度，不整体复制事实基线 |\n| 领域规范 | [`specs/`](../../specs/) | 当前需求、接口、不变量、验收及相关 ADR 引用；项目内容不全局分发 |\n| 架构决策 | 过渡保留[`现有 ADR 目录`](../adrs/)，目标候选[`docs/adrs/`](../../docs/adrs/) | 保存必要 PROPOSED、ACCEPTED、历史及替代关系；不镜像规范或状态 |\n| 活动契约 | 过渡继续[`默认计划`](../pending_implementation_plan.md:1)，后续候选[`plans/pending_implementation_plan.md`](../../plans/pending_implementation_plan.md) | 单一活动入口；后续路径变更须显式确认并适配消费者 |\n| 历史计划 | 过渡[`archive/plans/`](../archive/plans/)，后续候选[`plans/archive/`](../../plans/archive/) | 完成含日期与唯一标识；冻结另加 frozen 后缀且保留未完成状态；敏感信息审查后决定同步，不能仅靠本地副本 |\n| 分析与旧报告 | 过渡[`analysis/`](../)，后续候选[`docs/analysis/`](../../docs/analysis/) | 保留证据、比较和未知；当前/历史/被替代/待核验分开标识，默认不加载历史，不等于删除 |\n| 持久测试及夹具 | 复用[`tests/`](../../tests/)与必要同包 Go 测试 | 必需回归随工程版本保留和提交；本仓库 CI 可见，不默认随插件运行分发 |\n| 临时工作区 | 过渡[`scratch/`](../scratch/)，后续候选[`.scratch/`](../../.scratch/) | 草稿与一次性探针按任务授权；忽略规则不是权限或证据可信度保证 |\n| 持久证据 | 过渡[`verification/`](../verification/)；目标目录暂不迁 | 原始回执可能是一手证据；摘要是解释。先保留来源、适用范围及唯一依赖，再裁决脱敏、同步与保留 |\n\n表中分析目录的过渡位置以本报告所在的现有 analysis 目录为准；不借此创建额外活跃计划。\n\n### 测试治理\n\n1. Python 默认集中，先复用当前测试分组；允许确有语言、工具或项目机制依据的例外，不强迫新建 unit/backpressure 等空层级。\n2. Go 白盒测试需访问未导出成员时留在业务包；黑盒与跨组件测试按合法模块、导入及发现机制集中，不为整洁导出内部状态、复制实现或削弱断言。\n3. 持久回归按缺陷、契约、不变量及必要 I/O/所有权/锁/恢复边界判定。跨组件安全回放可能同样是持久资产，不能归为一次性垃圾。\n4. 临时探针与运行输出分别治理。探针可不提交，但必要发现须形成可复现长期断言或保留唯一来源；原始输出不得混入测试源码目录充当回归。\n5. 模块/契约与测试多对多，先复用规范及目录验证入口；无真实检索困难不增加映射文件，不维护第二份状态账本。\n6. 优先内聚已有测试，不强制表驱动、源码一对一或单个巨型测试文件；数量减少不是验收，语义、发现和必要边界保留才是。\n\n### 方法论、规范与决策\n\n全局方法论只规定稳定授权、证据和治理原则；项目事实与需求属于项目。助手可以依据证据提出项目需求，不必全部手写，也不必等背压失败后才产生；重大变化由用户确认。动态背压发现不自动升级为全局规则。\n\n领域规范保存当前约束，ADR 保存为什么作出重要取舍。有效既有决策直接引用；只有新取舍才新建提案。测试通过不自动修改需求、接受 ADR 或登记项目事实。\n\n## 7. Cline Plan/Act 与 Roo 薄适配\n\nCline 官方概述将 Plan 描述为不改变文件的探索与规划，将 Act 描述为实施计划；因此不能把 Plan 直接保存分析文档当作已支持能力。[2](cite:2)\n\n| 问题 | 当前裁决 | 后续验收 |\n|---|---|---|\n| Plan 能否原生保存文档 | 未取得目标版本写入接口证据；默认会话交付。保存文档可另通过范围明确的获准写入步骤，不能借终端绕过 | 固定安装版本，核对工具与拒绝/允许回执 |\n| Plan 终端是否真正受限 | Insufficient evidence；官方模式名称不是执行级隔离证明，不能宣称终端不可能写入 | 目标版本源码与授权隔离交互分别核对 |\n| 点击 Act 是否授权 | 仅表示能力/交互切换；只有用户批准的具体计划、阶段和范围才构成本项目实施授权 | 记录输入、切换、绑定计划和工具审批；不自动授予安装、迁移、部署、提交 |\n| 规则是否自动加载 | 未取得目标版本加载机制及当前宿主结果 | 固定版本与规则位置，确认有效内容与优先级 |\n| 技能是否自动调用 | 技能发现、加载及模型调用分别未知；规则加载不等同技能执行 | 不要求用户记内部命令，但需行为路由验收 |\n| 模式条件字段 | 没有取得实际 schema，不提供猜测字段 | 按目标版本一手文档及源码实例化，不预造配置 |\n| Roo 权限适配 | 保留现有受限模式；静态白名单及版本执行效果分开 | 获准文档写入、生产/终端拒绝与工程验证分别记录 |\n\n本轮研究基于当前官方材料片段，不绑定未知安装版本，不宣称目标稳定版本已经确认。优先采用单一项目权威内容和薄宿主桥接；旧事实基线只引用、不双写、不在本轮改为根入口。\n\n当前[`源分发器`](../../scripts/deployment_source.py:81)将套件普通文件映射到 Gemini 插件和规则、Roo 规则与显式模式目标，未提供 Cline 专用映射。故“Cline 已安装/已加载”不是现状；新增适配必须保留现有所有权、源复核、锁与事务，不复制部署框架。\n\n## 8. DR 反向审查与修订\n\n| 反例 | 必须保留的修订 |\n|---|---|\n| 旧计划仍阻塞 | 可研究新任务；原入口在工程成功保全前不替换，未完成项不消失 |\n| 迁移中断或进程状态不明 | 分批出口，保留源、备份和诊断；不能声明全完成 |\n| 源内容并发变化 | 入口交接和批次写入前复核，变化停止，不覆盖他人改动 |\n| 相对引用失效 | 逐消费者核对引用；完整原始冻结副本保留原目录语境，禁止直接执行历史命令 |\n| 测试发现或 CI 收集丢失 | 迁移前后比较语义与发现范围；非零不是唯一充分条件，不删必需断言 |\n| Go 私有成员访问失败 | 留同包或否决迁出，不导出内部状态与复制实现 |\n| 唯一回执误删 | 清理前查引用和唯一依赖，先完整保全；摘要不能替代原始证据 |\n| 默认代理误读历史 | 活动入口指向明确，历史默认按需；忽略配置不承诺全部工具隐身 |\n| 全局规则污染项目 | 只全局分发方法论，项目需求、证据及私有内容保留项目边界 |\n| 宿主规则未加载 | 无法确认则显式读取及人工绑定，保持未知，不由磁盘文件推断加载 |\n\n## 9. 分阶段迁移与默认入口交接契约\n\n本节是供工程实例化的契约，不是已经保存的新活动计划。复用[`现有计划模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md:1)，候选新标识 BMAD-DOCUMENT-TEST-GOVERNANCE-20261022-01；状态 DRAFT、场景 structural、影响 M、会话空值、关联本轮 PROPOSED ADR。没有创建的新验证资产保持待创建，已有入口可用不等于通过。\n\n### F0：旧任务保全与入口释放\n\n- 依赖：最新冻结交接授权、工程实际权限、源与目标当前身份及所有权。\n- 源：[`旧活动计划`](../pending_implementation_plan.md:1)。目标候选：[`plan-20261022-BMAD-V4-ATTENDED-CLEANUP-20261021-01-frozen.md`](../archive/plans/plan-20261022-BMAD-V4-ATTENDED-CLEANUP-20261021-01-frozen.md)。若已占用，选择新唯一后缀，不覆盖。\n- 完整保存原字节并验证一致，保留所有未完成义务、证据缺口和源目录语境。冻结语义用保全后的历史说明与已核验任务记录表达，不伪造旧计划完成，也不猜校验器不支持的 FROZEN 枚举。\n- 核对旧[`ADR`](../adrs/ADR-20261021-v4-attended-repair-and-repository-cleanup.md:6)、旧[`返修报告`](ANALYSIS-20261021-v4-backpressure-repair.md:5)及其他旧身份引用，修订导航不修订历史接受记录，不写事实基线。\n- 取得完整保存及最终源复核回执后，才在默认入口实例化新计划。未成功时保留旧入口，本轮分析不执行该步骤。\n\n### F1：治理契约与路径适配\n\n- 依赖：新计划身份、范围和本阶段工程授权。\n- 预期范围：[`分析技能`](../../bmad-suite-v4/skills/ana-solo/SKILL.md)、[`工程技能`](../../bmad-suite-v4/skills/bmad/SKILL.md)、[`DM 参考`](../../bmad-suite-v4/skills/ana-solo/references/decision-matrix.md)、相关共享与 Roo 规则、[`模式配置`](../../bmad-suite-v4/roo/settings/custom_modes.yaml)、[`计划模板`](../../bmad-suite-v4/skills/bmad/references/templates/implementation-plan.template.md)、[`校验器`](../../scripts/validate-roo-contracts.py)及[`README.md`](../../README.md)。\n- 相关测试范围：[`规则契约`](../../tests/roo_contracts/)、[`分发回归`](../../tests/roo_distribution/)。按最终改动选用现有断言，必要新行为用例先创建；不固定数量，不盲跑全库。\n- 不移动内容先改职责和消费者；新增路径允许范围应精确，不扩分析终端权限。只修改方法论与模板，不将项目规范全局分发。\n- 出口：现有入口兼容、拒绝路径和新路径规则有真实相关回执；未知宿主行为不被静态结果替代。\n\n### F2：薄宿主桥接的设计与隔离验证\n\n- 依赖：指定 Cline/Roo 版本、原生规则/技能接口及明确隔离范围；本轮无启动授权。\n- 预期范围：仅获准项目内桥接、模板及相关分发消费者。真实全局宿主路径不实例化，不提供猜测 mode 条件字段。\n- 验证项目入口单源、规则发现与技能调用分离、Plan 会话分析与获准文档保存分离、Act 绑定具体计划及审批；Roo 保留权限组和受限路径适配。\n- 未取得接口则保留方案 A 的显式读取，不创建第二份项目上下文，不用软链接绕过现有物理分发拒绝边界。\n\n### F3：文档、测试和证据的分批迁移\n\n- 依赖：另行生产迁移授权、最终逐文件清单、引用及唯一证据盘点；本轮仅设计。\n- 每项清单记录源、目标、用途、必要引用、发现/调用方、所有权、保全方式及失败恢复；不存在的目标标待实现，不虚构全部文件清单。\n- 测试优先复用现有集中结构，允许必要 Go 同包；文档逐项分类为当前、历史、被替代或待核验。证据目标未裁决前保持原位。\n- 出口：引用与测试发现可用、必要语义和副作用回归保留、跨机器证据策略明确；失败只恢复本批次获准改动，保留其他用户差异，不进行全库恢复。\n\n### F4：明确目标的宿主验收与阶段交付\n\n- 依赖：独立真实宿主授权、目标版本、写入范围和交互入口；不由 Act 点击、安装或重载自动授权。\n- 验收：有效规则身份、只读任务无持久写入、获准文档保存、生产与终端拒绝边界、工程验证、第三方资产保留，分别记录输入、请求和实际结果。\n- 旧阶段 2 是否可复用新结果必须核对旧目标与验收，不能自动以新任务通过代替旧任务。\n- 仅当前全部必需义务有真实证据才交付阶段；新 ADR 接受、事实更新、提交推送及完成归档分别按授权处理。\n\n### 已定位验证入口与执行纪律\n\n工程接管在仓库根，使用已有 [`validate-roo-contracts.py`](../../scripts/validate-roo-contracts.py:233)显式校验实际绑定计划：GNU timeout 的 30 秒上限、2 秒强杀宽限、Python 禁止字节码、标准输入封闭。命令参数必须使用工程实际保存并绑定的路径，不把本报告当作计划传入。\n\n相关规则与 CI 验证复用[`test_v4_analysis_repair.py`](../../tests/roo_contracts/test_v4_analysis_repair.py:38)和[`test_ci_contracts.py`](../../tests/roo_contracts/test_ci_contracts.py:13)；分发影响复用[`test_v4_analysis_distribution.py`](../../tests/roo_distribution/test_v4_analysis_distribution.py:16)以及实际受影响的所有权、身份、锁、缓存和恢复用例。改变布局后先适配真实用例及收集入口，不能保留失效路径后称验证可用。\n\n具体可执行命令及新增验证资产由工程在默认计划实例化时填写，本报告不复制另一套命令流水。探测、验证、构建分别限时 15、30、600 秒，串行前台、输入封闭；本地缺依赖则阻塞，环境准备不得隐式联网。回执保留工作目录、命令、退出、输出、目标、适用输入、非零收集与必需项无跳过；已有有效且未受影响的证据不重复执行。\n\n## 10. 停止条件与保留未知\n\n当前足以决定职责分离、拒绝激进删测及先保全后交接；无需以未经授权的实测为结晶前提。仍未知的目标版本、自动加载、实际权限、原始旧回执和逐文件迁移范围，分别阻塞对应工程步骤，不阻塞本报告的条件决策。\n\n新活动计划尚未保存：默认入口仍由旧任务占用，用户未选择另一个并行活动入口。工程保全及交接成功后才保存新契约；本轮只保存报告与必要决策提案，不将报告或归档目录伪装为活动计划。\n\n## 11. 外部证据索引\n\n- [2](cite:2) Cline 官方 Plan & Act Mode：本轮返回模式概述片段；不作为目标安装版本或终端隔离证据。\n- [6](cite:6) Geoffrey Huntley 名下 how-to-ralph-wiggum 一手仓库：本轮返回下游背压及项目具体命令片段；不引用未核实的整段 Playbook 原句。\n- [11](cite:11) Geoffrey Huntley 的 porting 原文：本轮返回跨语言移植及测试压缩片段；不外推为删除日常回归。\n- Dex Horthy/HumanLayer 一手原文未取得，相关检索因预算限制没有返回来源；作者归因保留未知。本报告没有采用非一手聚合材料或编造来源编号。\n"}}