@givolt/i3-composer-agent 3.1.0 → 4.0.0

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

@@ -1,4 +1,4 @@
-# PRD 模板草案
+# PRD 模板
 
 <!-- i3:zh-guide:start -->
 ## 中文使用说明
@@ -8,39 +8,55 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-模板版本：v0.0.4。日期：2026-10-17。状态：待评审，未作为运行技能安装。
+模板版本：v0.1.6。模板版本与业务文档版本分别维护。
 
-采用[模板与交接合同](../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，覆盖该PBC当前明确的完整范围，通过文档版本迭代；不再按主题拆成独立PRD。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中使用同一条件；核多角色组合、对象归属、状态例外、只读／写入及“有权决定”与“代记结果”的差别。来源未授予的动作不得默认开放。
+- 字段生成、存储、展示、可编辑、必填和校验分别定义；系统生成不自动意味着页面必显或用户必填。校验拒绝、权限拒绝、技术失败和提交结果未知分别表达；成功、重复、取消、历史及跨PBC副作用有真实依据。
+- 展开完整当前有效目标，共用要求落实到适用Story／AC或给出不适用理由；旧行为只有本次选定条目才生效，比较资料不自动成为需求。保留、替代、停止适用和未实现分开，范围缩减保留理由、影响及真实决定。
+- 每条AC的前置、动作、可观察结果和来源可定位；复合AC拆可追踪子项。已知依赖列双方准确对象／版本、受影响Story／AC、冻结或决定时点、联调组织、环境／数据／权限／服务前提和实际就绪状态，不能将未知写成已就绪。
+- 最终新增规范性要求回查原意、条件、例外和要求强度；推导／建议不变成已确认。来源矛盾保留双方，问题、建议和未处理事项不为清零而关闭；没有业务决定的规则不能交AD或编码自行选择。
 
 ---
 
-# {PBC名称} · {需求主题} — 产品需求文档
+# {PBC名称} — 产品需求文档
 
 ## 0. 文档身份、输入与确认
 
 | 项目 | 本次实际值 |
 | --- | --- |
-| 所属 EBC/PBC | `{各自capabilityId、名称、已确认或候选边界}` |
-| 产品需求身份 | `{稳定prdId；主题名称；改名不换身份}` |
-| 文档身份/版本/位置 | `{documentId；实际版本；完整路径/固定副本及摘要}` |
+| 所属 EBC | `{ebcId；ebcName；已确认或候选边界}` |
+| 所属 PBC | `{pbcId；pbcName；已确认或候选边界}` |
+| 产品需求身份 | `{本PBC的PRD documentId；实际版本与范围；改名不换身份}` |
+| 文档身份/版本/位置 | `{documentId；类型PRD；实际业务版本；完整路径/固定副本及摘要}` |
 | 状态和责任 | `{草稿/待评审/实际认可范围；维护、编写与确认责任}` |
 | 采用模板与业务输入 | `{固定模板、BRD及实际业务答复；按下表登记}` |
-| 比较基准 | `{前一有效PRD、相关主题、适用原型及实际代码/数据/部署；未实现写未实现}` |
-| 变化与有效目标 | `{本主题新增/修改/保留/替代/停用条目；旧内容可固定引用，不能只交差异摘要}` |
+| 比较基准 | `{前一有效PRD、相关PBC、适用原型及实际代码/数据/部署；未实现写未实现}` |
+| 变化与有效目标 | `{本PBC新增/修改/保留/替代/停用条目；旧内容可固定引用，不能只交差异摘要}` |
 
 ### 0.1 固定输入
 
-| 输入 ID | 对象、文件及具体条目 | 版本与可回读内容/摘要 | 来源性质 | 本次用途/采用范围 | 实际认可与缺口 |
+| 引用 ID／类型 | 来源身份／实际路径或URL／具体条目 | 文内版本／固定提交与可回读内容（摘要可选） | 来源性质 | 本次用途／采用范围／落实位置 | 实际认可与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{IN别名}` | `{BRD/SRC/业务答复/旧PRD/共用规则/相关主题}` | `{固定引用；不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标/上下文/仅比较}` | `{实际情况}` |
+| `{IN别名；直接BRD／SRC／业务答复／旧PRD／共用规则／相关PBC}` | `{来源名称／documentId（如有）及适用ebcId／pbcId；准确位置和条款}` | `{来源正文版本或固定提交／副本；不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标／上下文／仅比较及本文对应位置}` | `{实际情况}` |
+
+直接BRD须能回读其documentId、文内版本、实际路径及承接条款，所属EBC与本稿相同；PBC编号和名称沿用其分配或真实业务决定。跨PBC参考显式标明来源身份和用途，不替代本PBC直接依据。各文档独立版本，名称变化不换编号；引用在现有表内组织，不另建平行清单。
 
 ### 0.2 变更与认可
 
-| 本版变化及来源 | 比较基准 | 受影响条目/其他主题 | 原型/AD/TestCase/实现需复核什么 | 实际认可来源与范围 |
+| 本版变化及来源 | 比较基准 | 受影响条目/其他PBC | 原型/AD/TestCase/实现需复核什么 | 实际认可来源与范围 |
 | --- | --- | --- | --- | --- |
 | `{真实差异}` | `{可回读旧内容}` | `{稳定ID}` | `{待处理或实际记录}` | `{未取得不预填}` |
 
@@ -50,7 +66,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 | --- | --- | --- | --- | --- | --- |
 | `{沿用 FT/US/FR；无编号用源位置，不重排}` | `{本 PRD 第6章卡片或选定旧文档卡片}` | `{身份、版本、具体位置及内容/摘要}` | `{有效目标/上下文/仅比较；新增/修改/保留/替代/停用}` | `{完整/缺失/冲突及受影响范围}` | `{实际代码/环境依据；未实现/未验证如实写}` |
 
-逐条登记本主题的完整有效行为，不能只登记本次差异。有效目标、比较材料与未来规划分开；一条有效行为选定一个权威正文。第4.2节目录与本表引用同一来源，不各自维护另一套当前有效答案。沿用旧编号及来源关系；拆分、合并、改名时保留原标识与新条目的映射，不将已有 FR 与 US 擅自视为一对一。来源缺项不能宣称原型或 AD 输入已经完整；未纳入本次改动不等于停用，引用一条旧行为不能复活旧文件内其他已被替代条目。
+逐条登记本PBC的完整有效行为，不能只登记本次差异。有效目标、比较材料与未来规划分开；一条有效行为选定一个权威正文。第4.2节目录与本表引用同一来源，不各自维护另一套当前有效答案。沿用旧编号及来源关系；拆分、合并、改名时保留原标识与新条目的映射，不将已有 FR 与 US 擅自视为一对一。来源缺项不能宣称原型或 AD 输入已经完整；未纳入本次改动不等于停用，引用一条旧行为不能复活旧文件内其他已被替代条目。
 
 ## 1. 目标与业务成功
 
@@ -58,15 +74,15 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 | --- | --- | --- | --- | --- |
 | `{沿用ID或标候选}` | `{文档身份/版本/条目}` | `{业务结果，不只系统上线}` | `{有依据的方式或待定}` | `{事实/建议/真实答复}` |
 
-区分本主题的功能验收和需要真实使用数据的业务效果。未知收益/阈值不臆造；人员或系统数量不自动成为并发容量目标。
+区分本PBC的功能验收和需要真实使用数据的业务效果。未知收益/阈值不臆造；人员或系统数量不自动成为并发容量目标。
 
-## 2. 主题范围、PBC 责任与协作
+## 2. PBC范围、责任与协作
 
-| BR/场景/约束 | 本主题承接内容 | 本版/后续/排除/待定 | 功能或共用要求 | 其他主题/PBC 去向 | 依据与缺口 |
+| BR/场景/约束 | 本PBC承接内容 | 本版/后续/排除/待定 | 功能或共用要求 | 其他PBC 去向 | 依据与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{capabilityId/prdId/未分配}` | `{来源/决定/Q}` |
+| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{pbcId／未分配；跨EBC时标明ebcId}` | `{来源/决定/Q}` |
 
-说明本 PBC 维护哪些业务事实，本主题负责哪些部分，与同 PBC 其他 PRD 的交接是什么。一个主题可包含多个功能，一个功能也可在本主题的多个版本中演进；不按文件或页面数量推导仓库、服务或能力拆分。
+说明本PBC维护哪些业务事实及完整范围，与其他PBC如何协作。一个PBC包含多个功能，功能通过同一PRD的后续版本演进；不按文件或页面数量推导仓库、服务或能力拆分。
 
 | 明确排除/限制 | 来源与含义 | 容易误增的能力 | 与范围内信息的界线 |
 | --- | --- | --- | --- |
@@ -86,7 +102,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ### 4.1 端到端业务闭环
 
-`{用户触发→各角色操作→业务结果→后续接收方；含失败、拒绝、补救/重做、退出及跨主题交接，可按实际给业务流程图。}`
+`{用户触发→各角色操作→业务结果→后续接收方；含失败、拒绝、补救/重做、退出及跨PBC交接，可按实际给业务流程图。}`
 
 | 场景/步骤 | 角色与输入 | 动作及业务前提 | 输出与事实维护者 | 异常/未知/重做 | 功能/规则来源 |
 | --- | --- | --- | --- | --- | --- |
@@ -94,7 +110,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ### 4.2 功能目录
 
-| Feature ID/名称或分组 | Story/功能 ID 与名称 | 来源 BR/场景 | 用户价值 | 本版处理 | 完整行为位置 | 依赖/相关主题 | 优先级依据 |
+| Feature ID/名称或分组 | Story/功能 ID 与名称 | 来源 BR/场景 | 用户价值 | 本版处理 | 完整行为位置 | 依赖/相关PBC | 优先级依据 |
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | `{沿用 FT；来源无分组时注明，不强造层级}` | `{沿用 US/FR 体系；历史标识映射见0.3}` | `{准确来源}` | `{用户结果}` | `{新增/修改/保留/替代/停用}` | `{第6章卡片或固定有效旧内容，与0.3一致}` | `{明确引用}` | `{来源等级/建议/实际采用分开；未给定不默认P0}` |
 
@@ -104,7 +120,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ### 4.3 跨功能闭环与既有行为影响
 
-| 对象/原状态 | 操作与条件 | 目标状态及业务结果 | 拒绝/失败/未知结果 | 跨 Feature/Story 或主题的输入输出/先后条件 | 受影响既有行为/AC与回归输入 |
+| 对象/原状态 | 操作与条件 | 目标状态及业务结果 | 拒绝/失败/未知结果 | 跨 Feature/Story 或PBC的输入输出/先后条件 | 受影响既有行为/AC与回归输入 |
 | --- | --- | --- | --- | --- | --- |
 | `{BO及固定规则}` | `{真实动作}` | `{可观察结果}` | `{有依据的产品表现或Q}` | `{接收方、责任与依赖引用}` | `{已交付条目、固定版本及必须保留的行为；首次且无既有影响时写依据}` |
 
@@ -116,7 +132,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 | 对象 ID/名称 | 含义及来源 | 事实维护方与操作边界 | 对象关系/形成时点 | 信息性质 | 生命周期/历史引用 |
 | --- | --- | --- | --- | --- | --- |
-| `{BO等稳定ID}` | `{真实概念或标候选}` | `{PBC/主题/角色}` | `{有依据的关系，未知不猜基数}` | `{独立事实/只读视图/快照/外部信息}` | `{状态/保留要求}` |
+| `{BO等稳定ID}` | `{真实概念或标候选}` | `{PBC/角色}` | `{有依据的关系，未知不猜基数}` | `{独立事实/只读视图/快照/外部信息}` | `{状态/保留要求}` |
 
 | 对象.业务属性 | 业务含义 | 显示/必填/可选的条件 | 校验与来源 | 确认/问题 |
 | --- | --- | --- | --- | --- |
@@ -126,11 +142,11 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ### 5.2 共用业务规则
 
-| 规则 ID | 完整规则与适用范围 | 条件/例外/拒绝时表现 | 事实维护位置 | 来源与认可 | 相关功能/主题 |
+| 规则 ID | 完整规则与适用范围 | 条件/例外/拒绝时表现 | 事实维护位置 | 来源与认可 | 相关功能/PBC |
 | --- | --- | --- | --- | --- | --- |
 | `{RULE等稳定ID}` | `{明确行为}` | `{已知结果或Q}` | `{本处或固定外部权威}` | `{明示/推导/真实确认}` | `{引用}` |
 
-相同规则只定义一处。跨主题共享时固定引用维护者及版本，不在各 PRD 私下改成不同规则。
+相同规则只定义一处。跨PBC共享时固定引用维护者及版本，不在各 PRD 私下改成不同规则。
 
 ### 5.3 状态、版本与业务变更历史
 
@@ -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章}`。
@@ -152,7 +177,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 4. **异常、边界与退出**：`{校验拒绝、无权限、空结果、依赖失败、重复/并发、超时结果未知、撤销/取消和重做的实际适用表现}`。
 5. **规则与数据**：`{引用对象、属性、规则；本功能专用校验/默认/修改时机有来源；不在此设计API或表}`。
 6. **页面与交互**：`{入口、页面状态、操作、反馈及适用原型版本；无界面写依据}`。
-7. **协作与业务事件**：`{跨主题/PBC/外部/人工交接，输入输出含义、允许/禁止动作、失败后谁处理；无则说明}`。
+7. **协作与业务事件**：`{跨PBC/外部/人工交接，输入输出含义、允许/禁止动作、失败后谁处理；无则说明}`。
 8. **来源与实际认可**：`{BR/场景/答复固定引用，候选项及问题ID；不在展开时把候选转确定}`。
 9. **AC**：按下表逐条定义。
 
@@ -164,17 +189,17 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ## 7. 页面、渠道、协作与智能能力
 
-| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型引用及确认/缺口 |
+| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型准确引用及确认／缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象，不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{版本/范围；未形成注明}` |
+| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象，不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{引用ID；实际路径或URL；版本／固定提交；页面／交互范围；实际采用与未决。未形成注明，不预填路径}` |
 
-布局、视觉及交互由原型表达；本 PRD 仍维护产品规则与完整行为。原型反馈改变业务规则时回到本处修订；认可原型不能自动改写未批准需求。
+布局、视觉及交互由 `i3-ui-demo` 制作或维护的原型表达，按需另行发起；固定引用实例准确路径、版本、HANDOFF、设计与 QA 资料及实际认可范围。本 PRD 仍维护产品规则与完整行为。原型反馈改变业务规则时回到本处修订；认可原型不能自动改写未批准需求。
 
 | 协作/事件/智能能力 | 发生条件与业务输入输出 | 责任方/权威事实 | 失败、人工介入与禁止边界 | 来源/采用状态 |
 | --- | --- | --- | --- | --- |
-| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{capabilityId/prdId/外部主体}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
+| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{pbcId／外部主体；跨EBC时标明ebcId}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
 
-## 8. 质量、身份、审计与跨主题依赖
+## 8. 质量、身份、审计与跨PBC依赖
 
 | 要求/依赖 ID | 对业务的影响 | 条件/阈值与固定来源 | 适用功能/AC | 实际可用性或待核实项 | AD/TestCase 承接 |
 | --- | --- | --- | --- | --- | --- |
@@ -182,7 +207,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 逐项核对共用业务规则、质量、身份、隔离和生命周期要求：每项必须落到适用 Story/功能及 AC，或写有依据的不适用理由；共用规则存在不等于逐行为已落实。反向核对每条行为和 AC 都有产品来源或明确候选理由，不以覆盖数量代替含义。
 
-已知执行依赖与待业务答复的问题分开。跨主题的组合及兼容关系按明确版本登记，不从同 PBC 推定任意版本都可组合。
+已知执行依赖与待业务答复的问题分开。跨PBC的组合及兼容关系按明确版本登记；同PBC的PRD、AD、TestCase也须绑定准确配套版本，不能因能力相同就认为任意版本可组合。
 
 ### 8.1 已知执行依赖与交接时点
 
@@ -194,7 +219,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ## 9. 开放问题与变化影响
 
-| Q ID | 具体缺失/冲突与双方来源 | 受影响功能/AC/主题 | 可继续/不能交接什么 | 所需答复与责任 | 真实关闭依据 |
+| Q ID | 具体缺失/冲突与双方来源 | 受影响功能/AC/PBC | 可继续/不能交接什么 | 所需答复与责任 | 真实关闭依据 |
 | --- | --- | --- | --- | --- | --- |
 | `{稳定ID}` | `{不择一当事实}` | `{条目}` | `{具体动作}` | `{主体或未指定}` | `{未取得则待确认}` |
 
@@ -202,39 +227,54 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件，并提供业务边
 
 ## 10. 全文追溯与交接
 
-| BRD/SRC/外部约束 | 本主题承接或排除依据 | 功能/对象/规则/页面/AC | 其他主题去向 | 实际认可/未决 |
+| BRD/SRC/外部约束 | 本PBC承接或排除依据 | 功能/对象/规则/页面/AC | 其他PBC去向 | 实际认可/未决 |
 | --- | --- | --- | --- | --- |
 | `{准确条目}` | `{完整限制也要承接}` | `{稳定引用}` | `{有则登记}` | `{真实记录}` |
 
 ### 10.1 内容检查
 
 - 产品目标、边界、角色动作、数据范围、完整流程和明确排除均有来源。
-- 本主题全部有效功能有完整行为和逐条 AC；目录、原型截图或差异摘要不能代替正文。
+- 本PBC全部有效功能有完整行为和逐条 AC；目录、原型截图或差异摘要不能代替正文。
 - 业务对象、状态、页面可见时点、事件与历史要求相互一致，无默认扩权或无源指标。
-- 共用规则单源，跨主题版本与责任明确；旧条目保留/替代/停用关系可追溯。
+- 共用规则单源，跨PBC版本与责任明确；旧条目保留/替代/停用关系可追溯。
 - 候选/假设/冲突保持标记；模板确认不转成产品认可，未决项具体限制范围。
 - 工程内容与测试策略有明确承接位置；早期未形成则登记缺口，不从业务认可推定原技能所需规格内容已齐备。
 
 ### 10.2 S01—S14 逐项核对
 
-这些编号用于核对本主题选定版本的内容与交接条件，结果记录在本 PRD 内。每行填写实际位置/证据、齐备/部分/缺失/不适用及理由；模板存在或模型勾选不能代替实际核对。
+这些编号用于核对本PBC选定版本的内容与交接条件，结果记录在本 PRD 内。每行填写实际位置/证据、齐备/部分/缺失/不适用及理由；模板存在或模型勾选不能代替实际核对。
 
 | 编号 | 本 PRD 交接前检查 | 实际位置/证据与缺口 |
 | --- | --- | --- |
-| S01 | 主题目标与 BRD/已选 PRD 范围一致；用户需求/业务假设、验证闭环和纳入/排除有来源；未知指标列缺口 | `{第1/2/4章及具体依据}` |
+| S01 | PBC目标与 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章}` |
+| S06 | 跨Feature/Story/PBC的端到端状态一致；执行依赖与开放问题分开；已交付行为影响及回归输入明确 | `{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的逐项位置与结果}` |
+| S13 | 技术实现进入AD；原型/AD/TestCase及T2工程SPEC→T3原Plan分范围交接明确；不越过有效规格、原方法认可和执行条件 | `{10.3及真实缺口}` |
+| S14 | 共用G01—G08逐项核对，身份、来源、版本、范围、变更、认可和单一权威均有实际记录 | `{本模板10.2.1的逐项位置与结果}` |
+
+### 10.2.1 共用检查 G01—G08
+
+这些是内容核对项，不是审批字段或自动通过状态。逐项填写真实位置、来源和结果，不仅勾选编号。
+
+| 编号 | 必须保留的要求 |
+| --- | --- |
+| G01 | 文档、EBC／PBC身份、版本及实际位置可定位；未绑定如实写，不猜项目或PBC |
+| 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/skills/i3-enterprise-sop/references/{testcase/templates → templates}/testcase.md

@@ -8,57 +8,65 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-原型只在本次实际适用且已采用时作为输入，不因缺少原型一律停止测试设计；依赖未定交互的用例明确待确认，其他场景可以继续。最终技术判据仍需核对选定 PRD 和有效 AD，起草不等于已经执行测试。
+模板版本：v0.1.8。模板版本与业务文档版本分别维护。
 
-**审查只标注，使用者决定处理。**文档审查者只读标注问题、准确位置、来源、影响和修改建议，不直接修改候选。使用者可以人工修改、明确委托模型修订、有依据地不采纳建议，或将业务问题保持待确认；审查意见不自动触发改写。保留旧稿、人工修改、原报告和逐项处理依据，按项目既有约束进行必要复查；缺少真实答复不为清零而补造规则，人工编辑也不自动等于审查通过或业务批准。
+## 使用说明（不复制为业务正文）
 
-模板版本：v0.0.4。日期：2026-10-18。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+- **输入：**准确选定的 PRD／配套 AD，或外部 TestCase及产品与技术依据；适用测试规范、环境和数据条件。
+- **来源选择：**完整取得所选 PRD、配套 AD及本次必要真实答复；从 AD 采用表或项目已选引用定位规约、契约与目录规范，项目自有资料优先。本次用技术规约／契约条款制定测试预期或质量判据时，直接读取实际采用原件的完整正文，不以 AD 转述代替。测试目录、命令沿用 AD 已落实的映射；直接检查目录规范条款、映射不足或有冲突时，再读实际采用的目录规范，不将其设为所有 TestCase 的统一必读。可读资料未读完先补读，不作为业务 Q 跳过；确实无法取得时说明受限范围，不声称依据齐备。
+- **输出：**对应所选PBC／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及具体影响，不适用项说明依据；缺少工程条件只限制依赖它的范围。
 
 ---
 
-# {PBC名称} · {需求主题} — 测试用例与验证合同
+# {PBC名称} — 测试用例与验证合同
 
 ## 0. 身份与固定输入
 
 | 项目 | 本次实际值 |
 | --- | --- |
-| 能力/需求主题 | `{PBC capabilityId/名称；稳定prdId/主题；适用EBC引用}` |
-| 文档身份/版本/位置 | `{documentId；实际版本；可回读路径/固定内容及摘要}` |
-| 直接 PRD 依据 | `{选定主题、PRD版本、具体条目、固定内容与摘要}` |
-| 直接 AD 依据 | `{选定AD版本/固定内容/摘要；其产品引用与本PRD是否一致}` |
-| 原型、契约与质量规则 | `{适用原型版本/认可范围；接口、数据、项目规范固定引用；不适用或缺项说明}` |
+| 所属 EBC | `{ebcId；ebcName；已确认或候选边界}` |
+| 所属 PBC | `{pbcId；pbcName；已确认或候选边界}` |
+| 产品需求依据 | `{本PBC的PRD documentId；实际版本与范围；改名不换身份}` |
+| 文档身份/版本/位置 | `{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；准确位置、版本和条款}` | `{可回读的固定内容及实际已读部分}` | `{产品预期／技术约束／交互等及用例／章节位置}` | `{实际采用、仅参考、未取得分别记录，不由文件存在推定}` |
+
+本稿与直接PRD／AD使用一致的EBC／PBC编号名称和PRD documentId，各文档独立版本，名称变化不换编号。跨PBC契约、关联PBC与外部资料明确来源身份、准确版本及采用范围，不能替代本PBC产品或设计依据。沿PRD／AD的固定引用读取必要 i3-ui-demo 实例的准确版本、HANDOFF、设计与QA资料，以及契约和适用规范，将判据落实到用例；这些资料不再依靠handoff.json扩展字段传递，也不另建平行清单。必要引用失效或版本冲突时列明缺项和影响，不从目录猜最新。
 
-本 TestCase 对应本次选定的一个 AD 版本；后续方法改进可形成新 TestCase 版本而不强制改变 AD 或 PRD 版本。同一能力其他主题可以有自己的用例集，组合交付时显式选择配套集合及集成范围，不自动合并目录中全部最新文件。
+本 TestCase 对应本次选定的一个 AD 版本；后续方法改进可形成新 TestCase 版本而不强制改变 AD 或 PRD 版本。同一能力其他PBC可以有自己的用例集，组合交付时显式选择配套集合及集成范围，不自动合并目录中全部最新文件。
 
-### 0.2 跨主题采用依据与原方法分工
+### 0.2 跨PBC采用依据与原方法分工
 
-先读本主题选定PRD与直接配套AD，再按实际共享定义读取项目已采用公共技术规约、契约正文和必要关联主题。关联AD／TestCase只用于本次组合和交接，不替代本主题产品来源，不把整目录最大版本或未采用候选纳入。基本引用按实际路径、正文版本与条款核对，摘要可选；来源失效或冲突列Q及受影响范围，不静默换源，也不从历史测试恢复旧答案。
+先读本PBC选定PRD与直接配套AD，再按实际共享定义读取项目已采用公共技术规约、契约正文和必要关联PBC。关联AD／TestCase只用于本次组合和交接，不替代本PBC产品来源，不把整目录最大版本或未采用候选纳入。基本引用按实际路径、正文版本与条款核对，摘要可选；来源失效或冲突列Q及受影响范围，不静默换源，也不从历史测试恢复旧答案。
 
 | 方法／产物 | 职责与输入 | 输出及权限边界 |
 | --- | --- | --- |
 | 企业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. 验证目标、范围与排除
 
-`{本主题需要证明的业务行为、全部AC/复合子项、关键端到端流程、相关工程质量及受影响既有功能。产品功能验收与运行后业务效果分别说明；未知阈值或观察周期标待确认，不编造。}`
+`{本PBC需要证明的业务行为、全部AC/复合子项、关键端到端流程、相关工程质量及受影响既有功能。产品功能验收与运行后业务效果分别说明；未知阈值或观察周期标待确认，不编造。}`
 
 | 验证对象 | 本次纳入内容 | 排除/暂不能执行范围及理由 | 依赖/风险 | 所需方法 |
 | --- | --- | --- | --- | --- |
@@ -105,7 +113,7 @@
 
 本章定义所需条件；它们的实际就绪情况在执行前独立核实。示例身份不等于真实授权，模拟服务不等于已接通真实依赖，不将生产数据或高风险故障注入当默认测试材料。
 
-### 3.3 跨主题组合的执行条件
+### 3.3 跨PBC组合的执行条件
 
 | 条件ID／组合ID | 提供／消费方及受影响用例 | 规范／契约／数据／实现的选定引用 | 就绪核实与真实／替身边界 | 准备、失败、清理及恢复 | 缺口及可继续部分 |
 | --- | --- | --- | --- | --- | --- |
@@ -115,6 +123,8 @@
 
 ## 4. 详细用例（逐用例填写）
 
+**EARS 使用：**将来源中行为的条件和状态写入前置条件，将事件写入操作或输入，将响应和副作用写成可判断的预期与检查方法；关联相应需求编号、AC和 AD条款，覆盖适用的正常、拒绝和异常场景。来源未采用 EARS句式时，按原意设计用例。
+
 ### {TC ID} · {用例名称}
 
 1. **来源**：`{PRD需求/AC/子项、AD技术条款及其他适用规范的身份、版本和准确位置}`。
@@ -147,21 +157,21 @@
 
 维度用于核对，不要求无相关需求的产品强行增加功能或专项；不适用要有明确依据。
 
-## 6. 跨主题组合、变化与回归
+## 6. 跨PBC组合、变化与回归
 
-| 变更前基准/本次目标 | 受影响主题/功能/状态/契约 | 保留/修订/新增/停止适用的用例 | 选择依据与风险 | 必须重取的证据 |
+| 变更前基准/本次目标 | 受影响PBC/功能/状态/契约 | 保留/修订/新增/停止适用的用例 | 选择依据与风险 | 必须重取的证据 |
 | --- | --- | --- | --- | --- |
 | `{PRD/AD/用例/代码固定引用}` | `{精确范围}` | `{版本与替代关系}` | `{未变ID不等于未变预期}` | `{需求/实现/依赖/环境变化影响}` |
 
-多主题组合登记各自 PRD/AD/TestCase 版本，检查共享状态/字段/权限/接口一致性与交接，不以单份检查通过代替组合验证。历史运行仍保留在原对象和环境版本下；未受影响的证据也需说明适用依据，不直接复制为新目标通过。
+多PBC组合登记各自 PRD/AD/TestCase 版本，检查共享状态/字段/权限/接口一致性与交接，不以单份检查通过代替组合验证。历史运行仍保留在原对象和环境版本下；未受影响的证据也需说明适用依据，不直接复制为新目标通过。
 
 ### 6.1 明确本次兼容组合
 
-| 组合ID／作用范围 | 本主题PRD／AD／TestCase实际路径和各自版本 | 提供／消费方主题及配套引用 | 公共规范条款／契约与数据权威 | 实现／制品／环境事实 | 设计判断、执行状态与缺口 |
+| 组合ID／作用范围 | 本PBCPRD／AD／TestCase实际路径和各自版本 | 提供／消费方PBC及配套引用 | 公共规范条款／契约与数据权威 | 实现／制品／环境事实 | 设计判断、执行状态与缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{独立主题或本次集成组合}` | `{以正文及真实采用为准，不强制同号}` | `{仅相关范围；缺关联TestCase如实记，不造未来文件路径}` | `{准确位置／版本；实际共享定义不在用例中复制另一权威}` | `{已有／拟建／未知；代码或服务不存在不填已部署}` | `{相容／冲突／待核实与依据；不预填运行通过}` |
+| `{独立PBC或本次集成组合}` | `{各自documentId、准确路径及文内版本，以正文及真实采用为准，不强制同号}` | `{提供／消费方ebcId／pbcId及配套引用；仅相关范围，缺关联TestCase如实记，不造未来文件路径}` | `{来源引用ID、准确位置／版本／条款；实际共享定义不在用例中复制另一权威}` | `{已有／拟建／未知；代码或服务不存在不填已部署}` | `{相容／冲突／待核实与依据；不预填运行通过}` |
 
