@givolt/i3-composer-agent 3.0.0 → 3.2.1

package/{references/enterprise-sop-resources/brd/templates/BRD.md → skills/i3-enterprise-sop/references/templates/brd.md}

@@ -8,11 +8,18 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-模板版本：v0.0.3。日期：2026-10-17。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+模板版本：v0.1.6。模板版本与业务文档版本分别维护。
 
-采用[模板与交接合同](../../template-contracts.md)。一个 EBC 维护一份逻辑 BRD，可有多个文档版本。实例文件名为 `{EBC}-BRD_v0.0.1.md`。以下为填写结构；未知项登记 Q，建议/假设明确标注，不适用项说明依据。交付实例时用真实内容替换花括号，不预填认可或执行结果。
+## 使用说明（不复制为业务正文）
 
-BRD 承接原 SPEC 的目标、用户与业务成功依据；工程命令、目录、代码风格和工程动作边界由 AD、测试策略由 TestCase 承接，完整映射见共用合同 §4.1。整理业务草稿不要求先形成这些工程文档；单份 BRD 的认可也不能冒充全部规格已获批准。外部编排遵守原技能停点，不因本模板改变继承能力或强制复制 SPEC。
+- **输入：**自然语言业务诉求或外部 BRD；已有背景、目标、角色、场景、约束及真实答复按实际采用读取。
+- **输出：**一个 EBC 的逻辑 BRD及明确的 PBC 建议；默认直接保存到业务项目的`spec/`根目录，路径为`spec/{EBC名称}-BRD_v{业务版本}.md`。已有明确采用位置或外部原件保留实际路径，不自动迁移。
+- **阶段职责：**根据业务目标、输入输出、对象与规则责任、依赖和独立演进识别 PBC，不把菜单、部门、数据表或服务自动当作 PBC。
+- **写作：**主会话按本 Skill 显式使用原 Spec；来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史，不预填批准或运行结果。
+- **交付：**按下文完整填写适用内容，不以标题或数量代替语义覆盖；新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性，分段写入或报错时核对相关内容，保留内容自查；检查完成后按本Skill自动登记本次文档路径，再交人工审阅并停轮。登记不表示批准，只读审查只标注问题，不改稿或登记。
+- **工程衔接：**T1形成企业文档并交审；T2显式使用原 Spec，结合选定依据落实六项、形成工程 SPEC并交审；T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点，不自动推进。工程事实缺失如实说明，不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时，沿原方法处理。
+
+未知项写明 Q及具体影响，不适用项说明依据；缺少工程条件只限制依赖它的范围。
 
 ---
 
@@ -20,14 +27,16 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据；工程命令、目
 
 | 文档属性 | 实际内容 |
 | --- | --- |
-| EBC 身份与名称 | `{capabilityId；显示名称；责任边界}` |
-| 文档身份、版本、状态 | `{documentId；v0.0.1或实际版本；实际状态}` |
+| EBC 身份与名称 | `{ebcId；ebcName；责任边界及已确认或候选状态}` |
+| 文档身份、版本、状态 | `{documentId；类型BRD；v0.0.1或实际业务版本；实际状态}` |
 | 文件位置与固定内容 | `{完整路径或仓库引用；固定副本/提交及摘要；未绑定则注明}` |
 | 发起人、维护者、编写者 | `{真实主体；业务维护与代理编写分开}` |
 | 创建/更新日期 | `{真实日期}` |
 | 采用模板及公共基线 | `{固定模板版本与内容；实际取得的集团/项目基线；缺项及影响}` |
 | 比较基准与确认范围 | `{前一有效版本或无前稿；实际认可来源；未取得确认直写未取得}` |
 
+沿已有来源、采用和交接位置固定引用：记录引用ID／类型、来源名称与身份、实际路径或URL、正文版本或固定提交及具体条款、本次采用范围与落实位置、实际状态和缺口，摘要按需记录。来源没有稳定编号时用文内引用ID，不虚构能力或文档编号；直接依据与关联参考分别标明用途。本文身份属于一个EBC，多个PBC的编号、名称和边界在第8章分配表记录。名称变化不换编号，引用也不因JSON精简而省略；不用额外的平行清单。
+
 ## 0. 版本历史与采用范围
 
 | 文档版本/日期 | 实际主体 | 修改内容及来源 | 与前版关系 | 受影响 PBC/主题和处理 |
@@ -38,7 +47,7 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据；工程命令、目
 
 ### 1.1 原始诉求与现状
 
-`{保留发起人原始诉求或可回读 SRC 引用；描述当前业务方式、涉及对象与已核实事实。原件只读，整理不覆盖原始材料。}`
+`{保留发起人原始诉求或可回读SRC引用；标明引用ID／类型、来源身份、准确位置、版本或固定内容、引用条款和用途，未取得处写缺口；描述当前业务方式、涉及对象与已核实事实。原件只读，整理不覆盖原始材料。}`
 
 ### 1.2 问题与影响
 
