@givolt/i3-composer-agent 3.1.0 → 4.0.0

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

@@ -8,29 +8,32 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-**原型按需，AD 可并行。**AD 的直接产品依据是本次选定的 PRD；原型不是进入 AD 的统一前置。无界面时可说明不适用；有界面且页面、行为和交互定义已充分明确时，也不强制另做原型。需要原型时，可与架构、数据、接口等 AD 设计并行；关键交互未定，只限制依赖它的具体设计与交接范围。项目明确要求的原型认可仍在相应范围交接前满足，不把“可起草 AD”写成“全部设计已可实施”。
+模板版本：v0.1.7。模板版本与业务文档版本分别维护。
 
-**审查只标注，使用者决定处理。**文档审查者只读标注问题、准确位置、来源、影响和修改建议，不直接修改候选。使用者可以人工修改、明确委托模型修订、有依据地不采纳建议，或将业务问题保持待确认；审查意见不自动触发改写。保留旧稿、人工修改、原报告和逐项处理依据，按项目既有约束进行必要复查；缺少真实答复不为清零而补造规则，人工编辑也不自动等于审查通过或业务批准。
+## 使用说明（不复制为业务正文）
 
-模板版本：v0.0.4。日期：2026-10-18。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+- **输入：**准确选定的 PRD，或外部 AD及需求依据；默认带入本 Skill 自带的企业应用具体规约与目录规范，项目已有明确规约或目录约定时优先沿用，并读取必要契约与工程事实。
+- **输出：**对应本PBC一个准确PRD版本的AD；默认保存到业务项目的本PBC目录，路径为`spec/{PBC名称}/{PBC名称}-AD_v{业务版本}.md`，不强制与PRD同号。已有明确采用位置或外部原件保留实际路径，不自动迁移。
+- **阶段职责：**整体技术架构图、功能架构图、ER 图为必需视图；保留字段、接口、数据责任、权限、状态、事务、并发、恢复及完整工程定义。原型按需，可与 AD 并行，不作为统一前置。默认具体规约与目录规范是生成输入，项目明确资料优先；缺少可用具体规约时先提示按通用模板生成并交审，再继续 AD。目录约定与真实源码分别表达，采用信息直接记本 AD。
+- **写作：**主会话按本 Skill 显式使用原 Spec；来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史，不预填批准或运行结果。
+- **交付：**按下文完整填写适用内容，不以标题或数量代替语义覆盖；新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性，分段写入或报错时核对相关内容，保留内容自查；检查完成后按本Skill自动登记本次文档路径，再交人工审阅并停轮。登记不表示批准，只读审查只标注问题，不改稿或登记。
+- **工程衔接：**T1形成企业文档并交审；T2显式使用原 Spec，结合选定依据落实六项、形成工程 SPEC并交审；T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点，不自动推进。工程事实缺失如实说明，不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时，沿原方法处理。
 
-采用[模板与交接合同](../../template-contracts.md)。AD 同时承载技术架构和完整工程设计，实例文件名为 `{PBC}-{需求主题}-AD_v0.0.1.md`。本次采用一个明确 PRD 版本，不强制两份文档同号；相关主题和公共基线固定引用，不让本 AD 隐式承担另一 PRD 的全部设计。
-
-AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工程边界；测试策略与 TestCase §3.1 固定衔接。四类模板是外部规格表示，不另造第五核心规格、不强制复制 SPEC，也不改变继承 Skill 的触发、输出、工具、验证或认可要求。所填状态和字段不构成原方法所需的人类决定。
-
-**整体技术架构图、功能架构图、ER 图均为必需视图。** 下列图是填写骨架，占位实体、关系、基数和箭头不代表已经确认的架构。实例必须按真实输入替换，正文表格补全工程定义；图形齐全不等于可以实施。缺口只阻断依赖它的范围，不能为补齐图而虚构组件、表或业务规则。
+未知项写明 Q及具体影响，不适用项说明依据；缺少工程条件只限制依赖它的范围。
 
 ---
 
-# {PBC名称} · {需求主题} — 架构与工程设计
+# {PBC名称} — 架构与工程设计
 
 ## 0. 身份、采用与比较基准
 
 | 项目 | 本次实际值 |
 | --- | --- |
-| 能力与需求主题 | `{PBC capabilityId/名称；稳定prdId/主题；已知EBC引用}` |
-| 文档身份/版本/位置 | `{documentId；实际版本；可回读路径；摘要可选}` |
-| 直接产品依据 | `{唯一选定PRD身份、版本和实际路径；回读正文，摘要可选，不自动取最新}` |
+| 所属 EBC | `{ebcId；ebcName；已确认或候选边界}` |
+| 所属 PBC | `{pbcId；pbcName；已确认或候选边界}` |
+| 产品需求依据 | `{本PBC的PRD documentId；实际版本与范围；改名不换身份}` |
+| 文档身份/版本/位置 | `{documentId；类型AD；实际业务版本；可回读路径；摘要可选}` |
+| 直接产品依据 | `{唯一选定PRD的documentId、文内版本、实际路径及条款；EBC／PBC与本稿一致；回读正文，不自动取最新}` |
 | 原型/组件/公共基线 | `{适用版本与认可范围；没有或不适用则说明影响}` |
 | 当前设计范围 | `{全部有效目标、变化/保留/替代及仅比较材料}` |
 | 现有工程基准 | `{代码、数据、接口、实际运行/部署状态；未实现/未读取分别说明}` |