-一个主题TestCase仍对应本主题选定PRD和一个直接AD版本，关联引用用于组合场景；不用总用例文档包办全部主题，不要求双方版本数值一致。文档、契约、代码、服务各自版本属于不同对象，不能跨对象比较大小或据同号／SemVer／Schema校验宣布语义兼容。默认值、枚举、权限、错误、副作用及严格消费者均应核对。
+本PBC的一份逻辑TestCase对应选定PRD和一个直接AD版本，关联引用用于组合场景；不用总用例文档包办全部PBC，不要求双方版本数值一致。文档、契约、代码、服务各自版本属于不同对象，不能跨对象比较大小或据同号／SemVer／Schema校验宣布语义兼容。默认值、枚举、权限、错误、副作用及严格消费者均应核对。
 
 ### 6.2 跨边界场景与最终权威
 
@@ -181,11 +191,11 @@
 
 ### 6.4 变更影响与既有行为回归
 
-| 变化条款／权威位置 | 直接及必要传递影响 | 受影响主题AD／AC／用例及已有任务 | 必须保留／补取的回归证据 | 无关范围与不受影响依据 | 处理决定／Q |
+| 变化条款／权威位置 | 直接及必要传递影响 | 受影响PBCAD／AC／用例及已有任务 | 必须保留／补取的回归证据 | 无关范围与不受影响依据 | 处理决定／Q |
 | --- | --- | --- | --- | --- | --- |