@@ -78,6 +87,8 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据；工程命令、目
 | --- | --- | --- | --- | --- | --- | --- |
 | `{稳定BR}` | `{具体诉求}` | `{来源等级或未给定}` | `{本次/后续/候选/排除}` | `{问题/目标}` | `{SRC及真实主体}` | `{可观察结果}` |
 
+**EARS 使用：**对适用的业务规则，写清条件、事件及业务结果；涉及系统行为时明确由哪个系统响应。背景、价值和目标仍按本模板表达；未确定的规则列待确认问题，不擅自增加技术实现。
+
 BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优先级与交付安排分开，不把全部高优需求自动当作已批准范围。
 
 ### 4.3 智能能力业务边界（适用时）
@@ -106,9 +117,9 @@ BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优
 
 ## 8. 范围与 PBC 分配
 
-| BR/明确约束 | 本次/后续/排除/待定 | 承接 PBC | 产品需求主题或待细化 | 其他责任方/去向 | 依据及缺口 |
+| BR/明确约束 | 本次/后续/排除/待定 | 承接 PBC 编号／名称 | 产品需求主题或待细化 | 其他责任方/去向 | 依据及缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{稳定引用}` | `{明确分类}` | `{capabilityId；候选边界标候选}` | `{已有prdId/主题或待定，不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
+| `{稳定引用}` | `{明确分类}` | `{pbcId；pbcName；候选边界标候选}` | `{已有prdId／主题名称或待定，不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
 
 每条业务诉求和范围外限制都有去向；一个 BR 可以分配给多个 PBC，但共用业务事实应明确权威维护方，不产生相互冲突的副本。“本次不做”不自动变成“以后必须做”。
 
@@ -156,9 +167,9 @@ BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优
 
 ### 13.3 PRD 交接摘要
 
-`{本次交接的BRD身份/版本/固定内容、承接PBC及主题、BR清单、排除和后续项、Q及影响、适用外部基线。PRD形成后由PRD维护具体功能和AC，不在此预填尚未产生的条目或通过结论。}`
+`{本次交接的ebcId／ebcName、BRD documentId／文内版本／实际路径与固定内容、承接pbcId／pbcName及已有prdId／主题、BR清单、排除和后续项、Q及影响、适用外部基线的准确引用。已有PRD记录其真实文档身份、路径、版本与承接范围；未形成时写未形成，不预填文件或编号。PRD形成后由PRD维护具体功能和AC，不在此预填尚未产生的条目或通过结论。}`
 
-本摘要是业务交接输入，不改变原技能的审批或输出合同。Plan、质量约束、ADR 和实际验证记录等仍按各自适用方法保留，模板状态或填写参与者不产生授权。
+本摘要供后续企业文档及 T2工程 SPEC读取必要业务背景；T3依据选定工程 SPEC调用原规划。原技能的审批与输出合同、质量约束、ADR和实际验证要求继续保留，模板状态或填写参与者不产生授权。
 
 ## 完成核对
 

package/{references/enterprise-sop-resources/prd/templates/PRD.md → skills/i3-enterprise-sop/references/templates/prd.md}

@@ -1,4 +1,4 @@
-# PRD 模板草案
+# PRD 模板
 
 <!-- i3:zh-guide:start -->
 ## 中文使用说明
@@ -8,13 +8,26 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-模板版本：v0.0.4。日期：2026-10-17。状态：待评审，未作为运行技能安装。
+模板版本：v0.1.5。模板版本与业务文档版本分别维护。
 
-采用[模板与交接合同](../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节。本模板升级不自动修改业务实例、采用关系或业务版本。
+- **输入：**BRD与本次 PBC／主题，或外部 PRD及其业务依据；已确认答复、适用共享规则和必要比较材料。
+- **输出：**一个 PBC 下的一个独立主题 PRD；默认保存到业务项目的本PBC目录，路径为`spec/{PBC名称}/{PBC名称}-{主题名称}-PRD_v{业务版本}.md`。已有明确采用位置或外部原件保留实际路径，不自动迁移。
+- **阶段职责：**一个 PBC 可有多个主题 PRD，各有稳定 prdId 和独立版本。Feature／Story、FT／US／FR／AC、九项行为语义与 S01—S14、G01—G08 全部保留，不要求另建 Stories 或 MVP 阶段。字段／API／数据库等工程实现由配套 [AD模板](ad.md) 承接。
+- **写作：**主会话按本 Skill 显式使用原 Spec；来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史，不预填批准或运行结果。
+- **交付：**按下文完整填写适用内容，不以标题或数量代替语义覆盖；新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性，分段写入或报错时核对相关内容，保留内容自查；检查完成后按本Skill自动登记本次文档路径，再交人工审阅并停轮。登记不表示批准，只读审查只标注问题，不改稿或登记。
+- **工程衔接：**T1形成企业文档并交审；T2显式使用原 Spec，结合选定依据落实六项、形成工程 SPEC并交审；T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点，不自动推进。工程事实缺失如实说明，不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时，沿原方法处理。
 
-PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边界依据；原 SPEC 的工程命令、目录、代码风格、测试策略与工程边界按共用合同 §4.1 分别进入 AD／TestCase。不得因单份 PRD 已生成就宣称六项内容或规格认可全部完成，也不为满足映射另造第五核心规格或强制复制 SPEC。调用原技能时保留其澄清、保存后停轮及后续认可要求。
+未知项写明 Q及具体影响，不适用项说明依据；缺少工程条件只限制依赖它的范围。
+
+### 产品语义核对
+
+- 权限在角色表、规则、正常／拒绝流程、状态、页面、协作、AC和Q中使用同一条件；核多角色组合、对象归属、状态例外、只读／写入及“有权决定”与“代记结果”的差别。来源未授予的动作不得默认开放。
+- 字段生成、存储、展示、可编辑、必填和校验分别定义；系统生成不自动意味着页面必显或用户必填。校验拒绝、权限拒绝、技术失败和提交结果未知分别表达；成功、重复、取消、历史及跨主题副作用有真实依据。
+- 展开完整当前有效目标，共用要求落实到适用Story／AC或给出不适用理由；旧行为只有本次选定条目才生效，比较资料不自动成为需求。保留、替代、停止适用和未实现分开，范围缩减保留理由、影响及真实决定。
+- 每条AC的前置、动作、可观察结果和来源可定位；复合AC拆可追踪子项。已知依赖列双方准确对象／版本、受影响Story／AC、冻结或决定时点、联调组织、环境／数据／权限／服务前提和实际就绪状态，不能将未知写成已就绪。
+- 最终新增规范性要求回查原意、条件、例外和要求强度；推导／建议不变成已确认。来源矛盾保留双方，问题、建议和未处理事项不为清零而关闭；没有业务决定的规则不能交AD或编码自行选择。
 
 ---
 
@@ -24,9 +37,10 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 | 项目 | 本次实际值 |
 | --- | --- |
-| 所属 EBC/PBC | `{各自capabilityId、名称、已确认或候选边界}` |
+| 所属 EBC | `{ebcId；ebcName；已确认或候选边界}` |
+| 所属 PBC | `{pbcId；pbcName；已确认或候选边界}` |
 | 产品需求身份 | `{稳定prdId；主题名称；改名不换身份}` |
-| 文档身份/版本/位置 | `{documentId；实际版本；完整路径/固定副本及摘要}` |
+| 文档身份/版本/位置 | `{documentId；类型PRD；实际业务版本；完整路径/固定副本及摘要}` |
 | 状态和责任 | `{草稿/待评审/实际认可范围；维护、编写与确认责任}` |
 | 采用模板与业务输入 | `{固定模板、BRD及实际业务答复；按下表登记}` |
 | 比较基准 | `{前一有效PRD、相关主题、适用原型及实际代码/数据/部署；未实现写未实现}` |
@@ -34,9 +48,11 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ### 0.1 固定输入
 
-| 输入 ID | 对象、文件及具体条目 | 版本与可回读内容/摘要 | 来源性质 | 本次用途/采用范围 | 实际认可与缺口 |
+| 引用 ID／类型 | 来源身份／实际路径或URL／具体条目 | 文内版本／固定提交与可回读内容（摘要可选） | 来源性质 | 本次用途／采用范围／落实位置 | 实际认可与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{IN别名}` | `{BRD/SRC/业务答复/旧PRD/共用规则/相关主题}` | `{固定引用；不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标/上下文/仅比较}` | `{实际情况}` |
+| `{IN别名；直接BRD／SRC／业务答复／旧PRD／共用规则／相关主题}` | `{来源名称／documentId（如有）及适用ebcId／pbcId／prdId；准确位置和条款}` | `{来源正文版本或固定提交／副本；不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标／上下文／仅比较及本文对应位置}` | `{实际情况}` |
+
+直接BRD须能回读其documentId、文内版本、实际路径及承接条款，所属EBC与本主题一致；PBC编号和名称沿用其分配或真实业务决定。跨PBC参考显式标明来源身份和用途，不替代本主题直接依据。各文档独立版本，名称变化不换编号；引用在现有表内组织，不另建平行清单。
 
 ### 0.2 变更与认可
 
@@ -64,7 +80,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 | BR/场景/约束 | 本主题承接内容 | 本版/后续/排除/待定 | 功能或共用要求 | 其他主题/PBC 去向 | 依据与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{capabilityId/prdId/未分配}` | `{来源/决定/Q}` |
+| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{pbcId／prdId／未分配；跨EBC时标明ebcId}` | `{来源/决定/Q}` |
 
 说明本 PBC 维护哪些业务事实，本主题负责哪些部分，与同 PBC 其他 PRD 的交接是什么。一个主题可包含多个功能，一个功能也可在本主题的多个版本中演进；不按文件或页面数量推导仓库、服务或能力拆分。
 
@@ -144,6 +160,15 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 对每项新增/修改 Story 或可独立验收的功能展开以下卡片；保留行为可以固定引用完整有效卡片，不要求复制第二份正文。一个 Feature 可有多条 Story，一个功能包含多个独立行为时分别展开，不以一张概括功能卡替代全部行为。简单功能可合并成表，但九项语义和 AC 必须可定位；无页面或无协作的项目写不适用及依据。未知产品行为登记问题，不用“待 AD 确认”替代。
 
+**EARS 句式指引（按适用行为选用）：**功能要求可参考 [EARS](https://alistairmavin.com/ears/)，用简短句式写明条件与系统响应：
+
+- 常态：`{系统}应{可观察响应}`。
+- 事件：`当{事件}发生时，{系统}应{可观察响应}`。
+- 状态：`在{状态}期间，{系统}应{持续约束或响应}`。
+- 异常：`若{异常条件}成立，则{系统}应{处理结果及副作用边界}`。
+
+状态与事件可组合。保留来源中的要求强度、条件及例外，不补造权限、状态、参数或阈值；未知项登记 Q。句式指引不代替下列九项语义、逐条 AC及来源追溯，也不要求改写背景、目标或既有编号。
+
 ### {Story/功能 ID} · {名称}（所属 Feature/分组及原标识映射见0.3）
 
 1. **用户与目标**：`{角色及价值，引用第3章}`。
@@ -164,15 +189,15 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ## 7. 页面、渠道、协作与智能能力
 
-| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型引用及确认/缺口 |
+| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型准确引用及确认／缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象，不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{版本/范围；未形成注明}` |
+| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象，不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{引用ID；实际路径或URL；版本／固定提交；页面／交互范围；实际采用与未决。未形成注明，不预填路径}` |
 
 布局、视觉及交互由原型表达；本 PRD 仍维护产品规则与完整行为。原型反馈改变业务规则时回到本处修订；认可原型不能自动改写未批准需求。
 
 | 协作/事件/智能能力 | 发生条件与业务输入输出 | 责任方/权威事实 | 失败、人工介入与禁止边界 | 来源/采用状态 |
 | --- | --- | --- | --- | --- |
-| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{capabilityId/prdId/外部主体}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
+| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{pbcId／prdId／外部主体；跨EBC时标明ebcId}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
 
 ## 8. 质量、身份、审计与跨主题依赖
 
@@ -233,8 +258,23 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 | 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的逐项位置与结果}` |
+| S13 | 技术实现进入AD；原型/AD/TestCase及T2工程SPEC→T3原Plan分范围交接明确；不越过有效规格、原方法认可和执行条件 | `{10.3及真实缺口}` |
+| S14 | 共用G01—G08逐项核对，身份、来源、版本、范围、变更、认可和单一权威均有实际记录 | `{本模板10.2.1的逐项位置与结果}` |
+
+### 10.2.1 共用检查 G01—G08
+
+这些是内容核对项，不是审批字段或自动通过状态。逐项填写真实位置、来源和结果，不仅勾选编号。
+
+| 编号 | 必须保留的要求 |
+| --- | --- |
+| G01 | 文档、能力、主题、版本及实际位置可定位；未绑定如实写，不猜项目或主题 |
+| G02 | 明示、推导、真实确认、冲突、演练假设分别表达；候选不自动变确定 |
+| G03 | 全量核对目标、价值、角色、范围、场景、附件、质量及明确排除，不只读场景摘要 |
+| G04 | 输入及附件可回读，版本矛盾照录、缺附件登记、不自动取最新；真实已读范围有依据 |
+| G05 | 当前有效目标、上下文、比较基准及真实实现／生产现状分开；保留需求不证明代码可复用 |
+| G06 | 修订先读旧稿及人工修改，保留原件、理由、影响；无变化不加版本，模板／方法变化不自动重建或重放外部动作 |
+| G07 | 认可绑定实际修订、范围、参与者、时间及固定记录；模板、业务、开工、生产认可分别表达，不预填批准／实现／测试通过 |
+| G08 | 规则和执行状态各有单一权威；缺口限制具体依赖范围，不造平行状态表或任务数据库 |
 
 ### 10.3 分范围交接
 
@@ -243,15 +283,8 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 | 原型 | `{本PRD固定版、完整有效功能/AC、适用设计规则}` | `{缺失规则、实际验证和具体版本人审}` |
 | AD | `{选定PRD版、功能/数据/权限/质量定义及原型}` | `{真实工程基线、精确契约与技术风险}` |
 | TestCase | `{选定PRD版、产品预期与适用AD/原型}` | `{技术判据、环境/候选和实际执行条件}` |
-| Plan | `{本PRD选定版的完整有效行为/AC、8.1依赖、4.3产品影响与回归输入}` | `{仍需适用AD/TestCase/工程规范、六项覆盖及原方法要求的认可；PRD单独交接不代表可计划或可开工}` |
+| T2工程SPEC→T3原Plan | `{本PRD选定版的完整有效行为/AC、8.1依赖、4.3产品影响与回归输入}` | `{T2须结合准确AD、采用规范、适用TestCase等落实六项并交审；T3读取选定工程SPEC交原规划，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/命令。 |
+本结论不改写继承 Skill 或命令的输出、触发、工具、验证和审批合同；实际认可按本 Skill与原方法保留人审停点，Plan、CONSTRAINTS、ADR、实际测试和报告等辅助产物继续按适用方法维护。

package/{references/enterprise-sop-resources/testcase/templates/TestCase.md → skills/i3-enterprise-sop/references/templates/testcase.md}

@@ -8,15 +8,19 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-原型只在本次实际适用且已采用时作为输入，不因缺少原型一律停止测试设计；依赖未定交互的用例明确待确认，其他场景可以继续。最终技术判据仍需核对选定 PRD 和有效 AD，起草不等于已经执行测试。
+模板版本：v0.1.7。模板版本与业务文档版本分别维护。
 
-**审查只标注，使用者决定处理。**文档审查者只读标注问题、准确位置、来源、影响和修改建议，不直接修改候选。使用者可以人工修改、明确委托模型修订、有依据地不采纳建议，或将业务问题保持待确认；审查意见不自动触发改写。保留旧稿、人工修改、原报告和逐项处理依据，按项目既有约束进行必要复查；缺少真实答复不为清零而补造规则，人工编辑也不自动等于审查通过或业务批准。
+## 使用说明（不复制为业务正文）
 
-模板版本：v0.0.4。日期：2026-10-18。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+- **输入：**准确选定的 PRD／配套 AD，或外部 TestCase及产品与技术依据；适用测试规范、环境和数据条件。
+- **来源选择：**完整取得所选 PRD、配套 AD及本次必要真实答复；从 AD 采用表或项目已选引用定位规约、契约与目录规范，项目自有资料优先。本次用技术规约／契约条款制定测试预期或质量判据时，直接读取实际采用原件的完整正文，不以 AD 转述代替。测试目录、命令沿用 AD 已落实的映射；直接检查目录规范条款、映射不足或有冲突时，再读实际采用的目录规范，不将其设为所有 TestCase 的统一必读。可读资料未读完先补读，不作为业务 Q 跳过；确实无法取得时说明受限范围，不声称依据齐备。
+- **输出：**对应所选主题／AD的测试设计；默认保存到业务项目的本PBC目录，路径为`spec/{PBC名称}/{PBC名称}-{主题名称}-TestCase_v{业务版本}.md`，实际运行另存TestReport。已有明确采用位置或外部原件保留实际路径，不自动迁移。
+- **阶段职责：**产品预期直接核 PRD，技术判据核 AD和正式契约，不只由 AD 反推需求。完整交接绑定所选直接上游；关键依据缺失先澄清或标明受限范围，不伪造预期。TestCase不是所有 Plan 的统一前置；已有适用版本应引用，测试策略仍须充分。
+- **写作：**主会话按本 Skill 显式使用原 Spec；来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史，不预填批准或运行结果。
+- **交付：**按下文完整填写适用内容，不以标题或数量代替语义覆盖；新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性，分段写入或报错时核对相关内容，保留内容自查；检查完成后按本Skill自动登记本次文档路径，再交人工审阅并停轮。登记不表示批准，只读审查只标注问题，不改稿或登记。
+- **工程衔接：**T1形成企业文档并交审；T2显式使用原 Spec，结合选定依据落实六项、形成工程 SPEC并交审；T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点，不自动推进。工程事实缺失如实说明，不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时，沿原方法处理。
 
-采用[模板与交接合同](../../template-contracts.md)。实例文件名为 `{PBC}-{需求主题}-TestCase_v0.0.1.md`，其中包含多条用例与回归/评估安排。直接读取选定的 PRD、AD 和适用原型，不只从 AD 反推需求；设计遗漏也应被覆盖检查发现。所需条件、判据和报告合同先明确，真实执行结果另写一份或多份 TestReport，不预填通过结论。
-
-本模板承接原 SPEC 的测试策略：明确框架、测试目录、测试层级和适用覆盖要求，并固定引用 AD 的完整测试命令及运行条件。测试代码、实际报告、CONSTRAINTS 与其他辅助产物继续按原方法保留；本模板不替代原 TDD、浏览器或其他 Skill 的工具、步骤、停点和验证要求，也不强制复制 SPEC。
+未知项写明 Q及具体影响，不适用项说明依据；缺少工程条件只限制依赖它的范围。
 
 ---
 
@@ -26,19 +30,23 @@
 
 | 项目 | 本次实际值 |
 | --- | --- |
-| 能力/需求主题 | `{PBC capabilityId/名称；稳定prdId/主题；适用EBC引用}` |
-| 文档身份/版本/位置 | `{documentId；实际版本；可回读路径/固定内容及摘要}` |
-| 直接 PRD 依据 | `{选定主题、PRD版本、具体条目、固定内容与摘要}` |
-| 直接 AD 依据 | `{选定AD版本/固定内容/摘要；其产品引用与本PRD是否一致}` |
-| 原型、契约与质量规则 | `{适用原型版本/认可范围；接口、数据、项目规范固定引用；不适用或缺项说明}` |
+| 所属 EBC | `{ebcId；ebcName；已确认或候选边界}` |
+| 所属 PBC | `{pbcId；pbcName；已确认或候选边界}` |
+| 产品需求主题 | `{稳定prdId；主题名称；改名不换身份}` |
+| 文档身份/版本/位置 | `{documentId；类型TestCase；实际业务版本；可回读路径/固定内容及摘要}` |
+| 直接 PRD 依据 | `{选定PRD的documentId、实际路径、文内版本、需求／AC具体条目及固定内容；摘要可选}` |
+| 直接 AD 依据 | `{选定AD的documentId、实际路径、文内版本、设计条款及固定内容；其直接PRD身份／路径／版本与本PRD一致；摘要可选}` |
+| 原型、契约与质量规则 | `{引用ID、来源身份、实际路径或URL、版本或固定提交、条款／页面及本次采用范围；不适用或缺项说明}` |
 | 当前范围/比较基准 | `{全部有效目标、变化和保留；前次用例/真实实现及历史运行，不混为当前通过证明}` |
 | 模板/责任/状态 | `{固定模板；设计、复核、执行与业务验收责任；未指定如实写}` |
 
 ### 0.1 输入与确认核对
 
-| 输入 ID | 身份/版本/具体条目 | 固定内容/摘要与已读范围 | 用途与权威定义 | 认可/真实可用性/缺口 |
+| 引用 ID／类型 | 来源身份／实际路径或URL／文内版本或固定提交／具体条目 | 固定内容（摘要可选）与已读范围 | 本次用途／采用范围／判据落实位置与权威定义 | 认可/真实可用性/缺口 |
 | --- | --- | --- | --- | --- |
-| `{别名}` | `{PRD/AD/原型/外部规范/真实答复}` | `{可回读引用}` | `{产品预期/技术约束/交互等}` | `{分别记录，不由文件存在推定}` |
+| `{IN别名；直接PRD／直接AD／原型／契约／外部规范／真实答复}` | `{documentId或资料标识及适用ebcId／pbcId／prdId；准确位置、版本和条款}` | `{可回读的固定内容及实际已读部分}` | `{产品预期／技术约束／交互等及用例／章节位置}` | `{实际采用、仅参考、未取得分别记录，不由文件存在推定}` |
+
+本稿与直接PRD／AD使用一致的EBC／PBC编号名称和prdId，各文档独立版本，名称变化不换编号。跨PBC契约、关联主题与外部资料明确来源身份、准确版本及采用范围，不能替代本主题产品或设计依据。沿PRD／AD的固定引用读取必要原型、契约和适用规范，将判据落实到用例；这些资料不再依靠handoff.json扩展字段传递，也不另建平行清单。必要引用失效或版本冲突时列明缺项和影响，不从目录猜最新。
 
 本 TestCase 对应本次选定的一个 AD 版本；后续方法改进可形成新 TestCase 版本而不强制改变 AD 或 PRD 版本。同一能力其他主题可以有自己的用例集，组合交付时显式选择配套集合及集成范围，不自动合并目录中全部最新文件。
 
@@ -49,12 +57,12 @@
 | 方法／产物 | 职责与输入 | 输出及权限边界 |
 | --- | --- | --- |
 | 企业TestCase | 按PRD产品预期、AD技术判据及采用规范设计用例 | 测试设计与报告合同，不编写测试代码、不运行测试、不预填结果 |
-| 原Plan | 按当前范围的需求、设计、验证要求及真实工程拆任务 | 原tasks/plan.md和唯一任务目标；TestCase为可选输入，已有则引用，没有则安排补齐设计，不统一阻断规划 |
+| T3／原Plan | 按选定工程SPEC、必要来源、验证要求及真实工程拆任务 | 原tasks/plan.md和唯一任务目标；TestCase为可选输入，已有则引用，没有则安排补齐设计，不统一阻断规划 |
 | 原Build／test | 按获准任务及相关来源执行原TDD、缺陷复现、回归与适用浏览器验证 | 业务与测试代码、实际运行及构建证据；不是只读文档作业，不更改原方法或质量门槛 |
 | 企业文档review／recheck | 独立上下文核来源、语义、覆盖和报告约定 | 零项目写入，只在会话标注；有据人工处理或明确委托修订 |
 | 原代码review | 对真实代码与测试差异作原五维审查及验证 | 保留原检查和结论标准；其中临时变异检查后恢复源码涉及写入，不能整体套作零写入的文档审查 |
 
-原test是开发／修复中的TDD入口，Build也复用它；不要求每次Build之后重复执行同一无变化测试。文档审查通过不替代代码审查、测试或人类认可，保留人工修改空间不降低原合并和发布要求。原命令不天然发现企业TestCase或JSON，实际交接需明确任务或已采用指引；本资源不实现JSON登记接点、自动跨阶段执行或宿主路由。
+原test是开发／修复中的TDD入口，Build也复用它；不要求每次Build之后重复执行同一无变化测试。文档审查通过不替代代码审查、测试或人类认可，保留人工修改空间不降低原合并和发布要求。原命令不天然发现企业TestCase或JSON，实际交接需明确任务或已采用指引；交稿路径登记由本Skill处理，本模板不负责自动跨阶段执行或宿主路由。
 
 ## 1. 验证目标、范围与排除
 
@@ -115,6 +123,8 @@
 
 ## 4. 详细用例（逐用例填写）
 
+**EARS 使用：**将来源中行为的条件和状态写入前置条件，将事件写入操作或输入，将响应和副作用写成可判断的预期与检查方法；关联相应需求编号、AC和 AD条款，覆盖适用的正常、拒绝和异常场景。来源未采用 EARS句式时，按原意设计用例。
+
 ### {TC ID} · {用例名称}
 
 1. **来源**：`{PRD需求/AC/子项、AD技术条款及其他适用规范的身份、版本和准确位置}`。
@@ -159,7 +169,7 @@
 
 | 组合ID／作用范围 | 本主题PRD／AD／TestCase实际路径和各自版本 | 提供／消费方主题及配套引用 | 公共规范条款／契约与数据权威 | 实现／制品／环境事实 | 设计判断、执行状态与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{独立主题或本次集成组合}` | `{以正文及真实采用为准，不强制同号}` | `{仅相关范围；缺关联TestCase如实记，不造未来文件路径}` | `{准确位置／版本；实际共享定义不在用例中复制另一权威}` | `{已有／拟建／未知；代码或服务不存在不填已部署}` | `{相容／冲突／待核实与依据；不预填运行通过}` |
+| `{独立主题或本次集成组合}` | `{各自documentId、准确路径及文内版本，以正文及真实采用为准，不强制同号}` | `{提供／消费方ebcId／pbcId／prdId及配套引用；仅相关范围，缺关联TestCase如实记，不造未来文件路径}` | `{来源引用ID、准确位置／版本／条款；实际共享定义不在用例中复制另一权威}` | `{已有／拟建／未知；代码或服务不存在不填已部署}` | `{相容／冲突／待核实与依据；不预填运行通过}` |
 
 一个主题TestCase仍对应本主题选定PRD和一个直接AD版本，关联引用用于组合场景；不用总用例文档包办全部主题，不要求双方版本数值一致。文档、契约、代码、服务各自版本属于不同对象，不能跨对象比较大小或据同号／SemVer／Schema校验宣布语义兼容。默认值、枚举、权限、错误、副作用及严格消费者均应核对。
 
@@ -193,9 +203,9 @@
 
 `{明确当前范围预期、方法、覆盖、所需条件、未决影响及报告约定是否足够，分别列可交接与仍缺定义范围。此结论不表示代码存在、环境可用或测试已运行。}`
 
-**TestCase是Plan的可选输入，不是统一前置文件。**当前范围的需求、技术约束和测试策略／验收预期可从PRD、AD及已采用规范充分回读时，可先按原Plan拆任务；没有独立TestCase不要求先补一份才能规划。已有且适用的TestCase应读取准确版本并落实到任务验收和验证步骤；缺少或待补的用例设计可作为计划任务，相关验证定义在依赖它的实现、测试或验收之前明确。核心行为或技术判据尚不明确时，只限制相应依赖任务，不把计划先行等同编码、测试或发布许可。
+**TestCase是工程SPEC和Plan的可选输入，不是统一前置文件。**T2可从PRD、AD及已采用规范形成含充分测试策略／验收预期的工程SPEC并交审，T3再按选定工程SPEC调用原Plan；没有独立TestCase不要求先补一份才能规划。已有且适用的TestCase应读取准确版本，经工程SPEC衔接并落实到任务验收和验证步骤；缺少或待补的用例设计可作为计划任务，相关验证定义在依赖它的实现、测试或验收之前明确。核心行为或技术判据尚不明确时，只限制相应依赖任务，不把计划先行等同编码、测试或发布许可。
 
-测试策略可在AD或现有测试规范中承载原SPEC六项的相应要求，不能因TestCase可选而跳过六项核对。企业SOP仍保留本主题TestCase设计交付，允许其与规划按依赖衔接，不取消正式交付所要求的验证定义。用例与任务、脚本可以多对多；只有真实脚本和任务形成后才登记实际路径，人工用例明确执行方式，不伪造全部自动化。
+AD或现有测试规范可提供测试策略依据，由T2落实到工程SPEC六项中的相应内容；不能因TestCase可选而跳过六项核对。企业SOP仍保留本主题TestCase设计交付，允许其与T2／T3按依赖衔接，不取消正式交付所要求的验证定义。用例与任务、脚本可以多对多；只有真实脚本和任务形成后才登记实际路径，人工用例明确执行方式，不伪造全部自动化。
 
 ### 7.2 执行可准入（候选形成后另存核实记录）
 
@@ -206,7 +216,7 @@
 | 任务和操作授权 | `{Plan范围/执行模式及适用高风险动作授权}` | `{可信来源；沿用有效授权，不自填批准}` |
 | 内容新鲜度与安全边界 | `{版本未变、影响已复核、清理/恢复可执行}` | `{失效范围、阻断用例或独立可执行部分}` |
 
-准入结论由实际核实产生并保存到独立记录，不回填本章为永久通过。设计可用于形成 Plan，不要求先有获批 Plan 才能编写计划；真正运行才核实计划认可和实际执行条件。缺必需条件的用例不准入、不算通过。
+准入结论由实际核实产生并保存到独立记录，不回填本章为永久通过。设计经T2落实到工程SPEC，供T3原Plan使用；不要求先有获批Plan才能编写计划，真正运行才核实计划认可和实际执行条件。缺必需条件的用例不准入、不算通过。
 
 ### 7.3 适用通过判据、缺陷处理与重测
 
@@ -225,7 +235,7 @@
 | 报告字段 | 执行后记录要求 |
 | --- | --- |
 | 报告身份与运行 | `{报告ID/版本、runId、实际起止时间、执行主体、实际工具/运行方式}` |
-| 本次选择 | `{capabilityId/prdId；PRD/AD/TestCase准确版本、固定内容及摘要；多主题组合逐项登记}` |
+| 本次选择 | `{ebcId／ebcName、pbcId／pbcName、prdId；PRD/AD/TestCase的documentId、准确路径、文内版本及固定内容，摘要按需；多主题组合逐项登记}` |
 | 本次组合 | `{§6.1组合ID；提供／消费方文档、契约、数据、代码／服务及环境各自版本；设计配套与真实兼容分开}` |
 | 实际候选 | `{源提交、构建/镜像制品、摘要；实际启动/部署对象，未部署不能写已部署}` |
 | 实际环境 | `{配置、依赖、身份/权限、数据版本及来源、真实/模拟边界；不泄露密钥}` |
@@ -262,8 +272,8 @@
 - 规格可交接、执行可准入、实际运行、业务认可分别记录，无循环开工条件。
 - 报告字段和1:N运行关系明确，未执行不预填通过；旧证据和失败记录保留。
 - §0.2、§3.3、§6.1—§6.4中的准确组合、唯一权威、失败恢复、传递影响和无关主题保护有实际来源。
-- §7.1不把完整TestCase设为所有Plan的前置；原test／Build仍执行TDD，原代码review与零写入文档审查职责分开。
+- §7.1不把完整TestCase设为T2工程SPEC或T3原Plan的统一前置；原test／Build仍执行TDD，原代码review与零写入文档审查职责分开。
 
-交接结论：`{本次可供Plan采用的验证要求、尚不能确定的判据和影响；实际执行须另行准入。当前版本及真实认可范围如实记录。}`
+交接结论：`{本次供T2工程SPEC及后续T3任务采用的验证要求、尚不能确定的判据和影响；实际执行须另行准入。当前版本及真实认可范围如实记录。}`
 
 版本变化：`{变化来源、修改用例/子项、受影响需求/AD/执行任务及报告适用性；保留旧版本与重新采用依据。}`