@@ -38,33 +41,35 @@ AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工
 
 ### 0.1 固定输入与权威定义
 
-| 输入/附件 | 实际身份/路径/文内版本（摘要可选） | 定义权威范围 | 本 AD 使用位置 | 已读/可用/认可与缺口 |
+| 引用 ID／输入或附件类型 | 来源身份／实际路径或URL／文内版本或固定提交／条款（摘要可选） | 定义权威范围 | 本 AD 使用位置 | 已读/可用/认可与缺口 |
 | --- | --- | --- | --- | --- |
-| `{PRD/原型/已有代码/外部规范/Schema等}` | `{能回读的固定内容}` | `{产品/交互/API/数据/公共规则等}` | `{章节/条目}` | `{文档存在不代表真实服务可用}` |
+| `{IN别名；直接PRD／原型／已有代码／外部规范／Schema等}` | `{documentId或资料标识及适用ebcId／pbcId；能回读的准确位置、版本和条款}` | `{产品/交互/API/数据/公共规则等}` | `{章节/条目}` | `{实际采用、仅参考或缺项；文档存在不代表真实服务可用}` |
 
 精确 OpenAPI、Schema、DDL、数据字典可以在受控附件维护，正文声明权威范围并固定引用，不能各自保存不同答案。没有附件时在正文完整定义；不能虚构附件已存在。
 
+直接PRD与本稿的EBC／PBC编号名称和PRD documentId须一致，名称变化不换编号；本文documentId与版本独立维护。跨PBC契约或关联设计明确提供方／消费方的来源身份、准确路径／版本、采用范围与本AD落实位置，不要求参考对象属于本PBC，也不允许其替代直接产品依据。原型统一通过 i3-ui-demo 制作或维护，在输入表引用实际实例路径、版本、HANDOFF、设计规则、QA 资料及认可范围；规约、目录规范、实际模板／骨架和契约在现有输入／采用表固定引用，不依赖handoff.json的扩展字段，不另建平行清单；必要来源缺失或冲突时说明受限范围。
+
 ### 0.2 决定、未决与变化
 
 | ID | 事项/方案 | 已定规则/项目决定/待核实 | 来源、备选及理由 | 影响范围 | 实际认可或关闭依据 |
 | --- | --- | --- | --- | --- | --- |
 | `{DEC/Q等稳定ID}` | `{具体事项}` | `{三类分开}` | `{不将建议写成事实}` | `{功能/契约/数据/任务}` | `{未取得则注明}` |
 
-输入变化或公共规则被突破时，先处理权威定义与兼容影响，再继续受影响设计；不能以本主题局部例外悄悄改变共同协议。
+输入变化或公共规则被突破时，先处理权威定义与兼容影响，再继续受影响设计；不能以本PBC局部例外悄悄改变共同协议。
 
 ### 0.3 公共技术规约、契约与骨架的本次采用
 
-AD准备先读取项目明确采用的公共规范、CONSTRAINTS、ADR及工程事实，已有资料适用时直接引用，不复制平行技术规约。没有取得规范时，列出已查范围和缺口，引导选择已有规范或起草最小候选；技术栈、版本、工程骨架与例外由真实来源及使用者决定。若要另写公共技术规约候选，先明确该辅助目标及写入范围；本次只授权AD时，保留Q并起草独立部分，不静默多写文件。
+AD准备默认读取本 Skill自带的企业应用具体规约与目录规范；项目已有明确规约、目录约定时优先沿用，不复制平行规范。再读取 CONSTRAINTS、ADR、正式契约和实际工程事实，在下表记录默认或项目选定来源、准确版本、适用条款及例外，不另要求采用说明文件。没有可读、适用的具体规约时，先提示根据通用技术规约模板生成，明确技术文档目标与写入委托后起草交审；用户确认后继续 AD。通用模板本身不是实际约束，不能填造选型或静默多写文件。
 
-| 采用ID／类型 | 权威位置／文内版本／条款 | 本次角色与适用范围 | 本AD落实位置／例外 | 实际读取与缺口／决定依据 |
+| 采用ID／类型 | 来源身份／准确路径或URL／文内版本或固定提交／条款 | 本次角色与适用范围 | 本AD落实位置／例外 | 实际读取与缺口／决定依据 |
 | --- | --- | --- | --- | --- |