-| `{公共规范、契约、实体、代码或环境的实际变化}` | `{定义→提供方→消费者→必要下游}` | `{有真实任务才登记，不造Plan或tracker项}` | `{旧调用方、拒绝、未知与恢复及既有业务行为}` | `{未消费该定义或明确不受影响；不机械改写全部主题}` | `{降级／移出必需回归要真实理由与决定}` |
+| `{公共规范、契约、实体、代码或环境的实际变化}` | `{定义→提供方→消费者→必要下游}` | `{有真实任务才登记，不造Plan或tracker项}` | `{旧调用方、拒绝、未知与恢复及既有业务行为}` | `{未消费该定义或明确不受影响；不机械改写全部PBC}` | `{降级／移出必需回归要真实理由与决定}` |
 
-公共变化不能只查本主题，也不能把所有AD／PRD统一升版。共享底座、迁移和测试夹具的后续工程修改应在唯一任务目标安排归属，相关任务列依赖；本次仅设计，不生成第二份Plan或竞争tracker，不改人工代码及其他主题。
+公共变化不能只查本PBC，也不能把所有AD／PRD统一升版。共享底座、迁移和测试夹具的后续工程修改应在唯一任务目标安排归属，相关任务列依赖；本次仅设计，不生成第二份Plan或竞争tracker，不改人工代码及其他PBC。
 
 ## 7. 两种结论与执行准入
 
