@givolt/i3-composer-agent 2.3.7 → 3.1.0

package/skills/i3-enterprise-sop/references/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/skills/i3-enterprise-sop/references/readme.md

@@ -0,0 +1,167 @@
+# 企业 SOP 四阶段资料入口
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+资源组合版本：0.17.1；指引版本：v0.17.1。资料统一随本次实际加载的SOP Skill分发，唯一资料根为该Skill的 `references/`。包含四阶段文档资料、公共技术规约及工程骨架目录规范1.0.0；可选企业应用技术规约为v0.0.4。模板、实际规约、目录规范和i3软件版本分别管理。本地候选的静态、安装、真实宿主与人工验收分别取证，暂不发布。
+
+[公共技术规约采用说明](technical-baseline/readme.md)提供通用模板v0.0.1与当前可选规约v0.0.4；规约固定引用同一根下[工程骨架1.0.0](engineering-skeleton/readme.md)，不再内置另一份旧目录规范。骨架是工程组织规则与采用说明，不是可运行代码模板。项目明确采用才生效，已有规范和项目自改副本优先。发行资料仅保留当前版本，不提供旧资源副本或兼容链接；既有业务文档、采用记录及验证事实不被改写。
+
+业务JSON顶层仅schemaVersion、scope、selected；原版25技能／9命令及既有原型能力保持，整体27技能／11命令，企业跨阶段auto不在本轮范围。
+
+文档review／recheck采用[独立只读审查合同](review-handoff.md)：外层在获准环境使用一次新的只读CodeBuddy会话，绑定准确目标、所选模板／业务来源及复查原报告和人工回应。报告保存与审查分开，业务稿不自动改写；缺隔离时整理新会话任务，不冒充独立审查，不新增业务JSON字段。
+
+原生方法的调用／报告复核与S06路径辅助校验分开，按[外层校验说明](verification/readme.md#原生方法与执行报告)显式使用；门禁对象和时点见[交接合同§11](handoff-contract.md#11-门禁对象时点和允许范围)。外层检查不自动改业务稿，不生成批准或启用企业流程。
+
+需要程序约束现稿交接时显式采用[单次受控入口](controlled-handoff.md)：先限制 CodeBuddy 只读，再核真实回执，最后仅登记用户明确采用的准确路径并回读。该入口与事后证据校验分开，不是随安装启用的通用拦截器，不代替原生方法、人审或企业auto。
+
+同主题已有选择需要替换时采用[改选预览合同](selection-handoff.md)：先核准确组合、上游原文证据与当前 Plan 影响，再经该次明确选择受限更新；新稿生成不自动选用。旧稿、其他主题、公共技术来源、工程骨架与 Plan／任务保持，新的规划输入由用户显式调用/i3-sop plan组织并复用原规划；原/i3-plan加明确任务的手动方式仍可用。
+
+本次输出目标已有稿件、中断、待补登记、重复执行及人工修改按[最小恢复规则](recovery-contract.md)处理；已有上游输入不把新目标误判为恢复。先核现稿，不重复生成解决清单问题；恢复状态及失败留在会话／外层证据中，不增加业务JSON状态字段。status与恢复保持根README、索引和三份共用合同的完整读取，安装身份按必要元数据核实。
+
+## 1. 先确定本次流程
+
+本轮明确标准流程时使用原方法，不读取或采用企业模板、提示词、清单和企业目录。只有本轮明确企业 SOP，或用户明确且适用于本任务的选择记录，才加载企业资料。安装、项目指引存在、发现 handoff.json 或出现 PRD 一词都不构成选择。资料不授予操作、写入或发布权限；当次任务不自动变成项目永久采用。
+
+CodeBuddy 可明确说：“为当前项目启用 i3 企业 SOP 资料指引，保留已有项目说明，不更改全局配置。”接入先实际读 CODEBUDDY.md，只追加[项目片段](codebuddy-project-guide.md)的完整有界标记，保留已有内容。同名片段复用，自改片段不自动替换；标记不完整、符号链接或归属不清时停止改写。更新先说明差异，按宿主要求新会话验证真实加载，不改全局规则。文件存在不证明宿主加载；其他宿主另取证。
+
+## 2. 分开定位三种来源
+
+| 来源 | 查找与采用规则 |
+| --- | --- |
+| 模板、作业提示词和资源合同 | 本轮明确指定的对应资源→项目明确采用副本→同宿主项目安装→同宿主可读全局安装；只向下查尚未选定的角色，不用低优先级源替换失效的已选源 |
+| 真实业务、公共规范、契约、骨架 | 先读项目根 README、适用项目规则、其引用的采用记录和 docs/README；以实际选择、适用范围及真实正文为准，不把资源模板当项目规范或可运行工程 |
+| 本次交接对象 | 已明确的唯一 JSON 清单或手动指定路径；只取本次主题的已选材料，候选、历史、样例和验证记录不作默认输入 |
+
+CodeBuddy项目安装由 `.codebuddy/.i3-composer-agent.json` 核name／version／scope、catalog.skills及本次SOP Skill的SKILL.md及资料子目录的readme.md两项精确assets，资料从实际Skill目录进入。可先定位键再读必要范围，不全文加载assets列表；`resources.references`继续服务原版共用资料，不能据此寻找SOP。项目确实未安装时才查同宿主全局安装；清单损坏、身份不符或资料缺失先报告，不静默兜底。已选项目副本时，安装事实不能接管采用。
+
+查找顺序也约束实际读取：先读项目根约定及其采用记录，确定对应角色尚无明确来源时，才访问下一优先级。已选定项目资料根时，不再读取低优先级的安装／全局资源README、索引或正文，除非本轮明确要求比较来源；不并行探读多套入口再事后宣称只采用其中一套。安装清单若先前已读，只保留安装事实，不顺势进入其资源。
+
+不全盘搜索、跨项目或跨宿主借安装；全局可读时不重复要求项目安装。history、验证目录、备份和样例只在本次明确指定用途时读取。目录列表、索引、聊天摘要和自动上下文只是线索，必须实际读选定根 README、索引、采用记录及本次所需正文。
+
+本轮只指定一个模板时，只覆盖该角色。提示词及共用规则先沿项目采用组合；尚未选定才按上述顺序提议固定来源，说明兼容范围。冲突不得靠“本轮优先”取消既有规范、权限或质量要求；明确本次覆盖范围后执行，持久修改采用须另有相应意图。无需因已明确选择重复提问。
+
+## 3. 按索引读完整资源
+
+review／recheck 的读取职责以[统一审查约定](review-handoff.md)为准：外层解析索引／清单／依赖并保留变化检查，模型完整读阶段README、模板、唯一动作、业务及实际约束。只对已固定覆盖组合精简；项目自改或未知规则继续完整读选定原件。以下生成／修订、status、交接与恢复读取规则保持；审查不再一律重复加载纯元数据和整套校验说明。
+
+先实际读[阶段索引](stages.json)和其中三份共用合同：[模板合同](template-contracts.md)、[交接合同](handoff-contract.md)、[生命周期合同](lifecycle-contract.md)。再按本次阶段／动作读本阶段README、manifest、完整模板和唯一对应generate、review、revise或recheck提示词；不是一次读取四份动作提示词或全部模板。
+
+本次读取清单由已读索引、局部manifest及直接任务确定：先列实际路径和用途，再逐项成功回读；未读／失败／部分读不能记“已读”。按以下检查收尾，不为了少读省掉必要依赖，也不为“完整”探读未选根。
+
+| 必读对象 | 本次适用范围 |
+| --- | --- |
+| 项目规则与采用依据 | 本项目CODEBUDDY、根README、实际引用的采用与docs约定，先于安装资源 |
+| 当前资源根与共用合同 | 选定根README、stages及三份共用合同；manifest内dependencies的适用正文也实际读 |
+| 阶段资料 | 本阶段README、manifest、完整模板、本次唯一动作提示词；索引／manifest可被项目改路径，不能按默认名猜 |
+| 公共技术规约辅助资料 | 本次要求辅助准备／模板缺口核对时：按auxiliaryResources读其manifest，再读manifest指定entry和template；三者缺一不能声称完整辅助读取 |
+| 业务与必要依赖 | 只取本次所选正文及必要直接／传递约束；骨架采用说明指向真实来源README／源码时，实际读该来源，说明完备或缺口 |
+| 已选缺项 | 读取到具体缺项后准确报告文件／目录区别及影响；不再加载其他动作或低优先级源兜底，独立工作只建议不执行 |
+
+结束前对照这份本次清单，报告已成功读取、仍缺／失败、未要求的资料和具体依赖影响。不要用搜索结果、索引列名、行数或作者摘要替代正文；长文按实际工具截断分段覆盖。维护来源、旧证据和模板中的示例链接不自动成为业务必读。本组合提供[外层只读校验](verification/readme.md)，由获准调用者对照本次适用清单和CodeBuddy原生轨迹执行；单独加载资料不会自动启用校验，也不拦截工具调用。文件存在、读取覆盖和语义正确分别判断。
+
+| 路径类别 | 相对基准与边界 |
+| --- | --- |
+| sharedContract、handoffContract、projectGuide、阶段／辅助资源 resourceRoot 和 manifest | 当前选定 stages.json 所在目录 |
+| 阶段模板 source.resourcePath、prompts、files | 对应阶段 manifest 所在目录；source.path 为维护来源，不作安装路径 |
+| 辅助资源 entry、template、files | 对应辅助 manifest 所在目录 |
+| dependencies.path | 声明该依赖的 manifest 所在目录，允许在选定资源根内引用共用文件 |
+| 业务 JSON 及手动交接相对路径 | 本次明确的业务项目根，详见[交接合同](handoff-contract.md)；不相对清单目录或临时 cwd |
+
+资源索引的路径经解析后须保持在选定 SOP 资源根内，含符号链接解析；越界、不可读、损坏或版本／主题矛盾时报告具体缺口和影响，不改用安装原件、全局新版或历史副本。真实业务文件不受资源根约束，明确提供的项目外来源可使用绝对路径并说明可移植性，不自行复制。
+
+| 阶段／辅助资料 | 输入、方法与边界 |
+| --- | --- |
+| brd | 业务描述、EBC、完整 BRD 模板；必须原Spec；按需澄清／文档方法，候选 PBC 不冒充获批 |
+| prd | 选定 BRD 或等效依据、PBC、主题、完整 PRD；原规格方法及适用认可／停轮保留 |
+| ad | 选定 PRD、真实规范／工程事实、完整 AD；必须原Spec；按需文档／接口／前端方法，原型按需并行 |
+| testcase | 直接产品依据 PRD、配套 AD、测试规范、完整 TestCase；必须原Spec；仅设计，不借原 /i3-test 生成文档或冒充执行 |
+| technical-baseline（辅助） | AD 准备时按需定位；优先复用项目已有规范。只有缺少适用规范且本次明确选择才起草最小候选；不是第五阶段 |
+
+公共技术规约的[采用说明](technical-baseline/readme.md)和模板用于核对来源与缺口。现有规范已充分时直接引用，不复制总规约、不修改原规范。技术栈与工程骨架是项目实际选择；模板不预设答案，选型、候选、采用、应用、验证分别表达。
+
+四阶段固定组合：BRD 0.2.3／模板 v0.0.3，PRD、AD各0.3.3／模板v0.0.4，TestCase 0.3.4／模板v0.0.4；公共技术规约辅助资源 0.4.0／模板 v0.0.1。四阶段模板正文原字节保留，B05仅增补说明和动作提示词，PRD 子包“未提供其他模板”仅描述该子目录；其中 AD 责任说明不是完整 AD。采用旧切片缺资料时报告差异，不默认混版。
+
+## 4. 保护项目采用与人工修改
+
+使用本次已选根及实际本地内容，记录发行来源、项目差异与适用范围。发行 manifest 的 sourceSha256／sha256 描述源码／品牌分发原件，不是要求项目副本永久不变的锁；本地修改可在现有采用说明中说明。未计算摘要如实写，不填假 SHA，不因内容已变就恢复原件；版本标签与正文矛盾先核对，不能拿摘要免除实际读取。
+
+安装升级不切换项目采用，不覆盖项目副本、已生成文档或自改指引。本次只读定位也不“修复”索引／清单。更新模板或提示词先比较差异，保留项目旧稿和修改，明确目标和相应授权后才单独合并，不批量升级实例。已选源失效只限制依赖范围，可独立继续的部分仍可继续。
+
+沿用项目命名，一能力一目录。同 PBC 多主题 PRD 各自独立版本；AD／TestCase固定直接上游，不强制同号或猜最大版本。写前整理项目根、阶段／作业、业务身份、实际资源及本地差异、输入、唯一输出、假设／Q和停点，展开“占位符→字段→值→来源”，实际写入及最终回读同一路径。现稿先读，不机械升版；权限、归属或覆盖风险未清不写。
+
+## 5. 文档、JSON与手动交接
+
+文档生成后完整回读、展示路径并交审，不自动创建或更新JSON。用户明确采用后才用init／select记录所选输入，清单顶层仅schemaVersion、scope、selected；resolve只读解析。手动路径方式继续可用，候选登记及撤回不再提供。
+
+
+第一步用企业任务、模板及原方法形成规格集合；第二步将本次选定集合交原 Plan，再按获准任务 Build／test／review／Ship。原方法不会天然读写 JSON，需要明确任务或适用的项目指引实际组织来源；S11另验证接点。Plan 保留 tasks/plan.md 和唯一 todo／tracker，不生成影子 SPEC 绕过原入口限制。
+
+review／recheck 只读会话标注，独立审查需真实新上下文；审查者不改文档、项目、JSON或报告，获准调用者另存。人工可修改、明确委托、有据不采纳或保持 Q。原型按需并行；TestCase为Plan的可选输入，验证内容、六项要求和依赖任务执行条件仍须满足。生成文档不等于采用，选用登记不等于批准、开工或测试通过，不自动进入下一阶段。
+
+## 6. 可直接说的任务
+
+- “按企业SOP，查找本项目采用资料，为巡检管理的任务编排主题生成PRD，完成后交我审阅。”
+- “按企业SOP准备本主题AD。有已采用公共规范就引用；没有则说明选已有规范或起草候选的选项，技术栈和骨架等我调整确认，不自动生成一批资料。”
+- “本次只读核对交接：读取项目选定的JSON及本主题实际来源，列缺口，不写任何文件，不生成下一阶段。”
+- “本次按路径手动传递所选PRD、AD、已有规范和骨架说明，不创建JSON；核对后只规划供我审阅，已有TestCase则引用，没有则按依赖安排补齐。”
+- “本次使用标准流程，生成原标准规格，不采用企业SOP。”
+
+以上为自然语言任务，不是已实现的新 slash 或业务 CLI。资源合同、源码分发闭包、安装、宿主加载、模型实际读取、内容质量、工程执行、人工验收和发布分别取证。
+
+## 7. 新增、修改、撤销和功能退役
+
+按[生命周期合同](lifecycle-contract.md)先核意图与候选／目标／已实现事实，选本次阶段及唯一目标。新增主题独立版本，修改保留完整目标，取消不标任务完成，已完成任务和历史报告保留；已实现功能通过新退役设计与获准工程任务移除。资料作业不顺带改Plan、任务、代码、生产或其他主题，JSON改为明确选用登记，本修订未测试；既有改选保护保留，撤销／退役引用差量及完整组合恢复仍按计划范围，本片最小恢复见上文；真实原Plan与Build交接留S11。
+
+可以说“按企业SOP，修订本主题的完整PRD，说明新增／修改／保留／撤销及配套影响，只写本次候选交我审阅”；或“只读分析撤销某FR／功能退役，核文档、JSON、任务和消费者，零项目写入”。不新增变更子命令，不因资源升级改变标准流程或项目永久选择。
+
+B05-r2收尾澄清：最后一次Write／Edit后分段完整读取最终稿；全文回读后再Edit也须再次完整覆盖，不以局部回读冒充最终全文核对。必要输入缺读先明确缺口，补读不追认为过去已读。本修订不新增读取守卫或扩大辅助资料的按需适用范围。
+
+## B05收口：适用性与外层证据
+
+先按本次目标确定必要输入，不把所有工程文件、辅助模板或Plan／todo都设为所有阶段前置；涉及已有任务、影响或不存在断言时，回读对应实际来源或明确未核。候选列表和现稿中自称的比较材料只是线索，只有本次明确指定的比较范围才读取未选版本。不得用现稿元数据自行扩大本轮任务。
+
+“未读取／部分读取”“读取失败”“已验证路径缺失”“不在本次选定集合”“内容尚未核实”分别陈述。无消费者、无需迁移、不受影响及全历史不存在等结论给出实际已核范围；没有证据时保留Q，不从未读推出否定。模板章节与业务现稿章节分开引用，Glob无匹配不证明目录存在且为空。
+
+外层校验按实际返回行核必要输入全文、唯一目标末次编辑后全文回读、未选／越界读取及只读边界。审查者每条发现和已核事实附所指文件的短原文摘录；摘录匹配及读取通过仍不代替理由和反例的人工核验。校验失败保留稿件与局部意见，明确受限范围，不声称完整交接，不自动修稿或推进。新入口、JSON登记及原Plan／Build消费仍留后续。
+
+## 审查输出契约与定向复核
+
+资源组合0.5.2补齐[审查会话契约](verification/review-output.schema.json)、外层错误分类与调用者来源角色绑定，详见[说明](verification/readme.md)。原生失败不改写；定向格式／来源复核不自动改业务稿，达到当次约定轮次仍失败交人工裁定。该工具仍由外层明确执行，不自动加载／拦截原方法。
+
+## 来源角色同源生成增量
+
+当前组合0.5.3采用[共用生成与校验工具](verification/readme.md)：同一scope角色表为模型生成role枚举，并在实际CLI参数核对；授权校订报告独立检查内容，不追认为原生通过。仅自有辅助变化，四阶段及辅助模板正文、原版技能和命令保持。新独立验证一次，失败交人工裁定，不发布。
+
+## S06最小交接切片
+
+资料根固定为本次实际加载的SOP Skill的 `references/`；源码为 `skills/i3-enterprise-sop/references/`，品牌安装为 `skills/i3-enterprise-sop/references/`。工程目录资料在其 `engineering-skeleton/` 子目录。项目已采用副本仍按真实采用记录读取，不改其位置或正文。
+
+[handoff.py](handoff.py)提供三字段清单创建、明确初次选用和只读解析，接口及限制见[交接合同§8](handoff-contract.md#8-s06最小辅助与边界)。手动路径方式不要求使用工具或创建JSON。共享JSON只存路径，不保存批准、完成率或运行结果。脚本读取不代替模型全文回读与语义核对。
+
+本片不含命令接入、既有选择替换、完整修订恢复、独立审查调度、Plan／Build自动消费或工程生成；对应S07—S11及I4／I5继续保留。模板正文和业务稿不变，先交人工审阅，暂不发布。
+
+## 7. spec/ 业务目录与原生命令
+
+新项目的BRD、同PBC多主题PRD、各自AD与TestCase默认写入spec/{能力}/，命名沿共用合同；现有项目约定优先，不搬旧稿／历史。这里的spec/是业务输出，SOP Skill的references/是安装资料，两者不混用。起草／修订必先成功调用原Spec Skill，使用其外部格式与存储能力；原/i3-spec包装及using不变。
+
+原Plan使用本次AD与其明确引用的产品／工程集合承接六项，原Build按获准任务继续；原Build auto保持其规格、Git、完整计划认可及逐任务测试／构建／提交停点。具体输入示例和上下文范围见[交接合同§10](handoff-contract.md#10-从选定-ad-到原-planbuild-的输入合同)。JSON不天然触发或被原命令读写，手动准确路径继续支持。只有当前主题和必要共享约束进入上下文，摘要不能替代真实正文。
+
+/i3-sop无参数只读引导；brd／prd／ad／testcase为单阶段文档任务，plan为一次原规划交接，review／status只读；未知动作及auto不写入、不猜阶段。直接Skill和命令规则相同。工程骨架由AD选择、Plan排任务、获准Build应用验证；本资料不提供可运行骨架生成器，I4／I5仍需真实工程验证。
+
+## 8. 短命令与原规划交接
+
+可以直接使用/i3-sop brd、prd、ad、testcase或plan；明确调用本Skill并给同一动作也适用。不新增必填参数或路径。先定位已有项目材料，只问本次缺少的业务事实／对象选择；唯一且充分就继续，不重复确认。结构化问答取决于宿主实际可用工具，否则会话提问并等待；取消／无答复不写占位文件。
+
+四阶段写作仍须成功调用原Spec并守内容与停轮；plan按[规划交接](plan-handoff.md)只读解析本主题清单或手动材料，完整读准确PRD／AD、已采用规范／必要契约、工程采用与相关代码，实际加载原规划Skill并履行原Plan命令义务。保存原tasks/plan.md与唯一任务目标，回读交审后停轮，不写业务稿／JSON、不自动Build。无清单可手动，标准原/i3-plan不强制读handoff；27技能／11命令不变。
+
+四阶段模板正文、审查提示词／Schema及原方法保持。已逐条覆盖的当前发行共用规则可使用审查辅助的固定资料指纹；未知／自改组合继续完整读取选定原件，不放宽判据或冒用旧证据。
+
+## 11. SOP Plan读取与身份停点
+
+JSON与手动输入共用[规划交接](plan-handoff.md)的首批完整读取及原方法检查点，手动不省略共用规则。文件名清单统一登记于stages.json的planHandoff.requiredResourceReads；辅助解析不代替模型阅读全文。AD能力／主题身份或直接上游路径／PRD版本矛盾时先停，不加载原规划、不写plan／todo或候选计划。PRD与AD独立版本不必同号，未知非阻断Q与身份冲突分开处理；不改业务稿、JSON或原版能力。

package/skills/i3-enterprise-sop/references/recovery-contract.md

@@ -0,0 +1,65 @@
+# S08 最小恢复规则
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+规则版本：v0.4.0；本次只做源码修改，未测试、未发布；适用于显式企业 SOP 的状态核对、中断恢复、路径补录、重复执行和人工修改保护。命令与直接 Skill 共用本规则，不增加顶级命令或修改原方法。先读[Skill](../SKILL.md)及[交接合同](handoff-contract.md)，handoff.py 仍保留init／select／resolve 三操作，业务 JSON 仍 schemaVersion 1；同主题改选采用单独的受控预览合同。
+
+本地增量采用[受控辅助](controlled-handoff.md)时，预检只读、回执校验、明确选用登记由外层程序顺序执行。缺读可在同一只读作业内补齐，仍不完整、调用拒绝、报告矛盾或文件变化则不启动登记；结果给原因、推荐与可选操作。只约束从该入口进入的单次交接，原失败与其他会话不追认。
+
+## 1. 先核当前事实
+
+确定项目根、工作范围、主题、唯一目标和本次允许写入对象。实际读项目规则、采用来源、资源根 README／stages.json／三份共用合同；使用安装清单定位时核 name、version、scope、catalog.skills及本次SOP Skill精确assets，资料取实际Skill的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；不是新增顶级命令。当前提示不代替缺失的实际项目／主题／目标选择，已采用指引可提供这些准确路径。