-| `{BASE：公共规范}` | `{项目已采用规范的实际路径与条款}` | `{本主题适用部分，不以规范代产品规则}` | `{具体章节或明确偏差}` | `{已读内容；未取得或冲突保留Q}` |
-| `{CONTRACT／DATA：共享定义}` | `{唯一Schema、契约正文或提供方AD固定章节}` | `{提供／消费／只读；精确行为范围}` | `{§5、§6、§8及精确条目}` | `{选用依据不等于服务就绪}` |
-| `{SKELETON：工程骨架}` | `{真实模板／源码或采用说明及其实际指向}` | `{工程类型、适用目录和责任}` | `{§9.6；与规范兼容或例外}` | `{已取得／拟采用／未应用／未验证分别记录}` |
+| `{BASE：公共规范}` | `{项目明确规约，或默认企业应用规约的标识、实际路径、文内版本与条款；固定提交或摘要按需}` | `{本PBC适用部分，不以规范代产品规则}` | `{具体章节或明确偏差}` | `{已读内容；未取得或冲突保留Q}` |
+| `{CONTRACT／DATA：共享定义}` | `{唯一Schema、契约正文或提供方AD的身份、准确路径、版本与固定章节；标明来源EBC／PBC}` | `{提供／消费／只读；精确行为范围}` | `{§5、§6、§8及精确条目}` | `{选用依据不等于服务就绪}` |
+| `{SKELETON：工程骨架}` | `{本Skill目录规范或项目既有规范的路径、版本及条款；实际模板／源码有则另记来源标识、仓库／路径和固定版本／提交}` | `{工程类型、适用目录和责任}` | `{§9.6；与规范兼容或例外}` | `{已取得／拟采用／未应用／未验证分别记录}` |
 
-本表只组织引用，详细权威仍在来源文件，字段定义不在多表重复维护。单独提供模板时说明配套提示词和兼容范围；实际读取选定资料根的README、阶段索引、阶段清单、模板及本次提示词，不以安装根的索引替代项目已采用副本。已选来源失效或冲突时报告实际差异，不跨宿主、历史样例或最大版本兜底。
+本表只组织引用，详细权威仍在来源文件，字段定义不在多表重复维护。实际读取本模板、选定具体技术规约、目录规范及必要业务原件，由本 Skill直接定位；项目明确采用的副本优先。已选来源失效或冲突时报告实际差异，不按最大版本猜选，也不要求另行准备索引、清单或提示词。
 
-基本交接按路径、正文及文内版本核对，不强制SHA256；同路径人工修改需要回读并判断影响，旧认可不自动转移。正式发布规范或契约已有的不可变版本／摘要要求按其原用途保留。本模板不实现JSON登记、自动选择或项目配置写入。
+基本交接按路径、正文及文内版本核对，不强制SHA256；同路径人工修改需要回读并判断影响，旧认可不自动转移。正式发布规范或契约已有的不可变版本／摘要要求按其原用途保留。交稿路径登记由本Skill处理，本模板不自行选择资料或写入项目配置。
 
 ## 1. 需求覆盖与工程驱动
 
@@ -72,7 +77,7 @@ AD准备先读取项目明确采用的公共规范、CONSTRAINTS、ADR及工程
 | --- | --- | --- | --- | --- | --- |
 | `{固定版本和稳定条目；含复合子项}` | `{新增/修改/复用/停用}` | `{精确落点}` | `{成功/拒绝/失败}` | `{用例或未形成}` | `{具体条件}` |
 
-覆盖 PRD 明确的权限、生命周期、质量和跨主题交接，不只覆盖主流程。需求保留与代码可复用分别核实，数量相等不证明含义一致。
+覆盖 PRD 明确的权限、生命周期、质量和跨PBC交接，不只覆盖主流程。需求保留与代码可复用分别核实，数量相等不证明含义一致。
 
 ## 2. 整体技术架构
 