@@ -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仍保留本PBCTestCase设计交付，允许其与T2／T3按依赖衔接，不取消正式交付所要求的验证定义。用例与任务、脚本可以多对多；只有真实脚本和任务形成后才登记实际路径，人工用例明确执行方式，不伪造全部自动化。
 
 ### 7.2 执行可准入（候选形成后另存核实记录）
 
@@ -206,7 +216,7 @@
 | 任务和操作授权 | `{Plan范围/执行模式及适用高风险动作授权}` | `{可信来源；沿用有效授权，不自填批准}` |
 | 内容新鲜度与安全边界 | `{版本未变、影响已复核、清理/恢复可执行}` | `{失效范围、阻断用例或独立可执行部分}` |
 
-准入结论由实际核实产生并保存到独立记录，不回填本章为永久通过。设计可用于形成 Plan，不要求先有获批 Plan 才能编写计划；真正运行才核实计划认可和实际执行条件。缺必需条件的用例不准入、不算通过。
+准入结论由实际核实产生并保存到独立记录，不回填本章为永久通过。设计经T2落实到工程SPEC，供T3原Plan使用；不要求先有获批Plan才能编写计划，真正运行才核实计划认可和实际执行条件。缺必需条件的用例不准入、不算通过。
 
 ### 7.3 适用通过判据、缺陷处理与重测
 
