@givolt/i3-composer-agent 2.3.7 → 3.0.0

package/references/enterprise-sop-resources/prd/templates/PRD.md

@@ -0,0 +1,257 @@
+# PRD 模板草案
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+模板版本：v0.0.4。日期：2026-10-17。状态：待评审，未作为运行技能安装。
+
+采用[模板与交接合同](../template-contracts.md)。一个 PBC 可以有多个需求主题，每个主题有独立 `prdId` 和版本序列。实例文件名为 `{PBC}-{需求主题}-PRD_v0.0.1.md`。本模板同时维护完整产品定义、具体行为和验收条件，不要求另建行为故事文档。字段/API/数据库等工程实现进入 [AD](AD.md)。
+
+Feature 表示功能分组，Story 表示可独立描述和验收的用户行为，两者保留在 PRD 内，不增加交付阶段或目录层。已有 FT/US/FR/AC 标识沿用；只读历史行为文档可以作为固定来源，不要求另建行为故事文档。完整行为与 AC 填写要求见第6章，交接检查见第10.2节。本模板升级不自动修改业务实例、采用关系或业务版本。
+
+PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边界依据；原 SPEC 的工程命令、目录、代码风格、测试策略与工程边界按共用合同 §4.1 分别进入 AD／TestCase。不得因单份 PRD 已生成就宣称六项内容或规格认可全部完成，也不为满足映射另造第五核心规格或强制复制 SPEC。调用原技能时保留其澄清、保存后停轮及后续认可要求。
+
+---
+
+# {PBC名称} · {需求主题} — 产品需求文档
+
+## 0. 文档身份、输入与确认
+
+| 项目 | 本次实际值 |
+| --- | --- |
+| 所属 EBC/PBC | `{各自capabilityId、名称、已确认或候选边界}` |
+| 产品需求身份 | `{稳定prdId；主题名称；改名不换身份}` |
+| 文档身份/版本/位置 | `{documentId；实际版本；完整路径/固定副本及摘要}` |
+| 状态和责任 | `{草稿/待评审/实际认可范围；维护、编写与确认责任}` |
+| 采用模板与业务输入 | `{固定模板、BRD及实际业务答复；按下表登记}` |
+| 比较基准 | `{前一有效PRD、相关主题、适用原型及实际代码/数据/部署；未实现写未实现}` |
+| 变化与有效目标 | `{本主题新增/修改/保留/替代/停用条目；旧内容可固定引用，不能只交差异摘要}` |
+
+### 0.1 固定输入
+
+| 输入 ID | 对象、文件及具体条目 | 版本与可回读内容/摘要 | 来源性质 | 本次用途/采用范围 | 实际认可与缺口 |
+| --- | --- | --- | --- | --- | --- |
+| `{IN别名}` | `{BRD/SRC/业务答复/旧PRD/共用规则/相关主题}` | `{固定引用；不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标/上下文/仅比较}` | `{实际情况}` |
+
+### 0.2 变更与认可
+
+| 本版变化及来源 | 比较基准 | 受影响条目/其他主题 | 原型/AD/TestCase/实现需复核什么 | 实际认可来源与范围 |
+| --- | --- | --- | --- | --- |
+| `{真实差异}` | `{可回读旧内容}` | `{稳定ID}` | `{待处理或实际记录}` | `{未取得不预填}` |
+
+### 0.3 逐条有效行为与来源
+
+| Feature/分组与 Story/功能 ID | 完整目标行为的唯一来源 | 固定版本/条目及可回读内容 | 本次用途与变更关系 | 描述/依赖缺口 | 实现可用性与证据 |
+| --- | --- | --- | --- | --- | --- |
+| `{沿用 FT/US/FR；无编号用源位置，不重排}` | `{本 PRD 第6章卡片或选定旧文档卡片}` | `{身份、版本、具体位置及内容/摘要}` | `{有效目标/上下文/仅比较；新增/修改/保留/替代/停用}` | `{完整/缺失/冲突及受影响范围}` | `{实际代码/环境依据；未实现/未验证如实写}` |
+
+逐条登记本主题的完整有效行为，不能只登记本次差异。有效目标、比较材料与未来规划分开；一条有效行为选定一个权威正文。第4.2节目录与本表引用同一来源，不各自维护另一套当前有效答案。沿用旧编号及来源关系；拆分、合并、改名时保留原标识与新条目的映射，不将已有 FR 与 US 擅自视为一对一。来源缺项不能宣称原型或 AD 输入已经完整；未纳入本次改动不等于停用，引用一条旧行为不能复活旧文件内其他已被替代条目。
+
+## 1. 目标与业务成功
+
+| 目标/价值 | BRD 目标/BR 来源 | 期望业务变化 | 观察方法/条件/周期 | 已知情况与缺口 |
+| --- | --- | --- | --- | --- |
+| `{沿用ID或标候选}` | `{文档身份/版本/条目}` | `{业务结果，不只系统上线}` | `{有依据的方式或待定}` | `{事实/建议/真实答复}` |
+
+区分本主题的功能验收和需要真实使用数据的业务效果。未知收益/阈值不臆造；人员或系统数量不自动成为并发容量目标。
+
+## 2. 主题范围、PBC 责任与协作
+
+| BR/场景/约束 | 本主题承接内容 | 本版/后续/排除/待定 | 功能或共用要求 | 其他主题/PBC 去向 | 依据与缺口 |
+| --- | --- | --- | --- | --- | --- |
+| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{capabilityId/prdId/未分配}` | `{来源/决定/Q}` |
+
+说明本 PBC 维护哪些业务事实，本主题负责哪些部分，与同 PBC 其他 PRD 的交接是什么。一个主题可包含多个功能，一个功能也可在本主题的多个版本中演进；不按文件或页面数量推导仓库、服务或能力拆分。
+
+| 明确排除/限制 | 来源与含义 | 容易误增的能力 | 与范围内信息的界线 |
+| --- | --- | --- | --- |
+| `{实际排除项}` | `{准确依据}` | `{仅作越界提醒}` | `{排除管理模块不等于删除范围内必要字段}` |
+
+“未提及”不等于“业务确认永不需要”；新增建议先进入问题表。业务前提、系统必须检查的条件及明确不由系统判断的事项分别表达。
+
+## 3. 用户、角色与数据范围
+
+| 角色 ID/参与方 | 用户目标 | 允许的业务动作 | 可见/可操作的数据范围 | 状态、归属等前提 | 禁止行为/缺口及来源 |
+| --- | --- | --- | --- | --- | --- |
+| `{真实角色或标候选}` | `{价值}` | `{具体动作}` | `{本人/组织/租户/指定资源}` | `{何时允许}` | `{固定规则/Q}` |
+
+区分“作出业务决定”“代为记录结果”“修改业务数据”。未明确的扩权不默认为开放；共用授权定义引用一个权威位置，后续 AD 必须落实服务端和对象级校验，不能只隐藏入口。
+
+## 4. 完整业务流程与功能目录
+
+### 4.1 端到端业务闭环
+
+`{用户触发→各角色操作→业务结果→后续接收方；含失败、拒绝、补救/重做、退出及跨主题交接，可按实际给业务流程图。}`
+
+| 场景/步骤 | 角色与输入 | 动作及业务前提 | 输出与事实维护者 | 异常/未知/重做 | 功能/规则来源 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定场景/步骤}` | `{真实角色}` | `{业务动作}` | `{谁维护什么结论}` | `{有依据的表现或Q}` | `{固定引用}` |
+
+### 4.2 功能目录
+
+| Feature ID/名称或分组 | Story/功能 ID 与名称 | 来源 BR/场景 | 用户价值 | 本版处理 | 完整行为位置 | 依赖/相关主题 | 优先级依据 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| `{沿用 FT；来源无分组时注明，不强造层级}` | `{沿用 US/FR 体系；历史标识映射见0.3}` | `{准确来源}` | `{用户结果}` | `{新增/修改/保留/替代/停用}` | `{第6章卡片或固定有效旧内容，与0.3一致}` | `{明确引用}` | `{来源等级/建议/实际采用分开；未给定不默认P0}` |
+
+目录是导航，不能代替具体行为。新版本应定位全部有效目标，未变化条目可引用其固定完整版本；未改不等于代码已可复用，没纳入某次改动不等于停用，旧文件中被替代的其他内容不得重新引入。
+
+必需路径或既定行为被降级、移出或停用时，必须登记原优先级及来源、调整理由、端到端闭环影响、受影响 Story/AC、实际决定者和固定确认记录。建议与已确认调整分别表达；尚无确认时保留为待决，不能据此删除有效需求或把交付范围默认为已缩减。
+
+### 4.3 跨功能闭环与既有行为影响
+
+| 对象/原状态 | 操作与条件 | 目标状态及业务结果 | 拒绝/失败/未知结果 | 跨 Feature/Story 或主题的输入输出/先后条件 | 受影响既有行为/AC与回归输入 |
+| --- | --- | --- | --- | --- | --- |
+| `{BO及固定规则}` | `{真实动作}` | `{可观察结果}` | `{有依据的产品表现或Q}` | `{接收方、责任与依赖引用}` | `{已交付条目、固定版本及必须保留的行为；首次且无既有影响时写依据}` |
+
+本节给出产品影响与回归范围，具体测试方法由 TestCase 展开；不能仅因下游有回归章节就省略受影响行为。逐条核对跨 Story 状态与反馈一致，未经确认不得破坏已有业务闭环。
+
+## 5. 业务对象、规则与状态
+
+### 5.1 对象与概念信息
+
+| 对象 ID/名称 | 含义及来源 | 事实维护方与操作边界 | 对象关系/形成时点 | 信息性质 | 生命周期/历史引用 |
+| --- | --- | --- | --- | --- | --- |
+| `{BO等稳定ID}` | `{真实概念或标候选}` | `{PBC/主题/角色}` | `{有依据的关系，未知不猜基数}` | `{独立事实/只读视图/快照/外部信息}` | `{状态/保留要求}` |
+
+| 对象.业务属性 | 业务含义 | 显示/必填/可选的条件 | 校验与来源 | 确认/问题 |
+| --- | --- | --- | --- | --- |
+| `{稳定标识；报告各章节也完整承接}` | `{业务可理解定义}` | `{显示不自动推成必填}` | `{固定来源}` | `{真实情况}` |
+
+本章维护业务信息，不决定物理表或字段类型；AD 的 ER/数据字典承接这里，不能遗漏长表单、章节或关系。
+
+### 5.2 共用业务规则
+
+| 规则 ID | 完整规则与适用范围 | 条件/例外/拒绝时表现 | 事实维护位置 | 来源与认可 | 相关功能/主题 |
+| --- | --- | --- | --- | --- | --- |
+| `{RULE等稳定ID}` | `{明确行为}` | `{已知结果或Q}` | `{本处或固定外部权威}` | `{明示/推导/真实确认}` | `{引用}` |
+
+相同规则只定义一处。跨主题共享时固定引用维护者及版本，不在各 PRD 私下改成不同规则。
+
+### 5.3 状态、版本与业务变更历史
+
+| 业务对象 | 状态/业务阶段 | 允许动作与触发者 | 禁止变化/重复/重做 | 谁维护事实与何时可见 | 业务历史要求及来源 |
+| --- | --- | --- | --- | --- | --- |
+| `{对象引用}` | `{已明确值；未知标Q}` | `{条件、动作、结果}` | `{实际要求}` | `{避免列表、详情、协作事件互相矛盾}` | `{修改/版本/意见留存及未知期限}` |
+
+业务结果、内部技术状态和执行任务状态分开；业务修改历史不能用文档来源追溯代替。未知状态或编辑/重做规则在业务侧确认，不能留给编码或测试猜测。
+
+## 6. 逐 Story/功能完整行为与验收条件
+
+对每项新增/修改 Story 或可独立验收的功能展开以下卡片；保留行为可以固定引用完整有效卡片，不要求复制第二份正文。一个 Feature 可有多条 Story，一个功能包含多个独立行为时分别展开，不以一张概括功能卡替代全部行为。简单功能可合并成表，但九项语义和 AC 必须可定位；无页面或无协作的项目写不适用及依据。未知产品行为登记问题，不用“待 AD 确认”替代。
+
+### {Story/功能 ID} · {名称}（所属 Feature/分组及原标识映射见0.3）
+
+1. **用户与目标**：`{角色及价值，引用第3章}`。
+2. **触发、前置与业务范围**：`{身份、权限、归属、数据和状态；引用共用定义}`。
+3. **正常流程**：`{逐步动作、条件、状态变化、可观察结果和反馈}`。
+4. **异常、边界与退出**：`{校验拒绝、无权限、空结果、依赖失败、重复/并发、超时结果未知、撤销/取消和重做的实际适用表现}`。
+5. **规则与数据**：`{引用对象、属性、规则；本功能专用校验/默认/修改时机有来源；不在此设计API或表}`。
+6. **页面与交互**：`{入口、页面状态、操作、反馈及适用原型版本；无界面写依据}`。
+7. **协作与业务事件**：`{跨主题/PBC/外部/人工交接，输入输出含义、允许/禁止动作、失败后谁处理；无则说明}`。
+8. **来源与实际认可**：`{BR/场景/答复固定引用，候选项及问题ID；不在展开时把候选转确定}`。
+9. **AC**：按下表逐条定义。
+
+| AC ID/子项 | 对应功能/规则及来源 | 前置条件 | 动作/事件 | 可观察的预期结果 | 场景类型/验证时点 | 未决影响 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{固定引用}` | `{可构造条件}` | `{具体操作}` | `{可判断的产品结果}` | `{正常/拒绝/边界/恢复等}` | `{无或Q}` |
+
+复合 AC 必须拆出可定位子项并保留原含义；“流程正常”不算预期。跨功能局部编号必须带完整前缀。产品预期不明确时登记问题，不由 AD/TestCase 自行选择答案；实际运行结果不写在 AC 中。
+
+## 7. 页面、渠道、协作与智能能力
+
+| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型引用及确认/缺口 |
+| --- | --- | --- | --- | --- | --- |
+| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象，不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{版本/范围；未形成注明}` |
+
+布局、视觉及交互由原型表达；本 PRD 仍维护产品规则与完整行为。原型反馈改变业务规则时回到本处修订；认可原型不能自动改写未批准需求。
+
+| 协作/事件/智能能力 | 发生条件与业务输入输出 | 责任方/权威事实 | 失败、人工介入与禁止边界 | 来源/采用状态 |
+| --- | --- | --- | --- | --- |
+| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{capabilityId/prdId/外部主体}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
+
+## 8. 质量、身份、审计与跨主题依赖
+
+| 要求/依赖 ID | 对业务的影响 | 条件/阈值与固定来源 | 适用功能/AC | 实际可用性或待核实项 | AD/TestCase 承接 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{身份变动、撤权、隔离、敏感信息、性能、可访问性、恢复等}` | `{无依据不填默认数字}` | `{明确范围}` | `{不把计划写成已就绪}` | `{判据/工程落点待形成或实际引用}` |
+
+逐项核对共用业务规则、质量、身份、隔离和生命周期要求：每项必须落到适用 Story/功能及 AC，或写有依据的不适用理由；共用规则存在不等于逐行为已落实。反向核对每条行为和 AC 都有产品来源或明确候选理由，不以覆盖数量代替含义。
+
+已知执行依赖与待业务答复的问题分开。跨主题的组合及兼容关系按明确版本登记，不从同 PBC 推定任意版本都可组合。
+
+### 8.1 已知执行依赖与交接时点
+
+| 依赖 ID/类型 | 依赖方及固定对象/版本 | 受影响 Story/AC | 契约冻结或决策时点 | 联调组织与前置就绪 | 责任方/实际状态与证据 | 未满足时的影响及后续承接 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `{数据/事件/外部就绪/契约等实际依赖}` | `{谁提供什么；未取得明确写缺口}` | `{完整前缀}` | `{如进入相关联调前需冻结的准确契约；实际时点或待决定}` | `{双方如何联调、需要的环境/数据/权限/服务；未安排如实写}` | `{实际负责人或未指定；计划不写已就绪}` | `{可继续/受限范围；AD技术定义、TestCase验证条件、Plan前置任务}` |
+
+本表记录已知执行约束及安排；需要业务选择的未知规则仍登记第9章并相互引用，不重复维护答案。PRD 不在这里设计 API Schema 或实现技术，也不凭空宣布契约已冻结；具体契约由 AD/权威附件定义。首次起草尚无安排时说明待决定事项、责任和影响，不猜日期、负责人或就绪状态。无执行依赖时写依据，不机械制造联调任务。
+
+## 9. 开放问题与变化影响
+
+| Q ID | 具体缺失/冲突与双方来源 | 受影响功能/AC/主题 | 可继续/不能交接什么 | 所需答复与责任 | 真实关闭依据 |
+| --- | --- | --- | --- | --- | --- |
+| `{稳定ID}` | `{不择一当事实}` | `{条目}` | `{具体动作}` | `{主体或未指定}` | `{未取得则待确认}` |
+
+变化应追踪到原型、AD、TestCase、实现、用例和旧证据；无关格式变化不自动重建全链。
+
+## 10. 全文追溯与交接
+
+| BRD/SRC/外部约束 | 本主题承接或排除依据 | 功能/对象/规则/页面/AC | 其他主题去向 | 实际认可/未决 |
+| --- | --- | --- | --- | --- |
+| `{准确条目}` | `{完整限制也要承接}` | `{稳定引用}` | `{有则登记}` | `{真实记录}` |
+
+### 10.1 内容检查
+
+- 产品目标、边界、角色动作、数据范围、完整流程和明确排除均有来源。
+- 本主题全部有效功能有完整行为和逐条 AC；目录、原型截图或差异摘要不能代替正文。
+- 业务对象、状态、页面可见时点、事件与历史要求相互一致，无默认扩权或无源指标。
+- 共用规则单源，跨主题版本与责任明确；旧条目保留/替代/停用关系可追溯。
+- 候选/假设/冲突保持标记；模板确认不转成产品认可，未决项具体限制范围。
+- 工程内容与测试策略有明确承接位置；早期未形成则登记缺口，不从业务认可推定原技能所需规格内容已齐备。
+
+### 10.2 S01—S14 逐项核对
+
+这些编号用于核对本主题选定版本的内容与交接条件，结果记录在本 PRD 内。每行填写实际位置/证据、齐备/部分/缺失/不适用及理由；模板存在或模型勾选不能代替实际核对。
+
+| 编号 | 本 PRD 交接前检查 | 实际位置/证据与缺口 |
+| --- | --- | --- |
+| S01 | 主题目标与 BRD/已选 PRD 范围一致；用户需求/业务假设、验证闭环和纳入/排除有来源；未知指标列缺口 | `{第1/2/4章及具体依据}` |
+| S02 | 0.3逐条固定有效行为来源；Feature/Story及既有编号可追溯；新增/修改/保留/替代/停用分开，目录不代替正文 | `{0.3/4.2/第6章}` |
+| S03 | 新增/修改行为达到可原型、可测试粒度：角色、前置、逐步动作、状态、结果、拒绝/失败/未知/重复等实际场景 | `{逐卡九项}` |
+| S04 | AC可判断、前置可构造、来源明确、复合子项齐全、跨卡引用可定位；期望不留给测试猜测 | `{第6章逐条AC}` |
+| S05 | 共用规则、对象、页面引用单一权威；行为专用定义有来源，不重复定义不同答案 | `{第3/5/6/7章引用}` |
+| S06 | 跨Feature/Story/主题的端到端状态一致；执行依赖与开放问题分开；已交付行为影响及回归输入明确 | `{4.1/4.3/8.1/第9章}` |
+| S07 | 优先级沿用来源，不默认等级；必需路径降级/移出有理由、闭环影响及真实确认，未确认不删有效要求 | `{4.2及0.2真实记录}` |
+| S08 | 来源中的候选保留候选标记及同一问题关联，未在展开时变为确定需求 | `{0.1/第6/9章}` |
+| S09 | 业务前提、系统必须检查和系统明确不判断分别表达，不把业务约定误写为程序校验或反之 | `{第2/3/5/6章对照}` |
+| S10 | 开放问题绑定具体行为/AC及受限交接范围；冲突双方保留，不择一当事实 | `{第9章}` |
+| S11 | 上游或本PRD规则变化已追踪到受影响行为/AC及下游复核，不静默沿用旧AC或旧确认 | `{0.2/第9/10章}` |
+| S12 | 完整有效行为集合可从0.3定位；上下文、比较与本次目标分开，缺项不冒充完整，旧条目不被误复活 | `{0.3/4.2及逐条来源}` |
+| S13 | 技术实现进入AD，原型/AD/TestCase/Plan分范围交接明确；不越过有效规格、原方法认可和执行条件 | `{10.3及真实缺口}` |
+| S14 | 共用G01—G08逐项核对，身份、来源、版本、范围、变更、认可和单一权威均有实际记录 | `{模板合同5.1的逐项位置与结果}` |
+
+### 10.3 分范围交接
+
+| 接收对象 | 固定输入与本次可交接内容 | 尚需条件/不能交接范围 |
+| --- | --- | --- |
+| 原型 | `{本PRD固定版、完整有效功能/AC、适用设计规则}` | `{缺失规则、实际验证和具体版本人审}` |
+| AD | `{选定PRD版、功能/数据/权限/质量定义及原型}` | `{真实工程基线、精确契约与技术风险}` |
+| TestCase | `{选定PRD版、产品预期与适用AD/原型}` | `{技术判据、环境/候选和实际执行条件}` |
+| Plan | `{本PRD选定版的完整有效行为/AC、8.1依赖、4.3产品影响与回归输入}` | `{仍需适用AD/TestCase/工程规范、六项覆盖及原方法要求的认可；PRD单独交接不代表可计划或可开工}` |
+
+本次结论：`{设计草稿/可交接具体范围/尚不可交接范围及理由；不得用文档已生成代替可编码或已验收。}`
+
+本结论不改写继承 Skill 或命令的输出、触发、工具、验证和审批合同；实际认可按共用合同保留原停点，Plan、CONSTRAINTS、ADR、实际测试和报告等辅助产物继续按适用方法维护。
+
+### 模板修订
+
+| 版本 | 日期 | 内容与边界 |
+| --- | --- | --- |
+| v0.0.3 | 2026-10-17 | 补Feature/Story与逐条有效来源、冻结/联调依赖时点、必需路径调整确认；恢复S01—S14逐项核对及产品回归/Plan输入。仅模板文档修订，不自动迁移业务实例或改原Skill/命令。 |
+| v0.0.4 | 2026-10-17 | 清理历史迁移说明依赖，直接使用本模板的行为卡、AC 与交接检查。全部有效内容和 S01—S14 要求保留；不自动迁移业务实例或改原 Skill/命令。 |

package/references/enterprise-sop-resources/recovery-contract.md

@@ -0,0 +1,65 @@
+# S08 最小恢复规则
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+规则版本：v0.4.0；本次只做源码修改，未测试、未发布；适用于显式企业 SOP 的状态核对、中断恢复、路径补录、重复执行和人工修改保护。命令与直接 Skill 共用本规则，不增加顶级命令或修改原方法。先读[Skill](../../skills/i3-enterprise-sop/SKILL.md)及[交接合同](handoff-contract.md)，handoff.py 仍保留init／select／resolve 三操作，业务 JSON 仍 schemaVersion 1；同主题改选采用单独的受控预览合同。
+
+本地增量采用[受控辅助](controlled-handoff.md)时，预检只读、回执校验、明确选用登记由外层程序顺序执行。缺读可在同一只读作业内补齐，仍不完整、调用拒绝、报告矛盾或文件变化则不启动登记；结果给原因、推荐与可选操作。只约束从该入口进入的单次交接，原失败与其他会话不追认。
+
+## 1. 先核当前事实
+
+确定项目根、工作范围、主题、唯一目标和本次允许写入对象。实际读项目规则、采用来源、资源根 README／stages.json／三份共用合同；使用安装清单定位时核 name、version、scope、resources.references，不全文加载资产列表。此读集不因 status 或只读恢复而缩减；阶段模板及生成提示词仅在实际生成、修订或相应内容核对时加载。
+
+先区分输出目标和上游输入：已有 PRD 用来生成尚不存在的 AD，仍是新建 AD，不因输入已存在而改成现稿恢复。只有本次输出目标已有稿件，或有该目标写入／登记中断等实际依据，才进入相应恢复判断；恢复任务本身不产生新的写作委托。
+
+恢复还须完整回读当前目标、明确的直接上游、本次交接清单和相关实际失败记录。涉及已选输入、Plan 或任务保护时读它们的当前正文；不展开其他主题和历史全集。历史只在本次明确的恢复依据范围内读取。记录未读、失败、部分读及未核事实，不能从路径存在、辅助成功或旧聊天推定完成或批准。
+
+只读补核可以说明现在已经确认的安装身份和来源；旧作业在写前漏读的事实及原失败报告保留。补核不改旧结论、不重新生成文档，也不证明业务完整。
+
+## 2. 按实际状态处理
+
+| 当前事实 | 本次处理 | 保留及停点 |
+| --- | --- | --- |
+| 目标不存在、外部写入结果未知 | 说明实际核对范围与缺口；未知动作不盲重试 | 不猜成功、不登记未来路径；新生成须另有明确任务 |
+| 写入中断、只有部分稿或收尾证据不足 | 只读列出已保存内容、缺口及建议恢复范围 | 不续写、不选用部分稿、不切 selected；后续修稿需明确委托并调用原 Spec |
+| 文档已完成，但原 Spec 停轮、清单未登记或登记失败 | 回读当前文档、直接上游、失败依据及当前清单，核身份与本次登记条件 | 确认本次准确选用并允许写清单后只补该引用；条件未满足就停止，不用重新生成解决登记问题 |
+| 相同工作范围、角色、capabilityId、prdId、规范化路径已选用 | 复用现有选择，报告实际变化 | 已是三字段且无变化时不新增历史；清理旧字段则保存原始清单，不创建新业务版本 |
+| 同路径文档、模板或提示词被人工修改 | 以当前正文为准，说明差异和受影响范围 | 不恢复发行原件、不继承旧认可；无明确修稿任务时零业务写入 |
+| 旧清单锁冲突、被其他写者改变、保存失败 | 保留目标及现有清单，准确报告真实失败和待补录路径，结束本轮依赖动作 | 不自动删锁、放宽权限、旁路写 JSON 或立即反复重试；后续获准作业先回读再补录 |
+
+选用前仍要求实际任务完成和最后编辑后全文回读。本辅助只验证真实可读非空路径，不能判断非空文件是否为完整业务稿；调用者不得用select的退出码0认证部分稿已经业务完成。条件无法确认时，只报告待核，不写清单。
+
+## 3. 复用现有工具补录
+
+先完成必读，再核实际发行工具 `--help`。清单已存在则不重新 init；确实不存在且本次明确允许创建时才初始化。只有本次准确文档已明确采用并允许写清单时，才用 select 补该引用；已有不同选择先改选预览。补录后回读实际 JSON 与返回的 history，核对本次 selected 差量、其他主题和人工内容；changed=false 时不预期新历史。
+
+```text
+python3 <发行资料根>/handoff.py --help
+python3 <发行资料根>/handoff.py select --project-root <实际项目根> --manifest <本次清单> --role ad --path <已完成并重新全文回读的现稿> --capability-id <PBC> --prd-id <主题>
+```
+
+示例参数须替换为本次真实值。没有可用 Python、写入授权或稳定清单时继续手动准确路径交接，不安装依赖、不为恢复创建另一套状态库。失败和业务审阅意见留在真实会话／外层证据中，不新增 approved、passed、完成率、强制 hash 或任务状态到业务清单。
+
+## 4. 保护已有工作
+
+仅补选用引用只允许更新本次明确的 selected；不改已有 Plan／唯一任务目标、已完成勾选、业务正文或其他主题。新稿存在不构成采用，同路径已选稿被人工修改仍核计划影响。清单顶层仅 schemaVersion、scope、selected；旧字段仅在获准写入且保存原始历史后移除。
+
+同主题既有选择替换按[改选合同](selection-handoff.md)先预览准确路径、配套及 Plan 影响，取得该次明确选择后才执行；来源变化须新预览。候选登记／撤回流程已退出，未采用稿只展示路径并保留文件。主题撤销及跨主题组合仍按明确任务核对，手动方式保留；原 Spec／Plan／Build 停轮、S09 独立审查和发布授权保持。
+
+## 5. 可复制任务说明
+
+```text
+/i3-sop status 本次只读恢复核对。读取本项目采用资料及五项共用来源，核安装定位元数据、当前目标、直接上游、清单和我指定的失败记录，区分部分稿、待补登记与已登记。保留人工修改和原失败，不写任何项目文件，不生成或修订文档，不进入 Plan／Build。
+```
+
+```text
+/i3-sop ad 上次文档已保存，本次只补我已明确采用文档的 selected 路径登记，不重新生成或修订。先按本项目采用资料核对真实输入和恢复条件，完整回读我指定的现稿、直接上游及清单；若条件不满足、清单冲突或工具失败，报告并停止。只允许本次明确选用的引用及必要清单历史，保护其他主题、Plan 和已完成任务；写后回读实际差量交我审阅。
+```
+
+以上源码命令在品牌发行中按既有规则映射为 /i3-sop；不是新增顶级命令。当前提示不代替缺失的实际项目／主题／目标选择，已采用指引可提供这些准确路径。

package/references/enterprise-sop-resources/review-handoff.md

@@ -0,0 +1,105 @@
+# 独立只读审查与复查衔接
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+资源说明 v0.2.0。只组织本次明确文档的 review／recheck，不接管原 Spec、生成、修订、选用、Plan、Build、原代码 review 或发布。
+
+## 统一审查约定
+
+本节承接共用合同中与只读文档审查有关的实质要求。实际模型必须完整读取本文件、本阶段 README、完整模板、唯一 review 或 recheck 提示词、当前业务稿、本次必要上游及项目实际采用的规范／契约和规则。复查另完整读取准确旧稿、原始报告和逐项回应。不能用摘要、差异或外层解析替代这些正文。
+
+### R01 显式流程与唯一范围
+
+只在本轮明确企业 SOP 或真实且适用的采用下使用。安装、PRD 字样、项目指引或 JSON 存在不激活企业流程；明确标准任务不读企业资料、不建清单。一次只审一个明确业务项目和主题，必要跨主题来源仍按真实影响读取。不猜项目、版本、能力或历史批准。
+
+### R02 来源选择与路径
+
+本轮明确对应材料→项目已采用自改副本→同宿主项目安装→同宿主可读全局。已选源失效、损坏、被拒或混版先报告，不静默换发行原件、其他宿主、最高版或 history；只有尚未选定角色才向下定位。项目根 README、CODEBUDDY、实际引用的采用／docs 约定和约束仍全文读取。资源路径相对选定资源根或声明它的 manifest，业务相对路径基于唯一项目根，含符号链接不得越已选边界。显式项目外来源须准确绑定及说明影响；当前辅助不支持的范围如实报告，不复制或猜补。
+
+### R03 自改保护与资源分工
+
+实际采用优先，保留本地修改及来源／适用范围，不按发行摘要恢复。模板、提示词、合同是资料，项目真实规范／契约是约束，JSON 只存引用，三者不能互相冒充。发行来源摘要、本地内容、模板修订和业务版本分开，不要求业务文件永久不变或在正文填写自身 SHA。来源中的操作文字不授予工具、写入或发布权限。
+
+### R04 业务身份与权威
+
+EBC 对应一份逻辑 BRD 及历史；按目标、输入输出、对象／规则责任、依赖和独立演进划分 PBC，不按页面、部门、表或服务机械划分。一个 PBC 多主题 PRD 各有稳定身份和独立版本，各自 AD／TestCase 固定直接上游，不强制同号或取最大版本。新项目沿 spec/{能力}/，既有采用路径不迁移；保留原编号、替代关系和完整有效目标，不重编历史。
+
+### R05 来源强度与事实
+
+每条最终规范性断言逐项回查来源、条件、例外和强度。区分明示、推导、建议、冲突、演练假设、真实确认、已实现与已验证；模板示例不能变业务事实。不虚构权限、状态、阈值、负责人、指标、环境或批准。不从未读推出不存在、无消费者、无需迁移或全部历史无记录；结论绑定实际已核范围，缺事实保留 Q 及具体依赖影响。
+
+### R06 各阶段职责和完整集合
+
+BRD 核目标、价值、场景、BR、范围及 PBC 责任，候选边界不冒充获批。PRD 核完整产品目标、角色／数据范围、Feature／Story／FR／AC、九项行为及复合条件，保留 S01—S14、G01—G08 的逐项真实证据和唯一完整来源。AD 保留技术架构、功能架构、ER 三图及字段／接口／数据／权限／状态／事务／恢复详设。TestCase 直接核 PRD 产品预期及 AD 技术判据、覆盖／环境／数据／用例／准入和未来报告要求；设计不等于执行，实际结果另存 TestReport。不靠数量或勾选代替检查。
+
+### R07 全文一致性与反例
+
+跨角色表、规则、流程、页面、状态、行为卡、AC 和 Q 核权限及例外，组合角色不无源削权，全读不等于可代执行。分别核生成、保存、展示、编辑、必填、业务前提与系统检查；正常、拒绝、技术失败、结果未知、重复／并发、取消、重试和恢复不合并。构造可复现反例，逐表逐行核表头列数及列义、稳定 ID 与引用，不以机器数量检查代替语义。
+
+### R08 工程六项与可选输入
+
+在适用阶段／交接范围核 Objective、完整 Commands（参数、cwd、前提、副作用）、Project Structure、真实 Code Style 示例、Testing Strategy、Always／Ask first／Never Boundaries。早期 BRD／PRD 不要求全部工程资料，缺项不能自称规格齐备或可编码；不造第五核心 SPEC。原型按需，可与 AD 并行，无原型不统一阻断；已有原型核准确版本／范围／appliesTo 和必要依据，不改其登记。TestCase 是 Plan 可选输入，已有读准确版本，没有可安排补设计，不能降低依赖任务验证条件。
+
+### R09 技术规约、契约与工程来源
+
+优先项目已有规范／CONSTRAINTS／ADR、实际技术栈、共享契约和采用说明，完整读本次实际采用的必要原文。辅助模板按任务适用，不强制另造总规约、预设技术栈或把模板当真实规范。核准确 PRD 及相关 AD、规范／契约版本、提供消费方、字段／状态和数据单一权威、最终校验／写入／事务、必要传递消费者、严格消费者及兼容／迁移／并存窗口。版本号、Schema、目录图或服务存在不证明兼容、实现或测试通过；目录采用、拟建工程、真实源码、应用验证分别表达，实际规则冲突只标注，不替业务决定。
+
+### R10 新增、修改、撤销和退役
+
+保留主题、有效 FR／AC 和完整当前目标；部分撤销不删整主题，文字更正不机械全链升版。真实变更追到相关契约、实体、AD、AC、用例、消费者及任务，保留旧组合、既有行为回归和未受影响范围，不自动重写其他主题。目标、任务实际状态和运行事实分别取证；未实施取消不标完成，进行中保留人工工作，已完成历史保留，已实现／运行功能退役用新兼容、移除、迁移、恢复及回归任务。删除文档或改 JSON 不代表代码／生产已退役；未知结果不盲重试，代码回滚不等于数据恢复，不删失败用例／降阈值／以替身关闭必需真实集成。
+
+### R11 原方法、选择与授权停点
+
+生成／修订继续先真实加载原 Spec，最后编辑后完整回读最终稿并停轮交审。生成存在不等于明确选用，选用不等于业务认可或 Plan 批准；JSON 顶层仍仅 schemaVersion、scope、selected，无 candidates、delivery 或审批字段。手动路径保留，不强制建清单或重跑 BRD。原 Plan 及唯一任务目标保留实际来源／FR／AC／验证、未完工作保护；获准后才进入原 Build／Build auto，原规格、Git、TDD／测试／构建／提交及风险停点不变，不隐藏变更规避原门禁。本文只审文档，不执行这些工程动作，不授予下一阶段或生产权限。
+
+### R12 独立只读与人工空间
+
+作者同会话自查不冒充独立审查。独立者用真实新上下文，只在会话输出问题、位置、来源、反例影响和最小建议，不写项目、业务稿、模板、提示词、报告文件、JSON、Plan、代码或采用记录，不调用 Spec／原代码 review／其他 Agent 或外部能力。人可修改、明确委托修订、有据不采纳或保留 Q；不为清零编决定。获准外层另存报告；缺已验证隔离时交准确新会话任务，不声称上下文被清除或 OS 级只读沙箱。
+
+### R13 必要全文与真实证据
+
+当前稿、必要上游、项目实际采用约束、本阶段 README、完整模板及唯一动作逐项全文读，长文分段覆盖截断。未读、部分、失败、确认缺失、不在选定集合和语义未核分别报告；成功 Read 一次、索引列名、作者摘要或外层读过不算完整模型读取。补读不追认为旧作业写前已读；生成／修订的末次编辑后全文回读要求保持，审查不负责自动补稿。
+
+### R14 报告、引用和角色
+
+以外层传入的同源 Schema 返回唯一 StructuredOutput：verdict、findings、checkedFacts、unread。结论为可交人工审阅／需修订／无法判断（兼容原契约交人工审阅），每条发现与已核事实有稳定 ID，target／source 各含实际路径、startLine、可选 endLine、所指行内短逐字 quote；保留原引号，不用省略、改写或 Read 行号前缀。发现区分 contradiction、evidence-gap、clarification、optional，给理由与最小建议，无真问题则 findings 为空，不凑问题。普通引用省略 role；只有外层绑定 sourceRoles 时用 Schema 枚举键，requiredSourceRoles 有真实路径／摘录／读取依据。角色表、作业 Schema 和校验同源，不另造描述性 role。引用通过不证明推理正确，模型不能引用仅外层读取而自己未读的材料。
+
+### R15 真实复查
+
+完整读当前稿、准确旧稿、原始审查报告、逐项回应和必要来源，不只看差异、作者摘要或已处理声明。旧发现 ID 逐项写进 checkedFacts，conclusion 以已关闭／部分关闭／未关闭／无法核实开头并给依据；局部修正仍有矛盾不能关闭。新问题使用新 ID，并核修订引入的回归、权限／状态／来源强度、表格和完整有效目标。未处理、没有人工回应或尚无裁定必须照实保留，状态说明不冒充人工采纳或批准；误报有据排除，原始失败和报告不覆盖。
+
+### R16 漂移、恢复与有限复核
+
+同路径同版本内容可变，旧审查只对当时对象有效；本次核准确正文及必要变化，不阻止之后人工改稿。不稳定、缺读、被拒、超时、来源漂移、越界工具、无效报告或缺隔离时保留失败、缺口、原因、推荐及可选操作，不换源／旁路追绿。按当次约定有界复核，仍失败交人工裁定；不重复生成业务稿解决登记，不自动 reset／回滚或清锁，不声称消除任意编辑器并发窗口。
+
+### R17 外层与模型读集分开
+
+外层解析选定阶段索引、manifest、路径／版本和依赖，传入 Schema，核实际 argv、session、工具尝试／回执、必要全文、逐字引用、旧 ID 和项目零变化。模型不必重复读取已被固定覆盖的纯元数据／校验说明；被移出的原件和元数据仍保留本轮变化检查。精简只用于本辅助中已逐条覆盖并固定指纹的资料组合，不以项目自报兼容或同名同版本代替。自改或未知组合继续完整读取该项目选定原件，额外依赖不得静默删除，缺项不回退发行模板。阶段 README、完整模板、业务和实际约束从不因本分流裁剪。sourceRoles 与 Schema 同源；外层检查通过不能伪称模型已读元数据。
+
+### R18 结果与范围
+
+evidence_accepted 仅接受执行、读取、引用、会话和文件保护证据；业务报告允许需修订、真实意见和 Q，不要求清零。needs_human_review 表示证据缺口，不等于业务稿错误或原版冲突。静态、包、安装、宿主、模型行为、人审、工程／测试／Ship 就绪、实际发布分别取证；Ship GO 不等于发布／部署授权。工具调用一经提交就算尝试，拒绝、失败、成功、未确认按真实回执区分，退出码 0 不证明报告完整。普通作业不强制增加 Bash 或其他执行报告；审查只用本报告契约，不串行自动修订，不扩展跨阶段调度，不承诺固定耗时。
+
+## 外层一次调用
+
+命令 /i3-sop review 与显式 i3-enterprise-sop 共用规则；正文明确复查时采用 recheck，不新增必填用户参数。调用者依据任务和项目采用整理准确阶段、目标和业务来源，不要求用户填写内部路径。当前作者有已获准 CLI 能力时由外层启动辅助；辅助不在只读审查会话内部运行。
+
+```json
+{"action":"review","stage":"prd","target":"spec/巡检管理/巡检管理-任务登记-PRD_v0.0.1.md","sources":["spec/现场运营/现场运营-BRD_v0.0.1.md"],"task":"核本主题权限，保留人工修改空间。"}
+```
+
+```text
+python3 <实际所选资料根>/verification/review_handoff.py --project-root <唯一业务项目根> --request <外层准备的任务.json> --evidence-dir <获准项目外新目录>
+```
+
+这是外层执行输入，不是业务 JSON。stage 仅 brd／prd／ad／testcase，action 仅 review／recheck。sources、inputs、previousTarget、priorReport、responses 是实际必要输入；recheck 三项历史输入缺失不猜。sourceRoles／requiredSourceRoles 仅在实际角色绑定需要时由外层提供，与 Schema 使用同一 scope，普通作业不增加角色。
+
+辅助生成随机新 session，不 resume／continue／fork，不覆盖默认模型／系统提示，只提供 Read／Glob／Grep／StructuredOutput，禁用 Shell、写入、Skill、其他 Agent 和外部 MCP。init.tools 的宿主目录不是有效白名单；核实际参数、调用／回执和文件差量，未尝试越界不虚构拒绝。报告及输入快照只存项目外，不向业务 JSON 加 hash 或批准。无 Python／CLI／隔离权限时给新会话任务并结束，不自动安装依赖或调用其他宿主。
+
+完整生成、标准隔离、三字段登记、四阶段双入口与真实原 Plan／Build 的剩余矩阵分别按 S10／S11／S12 验证；本次精简不关闭它们。旧 S09 失败、报告和当时版本保留。候选登记、撤回、delivery 及企业 auto 不因本接点恢复。

package/references/enterprise-sop-resources/selection-handoff.md

@@ -0,0 +1,55 @@
+# 同主题规格改选与影响预览
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+本片补充单次受控入口的 selection-preview／selection-switch 操作，不新增顶级命令，不接管标准流程或企业 auto。只支持项目级 CodeBuddy CLI 内同一已选 capabilityId＋prdId 的 PRD、AD、已有 TestCase／原型路径组合。公共技术规约、共享契约、工程骨架、其他主题、scope／selected内人工内容、业务稿与 Plan 不由本操作改写；成功写入只保留三字段，旧candidates／delivery随原始清单留历史，其他未知顶层字段先明确用途。其他宿主、项目外来源或骨架目录仍可手动交接。
+
+## 先预览，再明确选择
+
+调用方按真实任务整理请求，不能让只读模型自行决定选用或生成授权。operation=selection-preview 时，先真实加载自有 SOP Skill，读取当前／目标主题与必要共享依赖、当前 Plan／任务和调用方明确补入的完成记录；外层核成功回执后，才将差异、配套证据、Plan 引用命中和任务文本观察保存到项目外 selection-preview.json。项目零写入。输入太大可按主题分段完成读取，不能以元数据裁剪替代业务正文。
+
+调用方在会话中展示原因、推荐与选项：保留当前选择／明确选择新组合／补齐配套或明确解除引用／本次手动交接／停止。无真实明确委托时结束；模型推荐、自动模式、已有候选和高版本号均不构成选择。
+
+确认准确预览后，调用方用相同的工作、主题、target、links、inputs 准备 operation=selection-switch，并用 preview 指向该项目外预览文件，再在真实委托范围内加 --switch-selection。仍运行一个新的只读会话，回读当前输入与旧预览所涉及来源；回执、来源或文件变化均不进入写入。通过后复用既有 handoff._store，最多一次受限更新本主题；保存旧清单并核完整差量。手动方式不依赖此辅助。请求和参数只能限制委托，不能认证人类身份或创造批准。
+
+## 请求与配套判据
+
+共同字段：schemaVersion=1；work、manifest、capabilityId、prdId、task 必须明确。target 必须含准确 prd 路径，只允许 prd／ad／testCase／prototype；未列项保持旧引用，显式 null 仅解除对应配套引用、保留实际文件。不要靠省略旧 AD 把它假配给新 PRD。
+
+links 是调用方从真实正文摘取的数组，每项为 role、upstreamRole、line、quote。AD 必须核直接 PRD；已有 TestCase 同时核直接 PRD 与 AD；已有原型核 PRD。line 为真实正文的一基行号，quote 为该行完整原文；原文需以行内代码或 Markdown 链接准确写出本次上游的项目根相对路径。程序核原文、准确路径及组合，不做业务语义批准。项目采用其他引用格式时，可补人工核对并继续手动方式，不能冒称本入口已自动识别。缺证据、旧上游、不存在的上游或矛盾配套列缺口，不能靠确认参数绕过。无 TestCase 或原型本身不阻断改选；缺 AD 时如实保留工程规划缺口，不能由选用推定可实施。
+
+inputs 为本次明确采用的额外正文路径；原／新主题和共享来源由选定清单补入。若 delivery 声明 plan／taskTarget，必须读取；当前存在的 tasks/plan.md、tasks/todo.md 也须读取。其他自定义任务／完成记录由调用方准确补入 inputs，不从任意文件或复选框推定完成或依赖。预览中的路径命中只是影响线索，不能证明未命中的任务无影响。
+
+```json
+{
+  "schemaVersion": 1,
+  "operation": "selection-preview",
+  "work": "本次实际工作",
+  "manifest": ".i3/sop/work/handoff.json",
+  "capabilityId": "PBC-ID",
+  "prdId": "THEME-ID",
+  "target": {"prd": "spec/能力/主题-PRD_v0.0.3.md", "ad": "spec/能力/主题-AD_v0.0.2.md", "testCase": null},
+  "links": [{"role": "ad", "upstreamRole": "prd", "line": 8, "quote": "直接产品依据：`spec/能力/主题-PRD_v0.0.3.md`"}],
+  "inputs": ["tasks/completed.md"],
+  "task": "核对这组准确路径的影响，先展示预览，不修改业务稿与Plan。"
+}
+```
+
+以上行号和路径是格式示意，必须从当前正文取得，不能照抄占位值。
+
+```text
+python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <项目外预览请求.json> --evidence-dir <新项目外证据目录>
+python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <绑定同一预览的切换请求.json> --evidence-dir <另一新证据目录> --switch-selection
+```
+
+## 并发、历史和后续原能力
+
+预览绑定本次实际输入和清单；摘要仅在项目外用作这次瞬时审计，不增加业务 JSON 的强制 hash 字段，不禁止后续人工修改。确认前发生人工修改、其他主题变化或并发写入时保留现状，重新预览。重复同一已完成切换且只有该次准确清单／历史差量时零写入；不把其他新增记录或新修改混入旧确认。基础锁与写前比对不构成跨编辑器事务，写后异常保留实际现场交人核对，不自动恢复业务稿或循环重试。
+
+清单切换不更新当前 Plan，也不迁移业务认可或工程开工许可。调用方须把新选 AD 及准确 PRD、公共规约、契约、工程骨架和必要代码显式交原 /i3-plan 核影响；仍由原方法写 tasks/plan.md／唯一任务目标，待人审认可后才按原 /i3-build 或 /i3-build auto 执行。完成任务及历史保留。共享技术定义或工程骨架本身需要修改时单独明确任务。候选登记／撤回已退出当前流程；撤销主题和跨主题完整差量仍按后续明确范围处理。