@@ -84,7 +89,7 @@ flowchart LR
   Component --> Authority["{权威数据/外部能力}"]
 ```
 
-`{替换为本主题有效架构：系统边界、实际/拟建组件、同步/异步方向、数据归属和关键外部依赖；涉及多个工程或共享底座时标实际关系。不因使用模型、容器或工作流就推定微服务。}`
+`{替换为本PBC有效架构：系统边界、实际/拟建组件、同步/异步方向、数据归属和关键外部依赖；涉及多个工程或共享底座时标实际关系。不因使用模型、容器或工作流就推定微服务。}`
 
 | 组件/工程 | 职责与明确不负责项 | 拥有的数据/状态 | 输入输出与依赖 | 实际/拟建及证据 | 对应需求 |
 | --- | --- | --- | --- | --- | --- |
@@ -92,7 +97,7 @@ flowchart LR
 
 ### 2.2 技术与工程基线
 
-| 领域 | 适用选型/精确版本 | 有效规则或固定权威引用 | 本主题落实位置 | 兼容/实际可用性 | 待核实及责任 |
+| 领域 | 适用选型/精确版本 | 有效规则或固定权威引用 | 本PBC落实位置 | 兼容/实际可用性 | 待核实及责任 |
 | --- | --- | --- | --- | --- | --- |
 | `{前端/后端/数据库/身份/消息/CI/CD/部署等实际项}` | `{有依据或待定}` | `{不能只写继承旧资料}` | `{本AD具体条款}` | `{方向确定/文档核对/真实运行分开}` | `{缺口}` |
 
@@ -102,9 +107,9 @@ flowchart LR
 
 | 组合／范围 | 提供方与消费方AD的实际路径／版本 | 规范条款／契约与数据版本 | 代码／制品／环境事实 | 兼容判断与依据 | 未决、允许推进及迁移／退出条件 |
 | --- | --- | --- | --- | --- | --- |
-| `{本主题及必要关联范围}` | `{独立主题、独立版本；未形成如实说明}` | `{引用§0.3与唯一权威，不重写正文}` | `{未产生不填已部署或已测试}` | `{设计相容／未知／冲突；实际证据位置}` | `{并存窗口、发布顺序、恢复限制及责任；未知列Q}` |
+| `{本PBC及必要关联范围}` | `{各PBC独立文档版本；未形成如实说明}` | `{引用§0.3与唯一权威，不重写正文}` | `{未产生不填已部署或已测试}` | `{设计相容／未知／冲突；实际证据位置}` | `{并存窗口、发布顺序、恢复限制及责任；未知列Q}` |
 
-分别核调用类型、序列化与严格消费者，行为／权限／默认值／状态，数据迁移及并存写入，运行时和装配条件。新增字段、枚举或默认值也可能不兼容；文档同号、SemVer主版本相同或Schema校验通过都不能替代实际语义与消费者核对。设计核对、可交Plan、获准Build和真实集成结果分别表达，不要求所有AD机械升级到最新规范。
+分别核调用类型、序列化与严格消费者，行为／权限／默认值／状态，数据迁移及并存写入，运行时和装配条件。新增字段、枚举或默认值也可能不兼容；文档同号、SemVer主版本相同或Schema校验通过都不能替代实际语义与消费者核对。设计核对、T2工程SPEC交审、T3规划、获准Build和真实集成结果分别表达，不要求所有AD机械升级到最新规范。
 
 ## 3. 功能架构与实现链路
 
@@ -112,11 +117,11 @@ flowchart LR
 
 ```mermaid
 flowchart TD