@@ -218,14 +228,14 @@
 
 ## 8. 测试报告合同：一份用例集，多次运行
 
-测试报告另存于能力目录的实际报告位置，按项目登记解析；命名采用 `{PBC}-{需求主题}-TestReport_v{报告版本}.md`，不强制跟 TestCase 同号。报告版本标识文档修订，`runId` 标识一次真实运行；报告编辑不伪造新运行，重测产生的新运行不覆盖前次失败。
+测试报告另存于能力目录的实际报告位置，按项目登记解析；命名采用 `{PBC名称}-TestReport_v{报告版本}.md`，不强制跟 TestCase 同号。报告版本标识文档修订，`runId` 标识一次真实运行；报告编辑不伪造新运行，重测产生的新运行不覆盖前次失败。
 
 ### 8.1 报告必须记录的事实
 
 | 报告字段 | 执行后记录要求 |
 | --- | --- |
 | 报告身份与运行 | `{报告ID/版本、runId、实际起止时间、执行主体、实际工具/运行方式}` |
-| 本次选择 | `{capabilityId/prdId；PRD/AD/TestCase准确版本、固定内容及摘要；多主题组合逐项登记}` |
+| 本次选择 | `{ebcId／ebcName、pbcId／pbcName、PRD documentId；PRD/AD/TestCase的documentId、准确路径、文内版本及固定内容，摘要按需；多PBC组合逐项登记}` |
 | 本次组合 | `{§6.1组合ID；提供／消费方文档、契约、数据、代码／服务及环境各自版本；设计配套与真实兼容分开}` |
 | 实际候选 | `{源提交、构建/镜像制品、摘要；实际启动/部署对象，未部署不能写已部署}` |
 | 实际环境 | `{配置、依赖、身份/权限、数据版本及来源、真实/模拟边界；不泄露密钥}` |
@@ -255,15 +265,15 @@
 
 ### 完成核对
 
-- PRD 直接覆盖与 AD 工程覆盖均完整，复合子项、跨主题交接及必要回归未漏。
+- PRD 直接覆盖与 AD 工程覆盖均完整，复合子项、跨PBC交接及必要回归未漏。
 - 每个用例九要素明确，允许/禁止副作用可判定，阈值和预期有来源。
 - 所需环境/数据与实际可用状态分开，替身不冒充真实集成。
 - 框架／工具版本、测试目录、层级和适用覆盖要求明确，与 AD 命令／cwd 及项目质量权威一致；未安装、未执行及不适用范围如实登记。
 - 规格可交接、执行可准入、实际运行、业务认可分别记录，无循环开工条件。
 - 报告字段和1:N运行关系明确，未执行不预填通过；旧证据和失败记录保留。
-- §0.2、§3.3、§6.1—§6.4中的准确组合、唯一权威、失败恢复、传递影响和无关主题保护有实际来源。
-- §7.1不把完整TestCase设为所有Plan的前置；原test／Build仍执行TDD，原代码review与零写入文档审查职责分开。
+- §0.2、§3.3、§6.1—§6.4中的准确组合、唯一权威、失败恢复、传递影响和无关PBC保护有实际来源。
+- §7.1不把完整TestCase设为T2工程SPEC或T3原Plan的统一前置；原test／Build仍执行TDD，原代码review与零写入文档审查职责分开。
 