-  Topic["{当前PRD主题/边界}"] --> FunctionA["{有效功能及稳定ID}"]
+  Topic["{当前PBC范围/边界}"] --> FunctionA["{有效功能及稳定ID}"]
   Topic --> FunctionB["{另一有效功能或必要交接}"]
 ```
 
-`{图中每个功能引用真实PRD条目，体现责任、依赖和边界，不为图形对称添加能力。跨主题共用部分标注权威与接口，不复制另一份需求。}`
+`{图中每个功能引用真实PRD条目，体现责任、依赖和边界，不为图形对称添加能力。跨PBC共用部分标注权威与接口，不复制另一份需求。}`
 
 ### 3.2 逐功能工程落点
 
@@ -126,9 +131,9 @@ flowchart TD
 
 共享定义只在后文或附件定义一次，功能表精确引用。图上箭头不能代替契约、字段或错误定义；不能只复制需求文字来表示设计完成。
 
-### 3.3 端到端顺序与跨主题交接
+### 3.3 端到端顺序与跨PBC交接
 
-`{入口→服务/工作流→数据/外部依赖→可观察结果；说明调用先后、同步/异步、事实维护者、超时未知、重复和补偿，必要时补时序图。共享底座只设一个任务归属，其他主题引用依赖。}`
+`{入口→服务/工作流→数据/外部依赖→可观察结果；说明调用先后、同步/异步、事实维护者、超时未知、重复和补偿，必要时补时序图。共享底座只设一个任务归属，其他PBC引用依赖。}`
 
 ## 4. 页面、组件、字段与交互
 
@@ -144,13 +149,13 @@ flowchart TD
 | --- | --- | --- | --- | --- | --- |
 | `{实际动作}` | `{何时可执行}` | `{契约ID}` | `{刷新/路由/焦点/输入变化}` | `{错误码与恢复}` | `{旧响应丢弃、幂等、取消不等于服务端撤销}` |
 
-落实初始、加载、空数据、正常、校验失败、依赖失败、无权限及适用的部分成功/只读/失效状态；定义排序、分页、过滤、提交时机、异步选项和失效选项。长内容、窄屏、局部滚动、键盘/标签/焦点和错误可达性有明确行为，不靠删内容或整页缩放应付。无 UI 的主题说明实际依据，不虚构页面。
+落实初始、加载、空数据、正常、校验失败、依赖失败、无权限及适用的部分成功/只读/失效状态；定义排序、分页、过滤、提交时机、异步选项和失效选项。长内容、窄屏、局部滚动、键盘/标签/焦点和错误可达性有明确行为，不靠删内容或整页缩放应付。无UI的PBC说明实际依据，不虚构页面。
 
 ## 5. API、事件、工具与精确契约
 
 ### 5.1 契约目录与完整定义
 
-| 契约 ID | 协议/方法/路径或主题/版本 | 调用方→提供方 | 作用范围/授权 | 输入输出权威位置 | 副作用/兼容 |
+| 契约 ID | 协议/方法/路径或PBC/版本 | 调用方→提供方 | 作用范围/授权 | 输入输出权威位置 | 副作用/兼容 |
 | --- | --- | --- | --- | --- | --- |
 | `{API/EVT/TOOL等}` | `{真实定义或明确待定}` | `{责任组件}` | `{身份、租户、对象归属}` | `{完整Schema/正文}` | `{真实行为}` |
 
@@ -167,7 +172,7 @@ flowchart TD
 
 ### 5.2 提供／消费关系与单一权威
 
-| 契约／定义ID及版本 | 唯一权威路径／精确章节 | 提供／维护方及AD | 消费方及AD／需求或AC | 本主题映射、授权与失败恢复 | 核对方法与实际就绪／缺口 |
+| 契约／定义ID及版本 | 唯一权威路径／精确章节 | 提供／维护方及AD | 消费方及AD／需求或AC | 本PBC映射、授权与失败恢复 | 核对方法与实际就绪／缺口 |
 | --- | --- | --- | --- | --- | --- |
 | `{引用§5.1实际条目}` | `{字段、行为分担时分别说明边界}` | `{逻辑维护责任与实际工程}` | `{只列实际消费者及准确版本}` | `{输入输出转换；幂等／重放／未知结果；不只列接口名}` | `{契约／语义／集成判据；未执行如实写}` |
 
@@ -192,11 +197,11 @@ erDiagram
 
 #### 6.2.1 共享实体、状态与派生数据的责任
 
-| 实体／状态／共享文件ID | 唯一逻辑权威与定义位置 | 最终校验／受控写入边界 | 本主题提供／消费及相关AD | 副本／快照／派生来源及过期语义 | 并发、事务与恢复／Q |
+| 实体／状态／共享文件ID | 唯一逻辑权威与定义位置 | 最终校验／受控写入边界 | 本PBC提供／消费及相关AD | 副本／快照／派生来源及过期语义 | 并发、事务与恢复／Q |
 | --- | --- | --- | --- | --- | --- |
-| `{引用已有定义，不新造同名字段}` | `{负责业务含义及最终有效状态的模块；不是单一操作人员}` | `{经何授权、在哪一事务中改变}` | `{准确主题、版本和允许动作}` | `{时间点／版本、更新责任、一致性和补偿}` | `{冲突处理及缺口；不能只凭预查询保证并发}` |
+| `{引用已有定义，不新造同名字段}` | `{负责业务含义及最终有效状态的模块；不是单一操作人员}` | `{经何授权、在哪一事务中改变}` | `{准确PBC、文档版本和允许动作}` | `{时间点／版本、更新责任、一致性和补偿}` | `{冲突处理及缺口；不能只凭预查询保证并发}` |
 
-写入者可有多个经授权主体，但业务定义和最终校验责任必须清楚。只读快照、缓存和派生值不成为第二权威，过期展示不能直接批准业务动作；共享迁移、底座和文件只安排一个获准任务归属，其他主题列依赖。两个AD都拟修改同一字段、状态或共享文件时标注冲突与影响，不能静默覆盖，也不为填表擅定责任人、保留期限或业务例外。
+写入者可有多个经授权主体，但业务定义和最终校验责任必须清楚。只读快照、缓存和派生值不成为第二权威，过期展示不能直接批准业务动作；共享迁移、底座和文件只安排一个获准任务归属，其他PBC列依赖。两个AD都拟修改同一字段、状态或共享文件时标注冲突与影响，不能静默覆盖，也不为填表擅定责任人、保留期限或业务例外。
 
 ### 6.3 字段、约束与系统信息
 
@@ -224,11 +229,13 @@ erDiagram
 
 ## 8. 状态、服务规则与恢复
 
+**EARS 使用：**适用的技术行为写清条件、触发事件、执行组件和可观察响应，以及拒绝、失败、结果未知时的处理和副作用。依据 PRD／AC细化并关联本 AD的接口、数据或状态条款；架构图、接口和数据定义仍按相应章节完整说明。
+
 | 规则/状态 ID | 前置条件与触发者 | 确定分支/后置状态 | 权限、责任与事务 | 拒绝/异常/重复/未知 | 恢复与可观察证据 |
 | --- | --- | --- | --- | --- | --- |
 | `{PRD引用与技术细化}` | `{条件}` | `{允许/禁止转换}` | `{契约/数据引用}` | `{错误码及副作用边界}` | `{查询、补偿、审计、人工介入}` |
 
-跨主题共享状态有唯一权威，分别声明各主题可执行的变化和组合版本兼容关系；两份 AD 各自检查通过不能代替集成一致性检查。前端交互状态、服务端业务状态、Agent运行状态、jobs执行状态及只读派生状态分别归属；模型回答、队列完成或工作流结束不直接代表业务成功，结果未知按权威查询与恢复规则处理。
+跨PBC共享状态有唯一权威，分别声明各PBC可执行的变化和组合版本兼容关系；两份 AD 各自检查通过不能代替集成一致性检查。前端交互状态、服务端业务状态、Agent运行状态、jobs执行状态及只读派生状态分别归属；模型回答、队列完成或工作流结束不直接代表业务成功，结果未知按权威查询与恢复规则处理。
 
 ### 智能能力/工作流（适用时）
 
@@ -251,9 +258,9 @@ erDiagram
 
 ### 9.2 项目目录与维护位置
 
-| 真实或拟建路径 | 内容与职责 | 所属工程／维护方 | 与本主题的关系 | 固定来源／当前事实 |
+| 真实或拟建路径 | 内容与职责 | 所属工程／维护方 | 与本PBC的关系 | 固定来源／当前事实 |
 | --- | --- | --- | --- | --- |
-| `{源码根与本主题模块路径}` | `{生产源码、共享模块及边界}` | `{明确责任}` | `{功能／契约条目}` | `{实际仓库位置或有依据的拟建方案}` |
+| `{源码根与本PBC模块路径}` | `{生产源码、共享模块及边界}` | `{明确责任}` | `{功能／契约条目}` | `{实际仓库位置或有依据的拟建方案}` |
 | `{测试与测试配置路径}` | `{单元／契约／集成／E2E等目录及入口}` | `{明确责任}` | `{与TestCase §3.1一致}` | `{固定配置；未存在如实注明}` |
 | `{文档／契约及适用生成物路径}` | `{规格、ADR、约束、接口定义或构建产物}` | `{权威维护位置与生成归属}` | `{可编辑原文／只读投影／生成内容分别说明}` | `{现有约定优先，不另建平行权威}` |
 
@@ -265,7 +272,7 @@ erDiagram
 
 | 适用语言／工程／范围 | 命名与格式规则 | 真实示例或固定规范及准确位置 | 检查配置／命令引用 | 例外及实际认可来源 |
 | --- | --- | --- | --- | --- |
-| `{本主题实际技术范围}` | `{实际规则及现有模式}` | `{可回读路径／版本／条目}` | `{AD §9.1及真实配置}` | `{无则写无；建议不算已批准例外}` |
+| `{本PBC实际技术范围}` | `{实际规则及现有模式}` | `{可回读路径／版本／条目}` | `{AD §9.1及真实配置}` | `{无则写无；建议不算已批准例外}` |
 
 ### 9.4 Always／Ask first／Never 工程边界
 
@@ -291,21 +298,21 @@ erDiagram
 
 | 工程/仓库/模块范围 | 实际骨架或拟采用模板及固定来源 | 初始化/增量内容 | 构建/启动/配置/依赖 | 测试与恢复前提 | 当前事实 |
 | --- | --- | --- | --- | --- | --- |
-| `{一能力不强制一工程}` | `{实际取得或待提供}` | `{只写有依据的工程任务}` | `{精确规则或缺口}` | `{必要条件}` | `{已存在/拟建/待核实}` |
+| `{一能力不强制一工程}` | `{引用第0.3节采用ID；实际取得的模板／源码标识、仓库／路径、版本或固定提交及本地差异；未取得明确待提供}` | `{只写有依据的工程任务}` | `{精确规则或缺口}` | `{必要条件}` | `{已存在/拟建/待核实}` |
 
 固定引用 §9.1–9.4 的命令、目录、代码风格和工程边界，不手工维护第二套不同答案。补充依赖与锁文件、构建制品、环境和密钥引用、部署顺序、特性开关、迁移兼容、回滚和运行交接；测试框架、测试目录、层级及适用覆盖要求由 TestCase §3.1 承接。不给真实凭据，不把配置计划当实际就绪，不代替生产授权；CONSTRAINTS、ADR 等辅助产物仍按原方法和项目约定维护。
 
-骨架引用必须最终落到真实模板／源码、明确版本或来源记录及所选目录；只有目录图或本模板占位行时记录“工程资产未取得”，不能写成可应用工程。优先保留现有仓库及人工代码，采用说明可引用源码及差异，不要求复制另一份平行骨架。适用的pbc-composite／agent-standalone与frontend／backend／agents／jobs按实际选择说明，contracts／shared／tests／delivery的责任不能遗漏；不需要的工程说明依据，不默认一PBC一仓库或一服务。
+目录规范是 AD 的结构输入，真实模板／源码不是 AD起草的统一前置。将规范映射到项目的工程与模块位置，已有、拟建、未取得和未验证分别记录；如另用实际代码模板，再注明真实来源、版本和本地差异，目录图不代表工程已经应用。优先保留现有仓库与人工代码，采用信息直接记本 AD，不另建说明或复制平行骨架。适用的pbc-composite／agent-standalone与frontend／backend／agents／jobs按实际选择说明，contracts／shared／tests／delivery的责任不能遗漏；不需要的工程说明依据，不默认一PBC一仓库或一服务。
 
-AD只选择并定义落实与例外；原Plan据此安排初始化或增量任务、文件责任、验证和恢复；获准Build才实际应用模板或改动工程。现有工程根可记录真实路径，新工程未创建时只写拟建位置和缺口。contracts.lock在正式采用外部契约时形成；templates.lock及生成基线在实际应用并完成相应验证后形成；本次AD写作不创建锁、工程、运行报告或第二套任务tracker。更新须保护人工修改，实际应用失败不能覆盖旧有效基线，细节交I4／I5工程验证。
+AD定义采用、工程落位与例外，T2承接到工程SPEC，T3由原Plan安排初始化或增量任务、文件责任、验证和恢复；获准Build才实际应用模板或改动工程。现有工程根记录真实路径，新工程未创建时只写拟建位置和缺口。锁文件按已采用工具和项目规则处理，不因目录规范另建templates.lock、contracts.lock或生成记录库；已有文件保留其实际用途。本次AD写作不创建锁、工程、运行报告或第二套任务tracker。更新须保护人工修改，实际应用失败不能覆盖旧有效基线，应用和验证结果由对应工程任务记录。
 
-## 10. TestCase 与实施计划交接
+## 10. TestCase、T2工程SPEC与T3实施计划交接
 
 | PRD需求/AC或工程条款 | AD精确落点 | 可观察成功/失败/副作用 | TestCase用例或待形成 | 实施前提与依赖 |
 | --- | --- | --- | --- | --- |
 | `{固定条目}` | `{图/字段/契约/事务/规则}` | `{可断言结果}` | `{固定引用或缺口}` | `{环境/契约/数据/工具/认可}` |
 
-先判断设计能否据以制定 Plan，再由 Plan 获得范围/执行模式认可并核实任务条件；不能把获批 Plan 写成形成 Plan 的前置要求。共享底座或独立技术准备可形成有依据的任务，不借初始化提前生成未定业务字段/权限/接口。
+本AD作为T2工程SPEC的设计依据；T2结合选定PRD及采用资料落实六项并交审，T3再依据选定工程SPEC调用原Plan。Plan形成后取得范围/执行模式认可，执行前核实任务条件；不能把获批Plan写成形成Plan的前置要求。共享底座或独立技术准备可形成有依据的任务，不借初始化提前生成未定业务字段/权限/接口。
 
 ### 10.1 公共变更、例外与影响范围
 
@@ -313,19 +320,19 @@ AD只选择并定义落实与例外；原Plan据此安排初始化或增量任
 | --- | --- | --- | --- | --- | --- |
 | `{规范／契约／骨架／本AD；同路径修改也列实际变化}` | `{原规则、候选或真实决定分别说明}` | `{唯一权威及准确内容}` | `{固定版本和精确落点}` | `{真实引用；未形成写待形成，不补造任务／报告}` | `{受影响／不受影响、保留旧组合、例外、Q和重新核对}` |
 
-先确定变化及来源，再定位直接和必要传递消费者，核行为、权限、数据、迁移和运行组合，提出最小处理及恢复。公共定义改变需在其权威位置处理；本主题AD只记录建议和影响，不自行修改公共规范、契约或另一主题。保留原有有效需求及已交付行为的回归，范围降级或移出须有来源和真实决定；不机械重写无关AD、强制升版或重新询问未受影响的已有授权。
+先确定变化及来源，再定位直接和必要传递消费者，核行为、权限、数据、迁移和运行组合，提出最小处理及恢复。公共定义改变需在其权威位置处理；本PBCAD只记录建议和影响，不自行修改公共规范、契约或另一PBC。保留原有有效需求及已交付行为的回归，范围降级或移出须有来源和真实决定；不机械重写无关AD、强制升版或重新询问未受影响的已有授权。
 
-独立审查只读标注，使用者可人工处理、明确委托修订、有据不采纳或保留Q；按改动影响复查，零问题不等于业务批准。若JSON清单尚未接入，直接手动传递准确路径仍有效。交原Plan时任务须保留实际PRD、AD、规范、契约、骨架来源及验证依据；Build按获准任务回读，输入变化先核与计划的影响，不靠可变清单链接或旧会话摘要代替正文。
+独立审查只读标注，使用者可人工处理、明确委托修订、有据不采纳或保留Q；按改动影响复查，零问题不等于业务批准。若JSON清单尚未接入，手动传递准确路径仍可作为T2输入。T2工程SPEC保留实际PRD、AD、规范、契约、骨架来源及关键设计；T3原Plan将其落实到任务、结构与行为验收及验证步骤。Build按获准任务回读所需正文，输入变化先核与计划的影响，不靠可变清单链接或旧会话摘要代替正文。
 
 ## 11. 完成核对、问题与版本记录
 
 - 三图已按真实范围填写，图、字段、接口、状态和责任一致，无占位图冒充完成。
 - 每个有效需求/AC/子项及质量条目有工程落点，正常、拒绝、异常和恢复均可判定。
 - 字段/API/事务/迁移与双向映射可实施，权威定义单源；未知关键业务参数不留给编码猜。
-- PRD 与实际采用的原型、公共基线及附件固定引用可回读，跨主题兼容关系明确；原型未形成或不适用时说明影响，不阻止独立范围的 AD 起草。
+- PRD 与实际采用的原型、公共基线及附件固定引用可回读，跨PBC兼容关系明确；原型未形成或不适用时说明影响，不阻止独立范围的 AD 起草。
 - 适用 build／test／lint／dev 的完整命令、参数、cwd 和前提明确，源码／测试／文档目录、真实风格示例或固定规范、Always／Ask／Never 边界均有依据；缺项或不适用如实说明。
 - §0.3采用表、§2.3兼容组合、§5.2提供／消费、§6.2.1数据责任、§9.6骨架来源及§10.1变更影响相互一致；同号或Schema通过不代替语义兼容。
-- 公共规范优先复用，缺失及例外有依据；人工编辑可回读且不被恢复，未受影响主题和共享文件责任明确。
+- 公共规范优先复用，缺失及例外有依据；人工编辑可回读且不被恢复，未受影响PBC和共享文件责任明确。
 - 实施位置和验证前提明确，设计、代码、实际测试和上线分别报告；未生成工程、锁或报告不登记成已存在。
 
 | 问题 ID | 缺失/冲突及来源 | 受影响要求/契约/任务 | 可继续部分 | 责任、最晚时点与真实关闭依据 |

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

@@ -8,11 +8,18 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-模板版本：v0.0.3。日期：2026-10-17。状态：自有资源候选；模板可供明确采用，业务内容与认可另行记录。
+模板版本：v0.1.7。模板版本与业务文档版本分别维护。
 
-采用[模板与交接合同](../../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,17 +27,19 @@ 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/主题和处理 |
+| 文档版本/日期 | 实际主体 | 修改内容及来源 | 与前版关系 | 受影响 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 编号／名称 | 本PBC的PRD承接／待细化 | 其他责任方/去向 | 依据及缺口 |
 | --- | --- | --- | --- | --- | --- |
-| `{稳定引用}` | `{明确分类}` | `{capabilityId；候选边界标候选}` | `{已有prdId/主题或待定，不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
+| `{稳定引用}` | `{明确分类}` | `{pbcId；pbcName；候选边界标候选}` | `{已有PRD的documentId及承接范围或未形成，不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
 
 每条业务诉求和范围外限制都有去向；一个 BR 可以分配给多个 PBC，但共用业务事实应明确权威维护方，不产生相互冲突的副本。“本次不做”不自动变成“以后必须做”。
 
@@ -116,7 +127,7 @@ BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优
 
 | ID | 类别 | 内容及来源 | 核实状态/当前建议 | 对交接的具体影响 | 责任、时点与关闭依据 |
 | --- | --- | --- | --- | --- | --- |
-| `{DEP/A/Q等稳定ID}` | `{依赖/假设/问题/冲突}` | `{保留冲突双方或假设来源}` | `{未知不代答}` | `{可继续与受阻的PBC/主题/动作}` | `{实际主体或未指定；真实答复引用}` |
+| `{DEP/A/Q等稳定ID}` | `{依赖/假设/问题/冲突}` | `{保留冲突双方或假设来源}` | `{未知不代答}` | `{可继续与受阻的PBC/动作}` | `{实际主体或未指定；真实答复引用}` |
 
 ## 10. 风险与应对
 
@@ -156,9 +167,9 @@ BR 拆分、撤回或替代保留关联，不用旧 ID 指代另一诉求。优
 
 ### 13.3 PRD 交接摘要
 
-`{本次交接的BRD身份/版本/固定内容、承接PBC及主题、BR清单、排除和后续项、Q及影响、适用外部基线。PRD形成后由PRD维护具体功能和AC，不在此预填尚未产生的条目或通过结论。}`
+`{本次交接的ebcId／ebcName、BRD documentId／文内版本／实际路径与固定内容、承接pbcId／pbcName及已有PRD文档身份、BR清单、排除和后续项、Q及影响、适用外部基线的准确引用。已有PRD记录其真实文档身份、路径、版本与承接范围；未形成时写未形成，不预填文件或编号。PRD形成后由PRD维护具体功能和AC，不在此预填尚未产生的条目或通过结论。}`
 
-本摘要是业务交接输入，不改变原技能的审批或输出合同。Plan、质量约束、ADR 和实际验证记录等仍按各自适用方法保留，模板状态或填写参与者不产生授权。
+本摘要供后续企业文档及 T2工程 SPEC读取必要业务背景；T3依据选定工程 SPEC调用原规划。原技能的审批与输出合同、质量约束、ADR和实际验证要求继续保留，模板状态或填写参与者不产生授权。
 
 ## 完成核对