-交接结论：`{本次可供Plan采用的验证要求、尚不能确定的判据和影响；实际执行须另行准入。当前版本及真实认可范围如实记录。}`
+交接结论：`{本次供T2工程SPEC及后续T3任务采用的验证要求、尚不能确定的判据和影响；实际执行须另行准入。当前版本及真实认可范围如实记录。}`
 
 版本变化：`{变化来源、修改用例/子项、受影响需求/AD/执行任务及报告适用性；保留旧版本与重新采用依据。}`

package/skills/i3-frontend-ui-engineering/SKILL.md

@@ -29,10 +29,6 @@ Build production-quality user interfaces that are accessible, performant, and vi
 - Adding interactivity or state management
 - Fixing visual or UX issues
 
-## Applicable Prototype Baselines
-
-Read the project prototype index at `prototypes/index.json`, falling back to legacy `.i3-ui-prototypes.json` when no new index exists. Select the entry whose `appliesTo` contains the explicit business module ID; an empty array applies to no module, and conflicting indices or multiple matches require resolution before selecting a baseline. New associations are derived from fixed scope.moduleIds by `i3-ui-prototype`, not inferred from a PRD filename. Then read its `baseline.json`, `design-system/MASTER.md`, tokens and page rules. Preserve approved design and interaction decisions; explain conflicts with new requirements instead of silently changing them. New pages reuse the selected template and component conventions. Changes to global tokens, navigation, component behavior or business states go through the `i3-ui-prototype` workflow and corresponding review. HTML review prototypes need explicit component mapping when implemented in another framework. Verify affected production pages in the browser; a prototype manifest check alone does not prove production fidelity. Projects without an applicable baseline retain this skill's existing workflow.
-
 ## Component Architecture
 
 ### File Structure
@@ -95,20 +91,20 @@ export function TaskItem({ task, onToggle, onDelete }: TaskItemProps) {
 ```tsx
 // Container: handles data
 export function TaskListContainer() {
-  const { tasks, isLoading, error, refetch } = useTasks();
+  const { tasks, isLoading, error, refetch, toggleTask, deleteTask } = useTasks();
 
   if (isLoading) return <TaskListSkeleton />;
   if (error) return <ErrorState message="Failed to load tasks" retry={refetch} />;
   if (tasks.length === 0) return <EmptyState message="No tasks yet" />;
 
-  return <TaskList tasks={tasks} />;
+  return <TaskList tasks={tasks} onToggle={toggleTask} onDelete={deleteTask} />;
 }
 
 // Presentation: handles rendering
-export function TaskList({ tasks }: { tasks: Task[] }) {
+export function TaskList({ tasks, onToggle, onDelete }: { tasks: Task[] } & Pick<TaskItemProps, 'onToggle' | 'onDelete'>) {
   return (
     <ul role="list" className="divide-y">
-      {tasks.map(task => <TaskItem key={task.id} task={task} />)}
+      {tasks.map(task => <TaskItem key={task.id} task={task} onToggle={onToggle} onDelete={onDelete} />)}
     </ul>
   );
 }
@@ -250,7 +246,7 @@ function Dialog({ isOpen, onClose }: DialogProps) {
 
 ```tsx
 // Don't show blank screens
-function TaskList({ tasks }: { tasks: Task[] }) {
+function TaskList({ tasks, onCreateTask }: { tasks: Task[]; onCreateTask: () => void }) {
   if (tasks.length === 0) {
     return (
       <div role="status" className="text-center py-12">
@@ -288,7 +284,7 @@ Test at these breakpoints: 320px, 768px, 1024px, 1440px.
 // Skeleton loading (not spinners for content)
 function TaskListSkeleton() {
   return (
-    <div className="space-y-3" aria-busy="true" aria-label="Loading tasks">
+    <div className="space-y-3" role="status" aria-busy="true" aria-label="Loading tasks">
       {Array.from({ length: 3 }).map((_, i) => (
         <div key={i} className="h-12 bg-muted animate-pulse rounded" />
       ))}

package/skills/i3-idea-refine/SKILL.md

@@ -40,8 +40,10 @@ Refines raw ideas into sharp, actionable concepts worth building through structu
 This skill is primarily an interactive dialogue. Invoke it with an idea, and the agent will guide you through the process.
 
 ```bash
-# Optional: Initialize the ideas directory
-bash skills/i3-idea-refine/scripts/idea-refine.sh
+# Optional. Run from the project root so this creates ./docs/ideas.
+# <skill-dir> is the directory that contains this SKILL.md
+# (for example .agents/skills/i3-idea-refine or .cursor/skills/i3-idea-refine).
+bash <skill-dir>/scripts/idea-refine.sh
 ```
 
 ## Output