@givolt/i3-composer-agent 3.0.0 → 3.1.0

package/{references/enterprise-sop-resources → skills/i3-enterprise-sop/references}/prd/template-contracts.md

@@ -8,7 +8,7 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-本页是本切片新编写的说明桥接页，不是设计来源 `template-contracts.md` 的原样副本，也不是完整四模板合同。它为固定 PRD 原文的相对引用保留可读入口；本切片使用规则的唯一说明权威为 [README](README.md)。原设计的路径、版本及真实摘要由随包 `assets-manifest.json` 的 `designSources[]` 登记，标记 `included:false`，仅供维护溯源，不随包提供或保证安装后路径可读。`files` 中本桥接页的摘要只对应本页，不能当作原设计摘要，也不能由同名文件推定字节相同。
+本页是本切片新编写的说明桥接页，不是设计来源 `template-contracts.md` 的原样副本，也不是完整四模板合同。它为固定 PRD 原文的相对引用保留可读入口；本切片使用规则的唯一说明权威为 [README](readme.md)。原设计的路径、版本及真实摘要由随包 `assets-manifest.json` 的 `designSources[]` 登记，标记 `included:false`，仅供维护溯源，不随包提供或保证安装后路径可读。`files` 中本桥接页的摘要只对应本页，不能当作原设计摘要，也不能由同名文件推定字节相同。
 
 ## 1. 身份、范围与采用
 
@@ -16,7 +16,7 @@
 
 ## 4. 内容责任
 
-PRD 维护完整产品定义和行为／AC；AD 维护工程实现，TestCase 维护验证判据，实际结果另存运行报告。具体分工见 README 第4节，AD 的当前交付边界见 [AD 承接说明](templates/AD.md)。
+PRD 维护完整产品定义和行为／AC；AD 维护工程实现，TestCase 维护验证判据，实际结果另存运行报告。具体分工见 README 第4节，AD 的当前交付边界见 [AD 承接说明](templates/ad.md)。
 
 ### 4.1 原 SPEC 六项内容的完整映射
 
@@ -28,7 +28,7 @@ PRD 维护完整产品定义和行为／AC；AD 维护工程实现，TestCase
 
 ### 5.1 共用 G01—G08 内容核对
 
-完整八项要求统一维护在 README §5.1。每项填写实际位置、证据与齐备／部分／缺失／不适用理由；PRD 的 S14 不能仅勾“已完成”。S01—S14 索引在 README 第5节，完整专用清单在 [PRD 模板](templates/PRD.md) §10.2。
+完整八项要求统一维护在 README §5.1。每项填写实际位置、证据与齐备／部分／缺失／不适用理由；PRD 的 S14 不能仅勾“已完成”。S01—S14 索引在 README 第5节，完整专用清单在 [PRD 模板](templates/prd.md) §10.2。
 
 ## 6. 交接与原方法停点
 

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

@@ -8,7 +8,7 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-本页是 PRD 资源切片新编写的链接承接说明，**不是完整 AD 模板，也不是已生成的 AD 业务实例**。固定 PRD 原文对 AD 的相对引用在此说明未来工程责任；本切片没有交付完整 AD、TestCase 或工程骨架。共同规则以 [README](../README.md) 为准，合同定位见 [模板合同承接页](../template-contracts.md) §4.1。
+本页是 PRD 资源切片新编写的链接承接说明，**不是完整 AD 模板，也不是已生成的 AD 业务实例**。固定 PRD 原文对 AD 的相对引用在此说明未来工程责任；本切片没有交付完整 AD、TestCase 或工程骨架。共同规则以 [README](../readme.md) 为准，合同定位见 [模板合同承接页](../template-contracts.md) §4.1。
 
 AD 在项目以后明确授权的文档任务中，基于选定 PRD、适用原型、真实工程与固定规范，维护整体技术架构、功能架构及 ER 图，并把产品行为／AC落实到组件、UI字段、API、数据关系、服务端及对象级权限、状态、事务、并发、迁移、异常与恢复。共享定义固定一个权威来源及版本，不私改 PRD 业务规则，也不把原型模拟当真实授权实现。
 

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

@@ -10,7 +10,7 @@
 
 模板版本：v0.0.4。日期：2026-10-17。状态：待评审，未作为运行技能安装。
 
-采用[模板与交接合同](../template-contracts.md)。一个 PBC 可以有多个需求主题，每个主题有独立 `prdId` 和版本序列。实例文件名为 `{PBC}-{需求主题}-PRD_v0.0.1.md`。本模板同时维护完整产品定义、具体行为和验收条件，不要求另建行为故事文档。字段/API/数据库等工程实现进入 [AD](AD.md)。
+采用[模板与交接合同](../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节。本模板升级不自动修改业务实例、采用关系或业务版本。
 

package/{references/enterprise-sop-resources/README.md → skills/i3-enterprise-sop/references/readme.md}

@@ -8,13 +8,15 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-资源组合版本：0.16.2；指引版本：v0.16.2。本组合增加显式plan与四阶段短命令澄清，源码／分发／真实宿主验证分别记录，暂不发布。业务JSON顶层仅schemaVersion、scope、selected，候选登记及撤回流程已退出；原版25技能／9命令及既有原型能力保持，本地SOP增量与3.0目标仍27／11／4。S08按精简范围关闭，三字段登记完整验证留S10；旧S06—S08证据只对应当时对象。企业跨阶段auto仍3.1.0。
+资源组合版本：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.2分别定位，规约附带其明确引用的目录规范／采用说明0.2.0。可选规约按辅助清单baselines条目定位，只有项目明确采用才生效；已有项目规范及自改副本优先。旧S10候选与报告不改，本组合打包／安装证据另取，不转算真实模型通过。
+[公共技术规约采用说明](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-门禁对象时点和允许范围)。外层检查不自动改业务稿，不生成批准或启用企业流程。
+原生方法的调用／报告复核与S06路径辅助校验分开，按[外层校验说明](verification/readme.md#原生方法与执行报告)显式使用；门禁对象和时点见[交接合同§11](handoff-contract.md#11-门禁对象时点和允许范围)。外层检查不自动改业务稿，不生成批准或启用企业流程。
 
 需要程序约束现稿交接时显式采用[单次受控入口](controlled-handoff.md)：先限制 CodeBuddy 只读，再核真实回执，最后仅登记用户明确采用的准确路径并回读。该入口与事后证据校验分开，不是随安装启用的通用拦截器，不代替原生方法、人审或企业auto。
 
@@ -36,7 +38,7 @@ CodeBuddy 可明确说：“为当前项目启用 i3 企业 SOP 资料指引，
 | 真实业务、公共规范、契约、骨架 | 先读项目根 README、适用项目规则、其引用的采用记录和 docs/README；以实际选择、适用范围及真实正文为准，不把资源模板当项目规范或可运行工程 |
 | 本次交接对象 | 已明确的唯一 JSON 清单或手动指定路径；只取本次主题的已选材料，候选、历史、样例和验证记录不作默认输入 |
 
-CodeBuddy 项目安装入口为 .codebuddy/.i3-composer-agent.json：确认 name 为 i3-composer-agent，按 resources.references 定位 enterprise-sop-resources/README.md，资源路径相对安装清单所在目录。安装识别只读name／version／scope／resources等必要元数据，可先定位键再读相应范围，不全文加载assets文件列表；项目确实未安装时才查同宿主可读全局清单；清单存在却损坏、名称不符、引用失效或被拒绝读取，不当成“未安装”静默兜底。已选项目副本时，安装清单只作安装事实，不能接管采用。
+CodeBuddy项目安装由 `.codebuddy/.i3-composer-agent.json` 核name／version／scope、catalog.skills及本次SOP Skill的SKILL.md及资料子目录的readme.md两项精确assets，资料从实际Skill目录进入。可先定位键再读必要范围，不全文加载assets列表；`resources.references`继续服务原版共用资料，不能据此寻找SOP。项目确实未安装时才查同宿主全局安装；清单损坏、身份不符或资料缺失先报告，不静默兜底。已选项目副本时，安装事实不能接管采用。
 
 查找顺序也约束实际读取：先读项目根约定及其采用记录，确定对应角色尚无明确来源时，才访问下一优先级。已选定项目资料根时，不再读取低优先级的安装／全局资源README、索引或正文，除非本轮明确要求比较来源；不并行探读多套入口再事后宣称只采用其中一套。安装清单若先前已读，只保留安装事实，不顺势进入其资源。
 
@@ -61,7 +63,7 @@ review／recheck 的读取职责以[统一审查约定](review-handoff.md)为准
 | 业务与必要依赖 | 只取本次所选正文及必要直接／传递约束；骨架采用说明指向真实来源README／源码时，实际读该来源，说明完备或缺口 |
 | 已选缺项 | 读取到具体缺项后准确报告文件／目录区别及影响；不再加载其他动作或低优先级源兜底，独立工作只建议不执行 |
 
-结束前对照这份本次清单，报告已成功读取、仍缺／失败、未要求的资料和具体依赖影响。不要用搜索结果、索引列名、行数或作者摘要替代正文；长文按实际工具截断分段覆盖。维护来源、旧证据和模板中的示例链接不自动成为业务必读。本组合提供[外层只读校验](verification/README.md)，由获准调用者对照本次适用清单和CodeBuddy原生轨迹执行；单独加载资料不会自动启用校验，也不拦截工具调用。文件存在、读取覆盖和语义正确分别判断。
+结束前对照这份本次清单，报告已成功读取、仍缺／失败、未要求的资料和具体依赖影响。不要用搜索结果、索引列名、行数或作者摘要替代正文；长文按实际工具截断分段覆盖。维护来源、旧证据和模板中的示例链接不自动成为业务必读。本组合提供[外层只读校验](verification/readme.md)，由获准调用者对照本次适用清单和CodeBuddy原生轨迹执行；单独加载资料不会自动启用校验，也不拦截工具调用。文件存在、读取覆盖和语义正确分别判断。
 
 | 路径类别 | 相对基准与边界 |
 | --- | --- |
@@ -81,9 +83,9 @@ review／recheck 的读取职责以[统一审查约定](review-handoff.md)为准
 | testcase | 直接产品依据 PRD、配套 AD、测试规范、完整 TestCase；必须原Spec；仅设计，不借原 /i3-test 生成文档或冒充执行 |
 | technical-baseline（辅助） | AD 准备时按需定位；优先复用项目已有规范。只有缺少适用规范且本次明确选择才起草最小候选；不是第五阶段 |
 
-公共技术规约的[采用说明](technical-baseline/README.md)和模板用于核对来源与缺口。现有规范已充分时直接引用，不复制总规约、不修改原规范。技术栈与工程骨架是项目实际选择；模板不预设答案，选型、候选、采用、应用、验证分别表达。
+公共技术规约的[采用说明](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.1.2／模板 v0.0.1。四阶段模板正文原字节保留，B05仅增补说明和动作提示词，PRD 子包“未提供其他模板”仅描述该子目录；其中 AD 责任说明不是完整 AD。采用旧切片缺资料时报告差异，不默认混版。
+四阶段固定组合：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. 保护项目采用与人工修改
 
@@ -130,15 +132,15 @@ B05-r2收尾澄清：最后一次Write／Edit后分段完整读取最终稿；
 
 ## 审查输出契约与定向复核
 
-资源组合0.5.2补齐[审查会话契约](verification/review-output.schema.json)、外层错误分类与调用者来源角色绑定，详见[说明](verification/README.md)。原生失败不改写；定向格式／来源复核不自动改业务稿，达到当次约定轮次仍失败交人工裁定。该工具仍由外层明确执行，不自动加载／拦截原方法。
+资源组合0.5.2补齐[审查会话契约](verification/review-output.schema.json)、外层错误分类与调用者来源角色绑定，详见[说明](verification/readme.md)。原生失败不改写；定向格式／来源复核不自动改业务稿，达到当次约定轮次仍失败交人工裁定。该工具仍由外层明确执行，不自动加载／拦截原方法。
 
 ## 来源角色同源生成增量
 
-当前组合0.5.3采用[共用生成与校验工具](verification/README.md)：同一scope角色表为模型生成role枚举，并在实际CLI参数核对；授权校订报告独立检查内容，不追认为原生通过。仅自有辅助变化，四阶段及辅助模板正文、原版技能和命令保持。新独立验证一次，失败交人工裁定，不发布。
+当前组合0.5.3采用[共用生成与校验工具](verification/readme.md)：同一scope角色表为模型生成role枚举，并在实际CLI参数核对；授权校订报告独立检查内容，不追认为原生通过。仅自有辅助变化，四阶段及辅助模板正文、原版技能和命令保持。新独立验证一次，失败交人工裁定，不发布。
 
 ## S06最小交接切片
 
-本次资料根采用 `references/enterprise-sop-resources`，避免新增同名Skill时品牌引用重写误改资料路径。源码工作区保留旧目录兼容链接；该链接不作为分发依赖。项目已采用副本仍按真实采用记录读取，不改其位置或正文。
+资料根固定为本次实际加载的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只存路径，不保存批准、完成率或运行结果。脚本读取不代替模型全文回读与语义核对。
 
@@ -146,7 +148,7 @@ B05-r2收尾澄清：最后一次Write／Edit后分段完整读取最终稿；
 
 ## 7. spec/ 业务目录与原生命令
 
-新项目的BRD、同PBC多主题PRD、各自AD与TestCase默认写入spec/{能力}/，命名沿共用合同；现有项目约定优先，不搬旧稿／历史。这里的spec/是业务输出，references/enterprise-sop-resources是安装资料，两者不混用。起草／修订必先成功调用原Spec Skill，使用其外部格式与存储能力；原/i3-spec包装及using不变。
+新项目的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不天然触发或被原命令读写，手动准确路径继续支持。只有当前主题和必要共享约束进入上下文，摘要不能替代真实正文。
 
@@ -158,7 +160,7 @@ B05-r2收尾澄清：最后一次Write／Edit后分段完整读取最终稿；
 
 四阶段写作仍须成功调用原Spec并守内容与停轮；plan按[规划交接](plan-handoff.md)只读解析本主题清单或手动材料，完整读准确PRD／AD、已采用规范／必要契约、工程采用与相关代码，实际加载原规划Skill并履行原Plan命令义务。保存原tasks/plan.md与唯一任务目标，回读交审后停轮，不写业务稿／JSON、不自动Build。无清单可手动，标准原/i3-plan不强制读handoff；27技能／11命令不变。
 
-本次不改审查辅助、审查提示词／Schema、四阶段模板或实际技术规约。共享说明更新后若不匹配审查辅助的固定资料指纹，沿用其现有完整读取所选原件的回退，不放宽判据或冒用旧S10证据。
+四阶段模板正文、审查提示词／Schema及原方法保持。已逐条覆盖的当前发行共用规则可使用审查辅助的固定资料指纹；未知／自改组合继续完整读取选定原件，不放宽判据或冒用旧证据。
 
 ## 11. SOP Plan读取与身份停点
 

package/{references/enterprise-sop-resources → skills/i3-enterprise-sop/references}/recovery-contract.md

@@ -8,13 +8,13 @@
 默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
 <!-- i3:zh-guide:end -->
 
-规则版本：v0.4.0；本次只做源码修改，未测试、未发布；适用于显式企业 SOP 的状态核对、中断恢复、路径补录、重复执行和人工修改保护。命令与直接 Skill 共用本规则，不增加顶级命令或修改原方法。先读[Skill](../../skills/i3-enterprise-sop/SKILL.md)及[交接合同](handoff-contract.md)，handoff.py 仍保留init／select／resolve 三操作，业务 JSON 仍 schemaVersion 1；同主题改选采用单独的受控预览合同。
+规则版本：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、resources.references，不全文加载资产列表。此读集不因 status 或只读恢复而缩减；阶段模板及生成提示词仅在实际生成、修订或相应内容核对时加载。
+确定项目根、工作范围、主题、唯一目标和本次允许写入对象。实际读项目规则、采用来源、资源根 README／stages.json／三份共用合同；使用安装清单定位时核 name、version、scope、catalog.skills及本次SOP Skill精确assets，资料取实际Skill的references/，不全文加载资产列表。此读集不因 status 或只读恢复而缩减；阶段模板及生成提示词仅在实际生成、修订或相应内容核对时加载。
 
 先区分输出目标和上游输入：已有 PRD 用来生成尚不存在的 AD，仍是新建 AD，不因输入已存在而改成现稿恢复。只有本次输出目标已有稿件，或有该目标写入／登记中断等实际依据，才进入相应恢复判断；恢复任务本身不产生新的写作委托。
 

package/{references/enterprise-sop-resources → skills/i3-enterprise-sop/references}/stages.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "resourceId": "i3-enterprise-sop",
-  "resourceVersion": "0.16.2",
-  "status": "local-short-command-plan-candidate",
+  "resourceVersion": "0.17.1",
+  "status": "local-skill-owned-resource-candidate",
   "activation": "explicit-enterprise-task-or-applicable-recorded-selection",
   "ordinaryInstallEnablesEnterpriseWorkflow": false,
   "sharedContract": "template-contracts.md",
@@ -78,21 +78,29 @@
     "technical-baseline": {
       "resourceRoot": "technical-baseline",
       "manifest": "technical-baseline/assets-manifest.json",
-      "resourceVersion": "0.2.0",
+      "resourceVersion": "0.4.0",
       "templateVersion": "v0.0.1",
       "businessStage": false,
       "role": "shared-engineering-guidance",
       "baselineCatalog": "technical-baseline/assets-manifest.json",
       "explicitAdoptionRequired": true
+    },
+    "engineering-skeleton": {
+      "resourceRoot": "engineering-skeleton",
+      "manifest": "engineering-skeleton/catalog.json",
+      "resourceVersion": "1.0.0",
+      "businessStage": false,
+      "role": "engineering-directory-standard",
+      "explicitAdoptionRequired": true
     }
   },
   "manualHandoffSupported": true,
   "jsonRegistrationImplemented": true,
   "lifecycleContract": "lifecycle-contract.md",
   "existingPrdTemplatePreserved": true,
-  "candidateRevision": "20261021-plan-gates-r4",
+  "candidateRevision": "20261022-sop-skill-resources-r2",
   "readEvidenceChecker": {
-    "entry": "verification/README.md",
+    "entry": "verification/readme.md",
     "script": "verification/check_reads.py",
     "traceFormat": "codebuddy-stream-json",
     "automaticActivation": false,
@@ -242,7 +250,7 @@
     "manualSupported": true,
     "buildAutomaticallyInvoked": false,
     "requiredResourceReads": [
-      "README.md",
+      "readme.md",
       "stages.json",
       "template-contracts.md",
       "handoff-contract.md",
@@ -258,5 +266,6 @@
     "plan",
     "review",
     "status"
-  ]
+  ],
+  "resourceLocation": "actual-loaded-sop-skill/references"
 }

package/skills/i3-enterprise-sop/references/technical-baseline/assets-manifest.json

@@ -0,0 +1,84 @@
+{
+  "schemaVersion": 1,
+  "resourceId": "i3-enterprise-sop-technical-baseline",
+  "resourceVersion": "0.4.0",
+  "resourceRole": "auxiliary-shared-engineering-guidance",
+  "status": "local-skill-owned-resource-candidate",
+  "businessStage": false,
+  "templateContentVersion": "v0.0.1",
+  "entry": "readme.md",
+  "template": "templates/technical-baseline.md",
+  "files": [
+    {
+      "path": "readme.md",
+      "sourceSha256": "3ef610a17961889111d6e1e4e7ff329a5f820d6b1d1cf4c1988380a28019eb68",
+      "sha256": "85f1b0c6475eeaf9790916965305564da363571a106e623c4bc7a3a747e6b998",
+      "role": "adoption-guidance"
+    },
+    {
+      "path": "templates/technical-baseline.md",
+      "sourceSha256": "accf9d79fe5aca11b5c2bc54b44576c3e397279ff9fcc46de522598791bf1408",
+      "sha256": "e5f357c5372889f040b959b868e306599aca43185b1b8f1173c9b885e61d384f",
+      "role": "auxiliary-engineering-template"
+    },
+    {
+      "path": "baselines/enterprise-application-technical-baseline-v0-0-4.md",
+      "role": "optional-project-technical-baseline",
+      "sourceSha256": "ba2c3af5cb8a70308a6325d42233e3015451f35096b75905013d4ff34a7671e3",
+      "sha256": "cf7c4f1414bb234190672e33353396107e356deb023aababede8cd0fbae858e4"
+    }
+  ],
+  "sha256Scope": "source-and-pure-brand-reference-mapping-not-npm-install-proof",
+  "dependencies": [
+    {
+      "path": "../ad/templates/ad.md",
+      "role": "ad-linkage-reference"
+    },
+    {
+      "path": "../handoff-contract.md",
+      "role": "native-plan-handoff-reference"
+    },
+    {
+      "path": "../engineering-skeleton/directory-standard.md",
+      "role": "engineering-directory-standard",
+      "contentVersion": "1.0.0"
+    },
+    {
+      "path": "../engineering-skeleton/adoption.md",
+      "role": "engineering-adoption-guidance",
+      "contentVersion": "1.0.0"
+    }
+  ],
+  "integration": {
+    "registeredInParentStageIndex": true,
+    "registeredInCustomRuntimeFiles": true,
+    "includedInParentResourceBundle": true,
+    "packagePolicy": "included-reference-assets-with-per-artifact-verification",
+    "automaticWorkflowActivation": false,
+    "newSkillOrCommand": false,
+    "proofBoundary": "File presence, pack, installation, model reads and project adoption are distinct."
+  },
+  "publication": {
+    "published": false,
+    "businessCandidateApproved": false
+  },
+  "baselines": [
+    {
+      "id": "enterprise-application",
+      "title": "企业应用公共技术规约",
+      "documentVersion": "v0.0.4",
+      "path": "baselines/enterprise-application-technical-baseline-v0-0-4.md",
+      "explicitAdoptionRequired": true,
+      "requiredSources": [
+        {
+          "path": "../engineering-skeleton/directory-standard.md",
+          "contentVersion": "1.0.0"
+        },
+        {
+          "path": "../engineering-skeleton/adoption.md",
+          "contentVersion": "1.0.0"
+        }
+      ]
+    }
+  ]
+}

package/{references/enterprise-sop-resources/technical-baseline/baselines//344/274/201/344/270/232/345/272/224/347/224/250-/346/212/200/346/234/257/350/247/204/347/272/246_v0.0.2.md → skills/i3-enterprise-sop/references/technical-baseline/baselines/enterprise-application-technical-baseline-v0-0-4.md}

@@ -12,15 +12,15 @@
 
 | 项目 | 当前内容 |
 | --- | --- |
-| 文档版本 | v0.0.2，2026-10-20；保留 [v0.0.1 的历史记录](PROVENANCE.md#维护历史) |
+| 文档版本 | v0.0.4，2026-10-22；当前分发规约，工程目录规范与采用说明统一为1.0.0 |
 | 文档性质 | 根据使用者逐项确认整理的企业共用技术基线；供具体项目明确选用，新稿文字仍可人工审阅修改 |
 | 适用范围 | 明确采用本文件的企业业务项目及其前端、业务后端、Agent、任务工程；各工程按实际需求采用 |
 | 项目绑定 | 本文件不绑定某一业务项目；项目名称、采用版本、PRD／AD与实际工程在项目采用说明或AD中记录，见 Q01、Q12 |
-| 直接来源 | [软件架构设计 Specification 模板 v0.6 的来源说明](PROVENANCE.md#来源资料)，含原文明确的技术方向及工程约束 |
-| 编排依据 | 当前企业 SOP 的公共技术规约模板、AD 模板及交接合同；工程组织引用现有目录规范0.2.0 |
-| 确认依据 | 2026-10-20，使用者确认Q01—Q05、Q07、Q10、Q12的建议方向，随后确认Q06采用MaxKey／OIDC、Q09职责分工、Q11据实填写；Q08按现有工程骨架目录方案衔接 |
+| 直接来源 | 软件架构设计 Specification 模板 v0.6（2026-09-23），含原文明确的技术方向及工程约束 |
+| 编排依据 | 当前企业 SOP 的公共技术规约模板、AD 模板及交接合同；工程组织引用现有目录规范1.0.0 |
+| 确认依据 | 2026-10-20确认原有共用规则；2026-10-21确认将推荐版本矩阵补入规约，K8s暂按既有1.28记录。确认技术选择不等于授权升级、安装、部署或通过兼容验收 |
 | 维护与采用 | 共用规则及选型方向按上述确认维护；具体项目仍需记录采用版本、适用范围、责任和例外，不由本轮确认替代业务认可或开工许可 |
-| 现有证据 | 已读取来源、现有目录规范及相关原命令，核对MaxKey／Vue官方说明；尚未固定并验证完整软件版本组合，未生成业务工程，未执行安装、构建、测试、部署或发布 |
+| 现有证据 | 已核官方版本／依赖要求及本机工具；已完成Dapr 1.18.7针对K8s 1.28的三组离线Helm渲染。版本矩阵已明确；尚无目标集群连接、工程安装／构建及完整联调证明，见§2.3—§2.6 |
 
 本文件定位为可复用的企业共用技术基线，已写入确认的选型方向与共用约定。第8节分别记录“已经确认的规则”和“项目仍需落实的事实”，不能把版本、环境或运行结果自动标成已验证。项目明确选用后，AD准确引用本文件路径、文内版本及适用条款；按影响起草和交接，不要求所有项目事实先清零。
 
@@ -34,15 +34,16 @@
 | 同一来源，第 6—11 章 | 数据、接口、前端、Agent、集成、权限及恢复的共用约束 | 本文件第 1、3—5 节；主题接口、实体和流程由各 AD 详设 |
 | 同一来源，第 12—17 章及附录 | 工程质量、环境、流水线、实施交接、验证与未决事项 | 本文件第 6—9 节 |
 | 使用者本轮逐项确认（2026-10-20） | 共用基线定位、Java／Spring Boot、前端工具链、MaxKey／OIDC、接口惯例、目录采用、部署分工及按项目落实的规则 | 对应第2—9节；不扩展为版本兼容、业务批准或实际环境就绪 |
-| [公共技术规约模板及采用说明](../README.md) | 已有规范优先、公共规则与主题设计分工、候选与真实采用分开 | 本文件的范围、采用和版本规则 |
-| [当前 AD 模板](../../ad/templates/AD.md) §0.3、§2.2、§9.6 | 基线引用、技术落实和真实骨架来源 | 各主题 AD 的对应条款 |
+| 2026-10-21官方资料核对、本机只读检查与使用者确认 | 固定首套版本选择、保留K8s 1.28及现有GitLab；记录兼容范围与真实验证边界 | 本文件§2.3—§2.6及Q02—Q06、Q09；不自动执行升级或替项目采用 |
+| [公共技术规约模板及采用说明](../readme.md) | 已有规范优先、公共规则与主题设计分工、候选与真实采用分开 | 本文件的范围、采用和版本规则 |
+| [当前 AD 模板](../../ad/templates/ad.md) §0.3、§2.2、§9.6 | 基线引用、技术落实和真实骨架来源 | 各主题 AD 的对应条款 |
 | [当前交接合同](../../handoff-contract.md) §10 | 选定 AD 及必要配套交原 Plan，再进入获准 Build | 本文件第 9 节 |
-| [现有工程骨架方案的来源说明](PROVENANCE.md#工程目录依赖)、[目录规范0.2.0](../references/engineering-directory-v0.2.0/directory-standard.md)、[采用说明0.2.0](../references/engineering-directory-v0.2.0/adoption.md) | 工程目录与职责、AD映射、原Plan任务路径、获准Build的实际文件落点 | 本文件第1、6—9节；目录规范可先采用，不要求预先取得代码框架模板 |
-| [原Ship命令](../../../../.claude/commands/i3-ship.md)及[原Spec的内容要求](../../../../skills/i3-spec-driven-development/SKILL.md) | 发布前检查／决策／回滚，及原SPEC六项的工程命令和项目依据 | 本文件第6—7、9节；原命令与Skill未改 |
+| [目录规范1.0.0](../../engineering-skeleton/directory-standard.md)、[采用说明1.0.0](../../engineering-skeleton/adoption.md) | 工程目录与职责、AD映射、原Plan任务路径、获准Build的实际文件落点 | 本文件第1、6—9节；目录规范可先采用，不要求预先取得代码框架模板 |
+| [原Ship命令](../../../../../.claude/commands/i3-ship.md)及[原Spec的内容要求](../../../../i3-spec-driven-development/SKILL.md) | 发布前检查／决策／回滚，及原SPEC六项的工程命令和项目依据 | 本文件第6—7、9节；原命令与Skill未改 |
 
 源材料沿用总体 `design.md` 和旧 MVP 产物组织。本文件只提取其中适用的技术内容，并按当前已确认的“公共规约＋多主题 PRD／AD”组织；不恢复旧 MVP 流程，不改动源文件，不要求把公共规则复制到每份 AD。原文要求明确写出规则的目的继续保留：AD 必须指出准确规则、适用范围和落实位置，不能只写“沿用旧规范”。
 
-初稿来源快照保存在 [首次历史目录的追溯信息](PROVENANCE.md#维护历史)；本版修改前材料与保护范围保存在 [本版来源追溯信息](PROVENANCE.md#维护历史)。来源文件以后修改，不自动改变本规约或项目已经采用的版本。
+本规约保留已确认技术条款及其来源说明，仅分发当前版本；工程组织统一采用同一SOP Skill内的1.0.0目录规范与采用说明。来源材料或发行资源后续修改，不自动改变项目已经采用的版本。
 
 ## 1. 共用架构与工程边界
 
@@ -55,7 +56,7 @@
 | ARC-05 | 缓存、向量检索、消息、GIS、三维、多 Agent 等按实际需求选择 | 给出需求来源、用途和选型；不使用时说明理由，未知时列为待确认 |
 | ARC-06 | 消费外部能力应依据正式契约，不复制提供方内部实现作为本主题权威 | 固定提供／消费关系和版本；分别记录已可用、待核实、待接入及真实联调条件 |
 
-来源：软件技术说明第3、5、8—11章；现有工程骨架目录方案及目录规范0.2.0的职责分工。
+来源：软件技术说明第3、5、8—11章；现有工程骨架目录方案及目录规范1.0.0的职责分工。
 
 前端共用规则：
 
@@ -74,16 +75,16 @@
 
 | 技术领域 | 已确认的选型方向 | 适用范围 | 当前版本及落实状态 |
 | --- | --- | --- | --- |
-| 正式 Web 前端 | Vue 3＋TypeScript＋Antdv Next | 实际需要 Web 界面的业务工程；具体页面由 PRD 及适用原型确定 | Vue大版本为3；框架、组件库与工具链的精确兼容版本待核，见Q03 |
-| 前端工程工具链 | Vite＋TypeScript类型检查＋Vitest | 首套Web工程的构建、类型检查和单元／组件测试；路由和共享状态管理按需选择 | 工具链方向已确认；Node、包管理器及各依赖的实际版本组合待核，见Q03 |
-| 分布式运行时 | Dapr | 项目实际采用的服务调用、状态、事件或其他运行能力 | Runtime、SDK、组件与后端版本组合待核，见 Q04 |
-| 业务 Agent | Python＋Dapr Agents | 项目包含业务 Agent 时适用；未采用 Agent 的项目不生成 Agent 工程 | Python、框架、SDK及模型接入组合待核，见 Q04 |
-| 持久工作流 | Dapr Workflow | 经具体设计确定需要持久编排或恢复的场景 | 所用 SDK、Runtime、存储支持及版本策略待核，见 Q04 |
-| 目标运行平台 | Kubernetes（K8s） | 采用此企业基线的产品目标部署环境 | 集群版本、部署入口、命名空间与访问条件未提供，见 Q09 |
-| 主数据库 | PostgreSQL | 权威业务数据；执行历史、会话、缓存等用途另行明确 | 版本、扩展、驱动、实例和迁移工具待核，见 Q05 |
-| 代码与流水线 | 企业 GitLab＋GitLab CI | 业务项目的代码协作、构建和交付 | 实例、可用能力、Runner、仓库及产物服务待核，见 Q09 |
-| 普通业务后端 | Java＋Spring Boot | 首套普通业务后端选型方向，与Python Agent的职责和工程分别明确；可用的企业框架先核对复用条件 | 方向经使用者确认；JDK、Spring Boot、构建工具及依赖兼容组合由项目核实，见Q02 |
-| 统一身份与单点登录 | MaxKey＋OIDC | 企业统一账号与认证入口；角色和权限按实际采用能力映射，业务服务执行最终业务授权 | 方向已确认；实例、版本／类型、应用注册、用户／租户映射和失效行为在项目落实，见Q06 |
+| 正式 Web 前端 | Vue 3＋TypeScript＋Antdv Next | 实际需要 Web 界面的业务工程；具体页面由 PRD 及适用原型确定 | 采用§2.3的Vue 3.5.44、TypeScript 5.9.3及Antdv Next 1.6.0；实际安装／构建待验证，见Q03 |
+| 前端工程工具链 | Vite＋TypeScript类型检查＋Vitest | 首套Web工程的构建、类型检查和单元／组件测试；路由和共享状态管理按需选择 | 采用§2.3固定工具链；按需增加路由与状态管理，运行验证见§2.5、Q03 |
+| 分布式运行时 | Dapr | 项目实际采用的服务调用、状态、事件或其他运行能力 | Runtime 1.18.7，所需SDK／组件按§2.3选用；K8s 1.28实际联调待验证，见Q04 |
+| 业务 Agent | Python＋Dapr Agents | 项目包含业务 Agent 时适用；未采用 Agent 的项目不生成 Agent 工程 | 项目环境采用Python 3.12.15、Dapr Agents 1.0.9；保留宿主系统Python，模型接入仍按需验证 |
+| 持久工作流 | Dapr Workflow | 经具体设计确定需要持久编排或恢复的场景 | Python Workflow包1.18.3，按需使用PostgreSQL状态组件v2；恢复与跨版本行为待验证 |
+| 目标运行平台 | Kubernetes（K8s） | 采用此企业基线的产品目标部署环境 | 沿用使用者提供的K8s 1.28，完整补丁／发行版／访问条件待取得；本轮不升级 |
+| 主数据库 | PostgreSQL | 权威业务数据；执行历史、会话、缓存等用途另行明确 | 无既有约束时采用17.11候选；优先核现有服务端，Java驱动42.7.14，实例／扩展／迁移待落实 |
+| 代码与流水线 | 企业 GitLab＋GitLab CI | 业务项目的代码协作、构建和交付 | 现有GitLab 19.2.4；Runner按19.2.x匹配，补丁与平台能力待核；安全更新另行安排 |
+| 普通业务后端 | Java＋Spring Boot | 首套普通业务后端选型方向，与Python Agent的职责和工程分别明确；可用的企业框架先核对复用条件 | 采用OpenJDK 21.0.13、Spring Boot 4.1.1、Maven 3.10.0；依赖与启动验证见Q02 |
+| 统一身份与单点登录 | MaxKey＋OIDC | 企业统一账号与认证入口；角色和权限按实际采用能力映射，业务服务执行最终业务授权 | MaxKey 4.1.12为首轮OIDC接入基线；实例与生产安全更新仍需核实，见§2.3、Q06 |
 
 缓存、消息设施、对象存储、检索、网关、ORM、迁移工具、状态管理、GIS及三维引擎尚未统一指定产品。AD按需说明来源、用途和方案，不默认为全部引入。MaxKey是已确认的统一身份方向，其实际接入信息由项目取得。
 
@@ -97,6 +98,90 @@
 
 来源：软件技术说明第4章及使用者对Q02—Q05的确认。实际版本选择分别核对[Spring Boot系统要求](https://docs.spring.io/spring-boot/system-requirements.html)、[Vue工具说明](https://vuejs.org/guide/scaling-up/tooling)、[Dapr Agents入门条件](https://docs.dapr.io/developing-ai/dapr-agents/dapr-agents-getting-started/)和[PostgreSQL支持政策](https://www.postgresql.org/support/versioning/)。官方说明用于核对方向与条件，不代替本项目完整版本矩阵和运行验证。
 
+### 2.3 首套版本矩阵（2026-10-21确认）
+
+本节记录已确认的首套技术选择及有条件候选，不把“推荐目标”写成“已经安装”或“集成已通过”。实际项目先核已有平台与规范，明确采用本版后再落实所需组件。新增工程在实际依赖文件及锁文件中固定准确版本；可选组件不因列在本表就一律引入。
+
+| 类别 | 组件 | 推荐目标／既有版本 | 选择理由及适用限制 |
+| --- | --- | --- | --- |
+| 前端运行工具 | Node.js | 24.22.0 LTS | 沿用本机24系列，满足Vite和Vue工具链要求；本机当前24.15.0，本轮未升级 |
+| 前端包管理 | pnpm | 12.9.1 | 复用本机已安装版本；项目采用时固定`packageManager`及锁文件，不自动跟随最新版本 |
+| 前端框架 | `vue`、`@vue/compiler-sfc` | 均为3.5.44 | 运行时与编译器保持同版；采用Vue 3稳定线 |
+| 组件库 | Antdv Next | 1.6.0 | 采用正式发布且已有完整工程依赖依据的版本；新发布1.7.0留作后续评估，不自动替换 |
+| 类型检查 | TypeScript／`vue-tsc` | 5.9.3／3.3.13 | 以Antdv Next 1.6.0的TS工具链为依据，保留类型检查；不因TS出现新大版就自动切换 |
+| 构建 | Vite／`@vitejs/plugin-vue` | 8.3.5／6.0.10 | 插件声明支持Vite 8；Vite要求Node `^20.19.0`或`>=22.12.0`，所选Node满足 |
+| 前端测试 | Vitest及所需coverage插件 | 均为4.1.12 | 此版本依赖声明包含Vite 8；作为本规约的保守选择，不宣称与组件库仓库的Vitest版本相同 |
+| 按需前端依赖 | Vue Router／Pinia | 4.6.4／3.0.4 | 沿用Antdv Next 1.6.0工程所用版本线；仅在页面路由或共享状态确有需要时引入 |
+| Java环境 | OpenJDK | 21.0.13 LTS | 延续现有OpenJDK 21系列；本机当前Homebrew OpenJDK 21.0.12.1，升级另行执行 |
+| Java构建 | Maven | 3.10.0 | 复用已安装版本，满足Spring Boot的Maven 3.6.3以上要求 |
+| 普通业务后端 | Spring Boot | 4.1.1 | 所选Java 21在官方兼容范围内；其余Spring依赖由该版BOM管理，不逐项随意混配 |
+| Java数据库驱动 | PostgreSQL JDBC | 42.7.14 | 对Boot 4.1.1 BOM中的42.7.13作明确安全补丁覆盖；需验证连接认证与读写，不以BOM存在替代安全核对 |
+| Agent项目环境 | Python | 3.12.15 | Dapr Agents 1.0.9要求Python `>=3.11,<3.14`；使用独立项目环境，保留本机系统默认3.14.4 |
+| 分布式运行时 | Dapr Runtime | 1.18.7 | 普通sidecar方式；K8s 1.28离线渲染已通过，实际运行与支持边界见§2.4—§2.5 |
+| Dapr管理工具 | Dapr CLI | 1.18.2 | CLI与Runtime分别记录真实发行号；本机尚未安装，不把补丁号强行设成Runtime相同 |
+| 按需Java集成 | Dapr Java SDK | 1.18.1 | 要求Java 17以上；仅采用相应能力时引入。若使用Spring集成，选择专用Boot 4 starter并单独验证，不能误用Boot 3 starter |
+| Python运行能力 | `dapr`／`dapr-ext-workflow` | 均为1.18.3 | 与所选Agents要求的Dapr 1.18包范围一致；工作流包仅用于相应工程 |
+| Agent框架 | `dapr-agents` | 1.0.9 | 已核Python和Dapr依赖范围；框架成熟度与实际模型／工具链仍需项目验证，版本1.x不等于生产验收 |
+| 业务数据库 | PostgreSQL服务端 | 17.11（无既有约束时的候选） | 优先复用已有受支持服务端；本机只确认libpq／psql客户端18.3，不能据此假定服务端也是18.3或自动新建17.11 |
+| Dapr存储 | PostgreSQL state组件 | `v2` | 这是组件协议版本，与数据库17.11分别管理；按需用于Actor／Workflow，业务数据与运行历史分别明确责任、隔离和恢复 |
+| 统一身份 | MaxKey＋OIDC | 4.1.12（首轮接入基线） | 作为独立身份服务通过协议对接，无需与业务服务的Boot主版相同；4.2.0为新发布候选，投产前核其安全修复及迁移影响，不将4.1.12直接认定为生产安全验收通过 |
+
+Java若实际采用Spring集成，候选坐标为`io.dapr.spring:dapr-spring-boot-4-starter:1.18.1`。官方该专用starter存在不等于Boot 4.1.1组合已经联调；仍需核依赖收敛、Jackson序列化和启动行为。只采用Dapr HTTP／gRPC接口时也需明确接口与认证边界，不在本规约里提前替项目改变集成方式。
+
+| 平台／工具 | 本次保留的环境／选择 | 采用与后续处理 |
+| --- | --- | --- |
+| Kubernetes | 1.28，完整1.28.x补丁与发行版待取得 | 按使用者要求保留，不预设升级。该系列已结束上游维护，亦不在本次Dapr官方支持／发布测试范围内；不由此推导为必然无法运行 |
+| kubectl | 集群操作时使用与1.28匹配的专用客户端，准确补丁待核 | 本机Docker附带kubectl 1.34.1，与1.28超出官方±1小版本范围；保留现有工具，后续按需隔离使用匹配客户端 |
+| GitLab | 19.2.4，使用者提供 | 延续既有19.2分支；19.2.8作为同分支安全更新建议，需单独确认与执行，不把它写成已经升级 |
+| GitLab Runner | 19.2.x，实际补丁待核 | 与GitLab主／次版本匹配；未取得实例信息前不编造精确补丁号或可用Runner |
+| Docker Desktop | 本机4.70.0 | 4.96.0作为另行评估的更新候选；本轮未启动Docker或升级。CLI版本不证明实际运行的Engine版本 |
+| Helm及集群部署工具 | 项目实际工具待选择 | 研究中临时使用的Helm 3.19.0不是项目默认工具，也不构成本机全局安装事实 |
+| 工程骨架 | 统一采用本SOP Skill内的目录规范／采用说明1.0.0 | 按本次确认统一来源；项目既有采用不自动升级，先核差异、适用范围及真实工程映射。目录规则不等于可运行代码模板 |
+
+### 2.4 已取得的环境事实与K8s兼容边界
+
+2026-10-21在本机只读检查：macOS 26.3、Apple Silicon、64GB内存；Node 24.15.0、pnpm 12.9.1、Homebrew OpenJDK 21.0.12.1、Maven 3.10.0；系统默认Python 3.14.4，另有3.12.13和3.13.13环境。Python目标3.12.15尚未建立项目环境，不替换系统Python。
+
+PostgreSQL已定位的是Homebrew libpq 18.3工具。在已查常见路径、进程、服务及本机5432端口中未找到正在运行的服务端；仍可能存在停止的容器、其他路径或远端实例。项目应先取得服务端的真实版本、位置和访问方式，再决定是否采用17.11新建候选。
+
+本机Docker daemon未运行，当前没有Kubernetes context或可访问集群配置；Dapr CLI和Helm不在当前PATH中。K8s 1.28及GitLab 19.2.4来自使用者说明，尚未通过目标平台查询核实。
+
+对官方Dapr 1.18.7 chart所做的离线检查仅包括：针对`--kube-version 1.28.0`和`1.28.15`的默认渲染，以及1.28.15的HA渲染，三组退出码均为0。该chart没有`kubeVersion`硬性排除1.28；渲染出的内置API未见明显要求高于1.28的版本。首轮校验文件下载超时与后续成功记录分别保留，没有把失败转算通过。
+
+这些结果不包含服务端Schema接收、server-side dry-run、实际安装、Pod启动、网络／存储、Workflow或Agent验收。Dapr 1.18.7该发布的kind矩阵覆盖K8s 1.32.8、1.33.4、1.34.0，没有1.28。因此本规约的结论是“既有1.28保留，普通sidecar有静态兼容依据，真实兼容待验证”，不能写成“官方支持1.28”或“已证明必然不能运行”。
+
+保持`dapr_sidecar_injector.nativeSidecar=false`，不主动设置Pod注解`dapr.io/enable-native-sidecar=true`。K8s 1.28的原生sidecar依赖默认关闭的Alpha功能，普通Dapr sidecar不要求启用它。Job／CronJob若使用普通sidecar，AD须按所选版本说明结束和退出方式，避免业务容器结束后sidecar阻碍Job完成。
+
+### 2.5 实施前后的验证安排
+
+| 编号 | 需取得的结果 | 通过依据及影响范围 |
+| --- | --- | --- |
+| V01 前端 | 选定版本的安装、类型检查、构建及适用测试 | 依据真实`package.json`、锁文件和命令输出验证Vue／Antdv／Vite／TS／Vitest组合；缺项仅限制相关前端实现／交付 |
+| V02 Java | Boot 4.1.1的依赖收敛、启动、序列化与JDBC行为 | 核所选JDK、Maven、PG JDBC安全补丁覆盖；实际用到Dapr starter时再核Boot 4专用starter及Jackson组合，不预判联调通过 |
+| V03 Agent／Workflow | Python 3.12.15环境及完整依赖解析；真实模型、工具和持久执行 | 核Agents／SDK约束、中断恢复、重复执行与授权失效；替身范围与真实服务联调分开，未采用能力不要求凭空搭建 |
+| V04 K8s／Dapr | 目标1.28集群中的实际安装与必要业务链 | 取得准确补丁、发行版、匹配客户端和合法访问条件；核CRD／webhook／权限、Pod、DNS／网络、持久卷、Placement／Scheduler及业务实际所用能力，保留失败和回滚说明 |
+| V05 数据与身份 | 真实PostgreSQL／MaxKey实例信息及联调 | 优先核既有实例；验证认证、角色／租户映射、退出撤权、读写／迁移／恢复及版本安全更新，不能用客户端号或产品名代替服务端事实 |
+| V06 交付平台 | GitLab／Runner／镜像与部署所需实际能力 | 据实补Runner补丁、仓库、环境和权限引用；GitLab／Docker更新另行安排，不因版本矩阵已写入就宣称平台已准备好 |
+
+验证按对应AD、Plan任务及实际阶段执行，继续区分设计审查、工程执行、集成、业务认可和发布授权。未验证项可以保留并明确其影响，不要求在AD起草前先搭出所有环境；依赖它们的实施或放行也不能凭文档确认自动通过。
+
+### 2.6 官方依据与核对日期
+
+以下资料用于2026-10-21的版本选择和兼容条件核对。滚动文档可能变化；实际实施时以本节明确版本、相应发布说明及真实解析结果复核，不跟随链接自动更新本规约。
+
+| 范围 | 官方依据 | 本次核对点 |
+| --- | --- | --- |
+| Node／包管理 | [Node 24.22.0](https://nodejs.org/en/blog/release/v24.22.0)、[pnpm安装要求](https://pnpm.io/installation) | 24系列LTS及所选工具环境要求；pnpm复用实际12.9.1 |
+| Vue／Antdv | [Vue 3.5.44包](https://registry.npmjs.org/vue/3.5.44)、[Antdv Next 1.6.0](https://github.com/antdv-next/antdv-next/releases/tag/antdv-next%401.6.0)、[对应工程依赖](https://github.com/antdv-next/antdv-next/blob/antdv-next%401.6.0/pnpm-workspace.yaml) | 组件库发布、Vue／TS／Router／Pinia工程范围；不把组件库仓库所有测试版本照搬成项目义务 |
+| TS／构建／测试 | [TypeScript 5.9.3](https://registry.npmjs.org/typescript/5.9.3)、[vue-tsc 3.3.13](https://registry.npmjs.org/vue-tsc/3.3.13)、[Vite 8.3.5](https://registry.npmjs.org/vite/8.3.5)、[Vue插件6.0.10](https://registry.npmjs.org/@vitejs/plugin-vue/6.0.10)、[Vitest 4.1.12](https://registry.npmjs.org/vitest/4.1.12) | Node engines及peer／依赖约束；包元数据满足不代替项目构建 |
+| Java／Boot | [Homebrew OpenJDK 21](https://formulae.brew.sh/formula/openjdk@21)、[Maven历史](https://maven.apache.org/docs/history.html)、[Boot要求](https://docs.spring.io/spring-boot/system-requirements.html)、[Boot 4.1.1 BOM](https://repo.maven.apache.org/maven2/org/springframework/boot/spring-boot-dependencies/4.1.1/spring-boot-dependencies-4.1.1.pom) | JDK／Maven兼容、BOM依赖管理；Homebrew OpenJDK发行与其他JDK发行包分别判断 |
+| PostgreSQL驱动 | [JDBC 42.7.14说明](https://jdbc.postgresql.org/changelogs/2026-10-07-42.7.14-release/) | 针对BOM的42.7.13明确采用安全补丁，保留项目认证和读写验证 |
+| Python／Agent | [Python 3.12.15](https://www.python.org/downloads/release/python-31215/)、[Agents 1.0.9依赖](https://github.com/dapr/dapr-agents/blob/v1.0.9/pyproject.toml)、[Dapr 1.18.3](https://pypi.org/pypi/dapr/1.18.3/json)、[Workflow 1.18.3](https://pypi.org/pypi/dapr-ext-workflow/1.18.3/json) | Python范围及Dapr SDK范围，不采用系统3.14为Agent项目环境 |
+| Dapr版本／Java集成 | [Runtime 1.18.7](https://github.com/dapr/dapr/releases/tag/v1.18.7)、[CLI 1.18.2](https://github.com/dapr/cli/releases/tag/v1.18.2)、[Boot 4 starter 1.18.1 POM](https://repo.maven.apache.org/maven2/io/dapr/spring/dapr-spring-boot-4-starter/1.18.1/dapr-spring-boot-4-starter-1.18.1.pom)、[Spring集成说明](https://docs.dapr.io/developing-applications/sdks/java/spring-boot/) | 组件分别定版；专用starter可用性与完整组合验证分开 |
+| K8s兼容 | [Dapr支持政策](https://docs.dapr.io/operations/support/support-release-policy/)、[1.18.7 chart](https://github.com/dapr/dapr/blob/v1.18.7/charts/dapr/Chart.yaml)、[sidecar配置](https://github.com/dapr/dapr/blob/v1.18.7/charts/dapr/charts/dapr_sidecar_injector/values.yaml)、[该版kind测试](https://github.com/dapr/dapr/blob/v1.18.7/.github/workflows/kind-e2e.yaml)、[K8s版本](https://kubernetes.io/releases/)、[kubectl偏差规则](https://kubernetes.io/releases/version-skew-policy/) | 支持范围、发布测试、离线模板与真实运行分别取证；保留既有1.28 |
+| 数据／身份 | [PostgreSQL支持](https://www.postgresql.org/support/versioning/)、[Dapr PostgreSQL v2](https://docs.dapr.io/reference/components-reference/supported-state-stores/setup-postgresql-v2/)、[MaxKey 4.1.12](https://github.com/dromara/MaxKey/releases/tag/4.1.12)、[MaxKey 4.2.0](https://github.com/dromara/MaxKey/releases/tag/4.2.0) | 新建候选、已有实例及生产安全选择分别处理 |
+| 交付工具 | [GitLab安全补丁](https://docs.gitlab.com/releases/patches/patch-release-gitlab-19-4-2-released/)、[Runner版本](https://docs.gitlab.com/runner/#gitlab-runner-versions)、[Docker Desktop说明](https://docs.docker.com/desktop/release-notes/) | 保留19.2.4及本机4.70.0；更新建议不写成已执行 |
+
 ## 3. 身份、安全与业务权限
 
 统一身份和单点登录采用MaxKey，通过OIDC对接。MaxKey作为独立的公共身份服务，业务工程不再自行复制一套账号密码体系；如需适配现有账号系统，先明确来源、映射和生命周期责任。
@@ -166,17 +251,17 @@
 
 ### 6.1 工程骨架与文件责任
 
-- ENG-01：工程骨架沿用现有[目录规范0.2.0](../references/engineering-directory-v0.2.0/directory-standard.md)和[采用说明0.2.0](../references/engineering-directory-v0.2.0/adoption.md)。`pbc-composite`与`agent-standalone`是组织方式，frontend、backend、agents、jobs及配套契约、共享代码、测试和交付位置按需采用；内部遵循实际语言／框架惯例。
+- ENG-01：工程骨架沿用现有[目录规范1.0.0](../../engineering-skeleton/directory-standard.md)和[采用说明1.0.0](../../engineering-skeleton/adoption.md)。`pbc-composite`与`agent-standalone`是组织方式，frontend、backend、agents、jobs及配套契约、共享代码、测试和交付位置按需采用；内部遵循实际语言／框架惯例。
 - ENG-02：目录规范是实际可读的设计输入，可以在工程创建前采用。AD记录规范来源／版本、业务项目根、已有／拟建工程和模块映射；未采用代码框架模板时如实说明，不要求预先取得企业代码模板或冻结首套完整技术栈。
 - ENG-03：AD §9.2明确源码、模块、配置、测试、契约及装配位置，§9.6说明已有工程与拟建内容；原Plan把预计新增／修改文件路径、依赖和验证写入任务；获准的Build在这些位置生成实际内容，核对文件落点并执行原有测试／构建。
 - ENG-04：共享底座、契约和文件只有一处维护责任及实际任务来源，其他主题引用依赖；新增 PRD 不自动复制底座。再次生成或更新时保留人工修改、历史及已完成任务，冲突先核范围。
 - ENG-05：目录规范不要求另建project.yaml、templates.lock、contracts.lock、生成记录库或代码模板三方升级流程。已有项目或工具确有这些文件时按其实际用途保留；项目另行要求复用特定代码模板时，才取得该模板及所需版本、应用和验证依据。
 
-可以在现有AD的骨架栏目写明“目录规范已采用；工程拟建；未采用代码框架模板”，不能据此声称“可运行代码模板已取得”或“代码已生成”。实际目录来源为本资源附带的0.2.0定版资料；资源目录和i3维护工作区均不是业务工程输出根。
+可以在现有AD的骨架栏目写明“目录规范已采用；工程拟建；未采用代码框架模板”，不能据此声称“可运行代码模板已取得”或“代码已生成”。实际目录来源为本资源附带的1.0.0定版资料；资源目录和i3维护工作区均不是业务工程输出根。
 
 既有工程先映射实际目录，不为套规范移动或重建。实际有内容时再建所需位置；项目根的构建／CI配置与框架原有布局允许按实情保留。目录检查、代码存在、构建、启动、业务验证和发布分别取证。
 
-来源：现有工程骨架目录方案、目录规范／采用说明0.2.0，以及当前AD §9.2／§9.6的对应栏目。本轮只引用这些资源，不修改工程骨架工作树或SOP运行模板；原命令的读取与实际落点继续按对应工程验证任务取证。
+来源：现有工程骨架目录方案、目录规范／采用说明1.0.0，以及当前AD §9.2／§9.6的对应栏目。本轮只引用这些资源，不修改工程骨架工作树或SOP运行模板；原命令的读取与实际落点继续按对应工程验证任务取证。
 
 ### 6.2 工程命令与编码规范
 
@@ -228,14 +313,14 @@
 | 编号 | 已确认的共用处理 | 项目仍需落实的内容与影响 | 处理时点 |
 | --- | --- | --- | --- |
 | Q01 | 本文作为可复用企业技术基线，项目明确采用准确版本 | 项目名称、维护责任、范围和既有规范由项目采用说明／AD绑定；不在公共规约预造业务身份 | 实际项目采用时 |
-| Q02 | 首套普通业务后端采用Java＋Spring Boot方向，与Python Agent分工 | 取得JDK、框架、构建及企业框架复用条件的实际版本；不能将方向确认写为兼容已通过 | 相关详设和工程任务按依赖核实 |
-| Q03 | 保留Vue 3＋TypeScript＋Antdv Next，工具链采用Vite、类型检查和Vitest方向 | Node、包管理器、各依赖版本、路由和状态管理需求及安装／构建结果待项目落实 | 初始化及依赖安装前核实，生成后验证 |
-| Q04 | Dapr／Agent按实际需要的能力建立组合版本和验证安排 | 固定Runtime、SDK、Python、Agents、Workflow及底层组件，验证必要业务链、中断恢复、重复与授权失效 | 依赖相关能力的设计／工程阶段分别核实 |
-| Q05 | PostgreSQL优先兼容企业已有受支持版本，逻辑责任与恢复分别设计 | 版本、驱动、扩展、实例、迁移工具、DDL和恢复方案仍须真实来源及执行证据 | 数据工程设计、迁移及运行前 |
-| Q06 | 统一身份采用MaxKey，通过OIDC接入；业务服务执行最终授权 | 取得实例、版本／类型、应用注册、用户／租户／角色映射、退出撤权及配置引用；不虚构claims或可用能力 | 身份相关契约和实现前 |
+| Q02 | 首套普通业务后端采用Java＋Spring Boot方向，与Python Agent分工 | §2.3已明确JDK／Boot／Maven／JDBC目标；核实际工程依赖、企业框架复用、启动及序列化，不将版本确认写为兼容已通过 | 相关详设和工程任务按依赖核实 |
+| Q03 | 保留Vue 3＋TypeScript＋Antdv Next，工具链采用Vite、类型检查和Vitest方向 | §2.3已明确首套前端版本；核实际依赖／锁文件，按需引入路由／状态管理，安装／类型／构建／测试结果仍待验证 | 初始化及依赖安装前核实，生成后验证 |
+| Q04 | Dapr／Agent按实际需要的能力建立组合版本和验证安排 | 按§2.3固定所用版本；在保留的K8s 1.28上验证实际安装、必要业务链、中断恢复、重复与授权失效，离线渲染不替代运行证据 | 依赖相关能力的设计／工程阶段分别核实 |
+| Q05 | PostgreSQL优先兼容企业已有受支持版本，逻辑责任与恢复分别设计 | 先定位已有服务端；17.11仅是无既有约束的新建候选，驱动42.7.14已定，扩展／实例／迁移／DDL／恢复仍须真实证据 | 数据工程设计、迁移及运行前 |
+| Q06 | 统一身份采用MaxKey，通过OIDC接入；业务服务执行最终授权 | 4.1.12为首轮接入基线，投产前核4.2.0安全更新；取得实际实例／类型、应用注册、映射、退出撤权及配置引用，不虚构claims或可用能力 | 身份相关契约和实现前 |
 | Q07 | API camelCase、数据库snake_case、跨端大整数ID字符串、明确时间点时区、稳定业务码与关联标识 | 正式契约补精确字段、分页上限、格式／精度、主键生成、审计及存量映射，避免擅改已有契约 | 相关公共契约及主题AD定稿前 |
-| Q08 | 引用现有目录规范／采用说明0.2.0，沿用原AD→Plan→Build的目录映射链 | 明确业务根及真实／拟建路径；目录规范可先采用，实际代码由获准Build生成验证；只有另行要求特定代码模板才须取得该模板 | AD映射、Plan任务文件路径、Build实际落点依次核对 |
-| Q09 | AD规定部署要求，Plan安排任务，Build形成配置，Ship核验汇总部署准备 | 实际环境、资源、权限及配置按依赖取得；部署清单和运行配置不冒充平台已就绪 | 构建、联调、部署和发布按需落实 |
+| Q08 | 引用现有目录规范／采用说明1.0.0，沿用原AD→Plan→Build的目录映射链 | 明确业务根及真实／拟建路径；目录规范可先采用，实际代码由获准Build生成验证；只有另行要求特定代码模板才须取得该模板 | AD映射、Plan任务文件路径、Build实际落点依次核对 |
+| Q09 | AD规定部署要求，Plan安排任务，Build形成配置，Ship核验汇总部署准备 | K8s 1.28和GitLab 19.2.4为使用者提供的环境；补完整集群信息、Runner及实际资源／权限／配置，部署资料不冒充平台已就绪 | 构建、联调、部署和发布按需落实 |
 | Q10 | 保留已有质量下限，新增指标从PRD或真实工程决定取得 | 质量、容量、恢复、预算、保留、告警与适用要求的具体值和测量方法属于项目；不得填造通用数字 | 对应测试设计、处理数据或放行前 |
 | Q11 | 根据实际情况填写各工程命令、cwd、前提、成功依据和风格 | 已有工程读取真实配置；新工程按任务创建并验证，未验证保持实际状态；不要求用户预先写假命令 | 本次规划与任务执行按依赖补足 |
 | Q12 | 具体业务主题及数据／契约责任从选定PRD和各主题AD形成 | 绑定实际接口、事件、工具、实体和提供／消费方；不把它们作为通用规约必须提前填完的内容 | 每个主题AD与必要关联契约设计时 |
@@ -253,15 +338,15 @@
 3. AD §0.3登记本规约及目录规范／采用说明的来源和版本，§2.2落实技术选择，§9.2映射工程及模块位置，§9.6区分现有工程和拟建内容；目录规范可在代码生成前采用，保留三图和全部详设责任。
 4. 原型按需，可与 AD 并行。记录假设和受影响未决；候选生成、完整回读和人工认可分别处理，保存后遵守原 Spec 停轮。
 
-以下提示词供将来明确采用时使用，当前未执行此作业；`/i3-sop` 属于尚未发布的本地候选入口：
+以下任务在项目明确取得并采用本版规约后使用；资料由实际加载的SOP Skill的references及辅助清单定位，不要求使用者填写安装内部路径。文件存在不证明项目已采用，已有安装不被假定包含本地候选：
 
 ```text
 /i3-sop ad
-本次采用 随包提供的《企业应用公共技术规约 v0.0.2》（按所选资源索引定位） 作为公共技术依据。
+本次采用我明确提供的《企业应用公共技术规约 v0.0.4》作为公共技术依据；按本次选定SOP Skill资源索引定位。
 先确定当前业务项目、我已选定的 PRD 主题和准确版本；存在歧义先问。
-实际读取这份规约、其引用的工程目录规范／采用说明0.2.0及本次必要来源，列出适用条款、已有规范冲突和影响本主题的项目缺口。
+实际读取这份规约、其引用的工程目录规范／采用说明1.0.0及本次必要来源，列出适用条款、已有规范冲突和影响本主题的项目缺口。
 按原 Spec Skill 和完整 AD 模板生成本主题设计，保留三图、工程细节和 SPEC 六项。
-沿用已确认的后端、前端工具链和MaxKey／OIDC方向，不重复猜选型；未确定的版本、具体字段和工程映射按实际来源补足。
+沿用§2.3已确认的版本矩阵，保留既有K8s 1.28与GitLab 19.2.4；逐项区分目标与实装，未验证的兼容性、具体字段和工程映射按实际来源补足。
 按现有目录规范明确本主题源码、模块、配置、测试和契约的已有／拟建位置，不要求预先提供一套代码框架模板，也不宣称工程已生成。
 保留已有人工修改，回读最终稿，交我审阅后停轮，不进入 Plan 或 Build。
 ```
@@ -288,8 +373,8 @@
 
 ### 9.4 本次交付结论
 
-本版已根据使用者确认补齐公共基线定位、普通业务后端、前端工具链、MaxKey／OIDC、接口惯例、目录规范采用、部署分工及按实情填写的规则。Q01—Q12现在区分已确认内容和项目待落实事项；实际项目采用、精确版本兼容和工程实施结果仍各自核验。
+本版保留2026-10-20／21确认的共用规则、技术版本矩阵、本机及既有平台事实、官方依据与V01—V06验证安排，并按2026-10-22确认将工程目录及采用说明统一为1.0.0。Q02—Q06、Q09区分已选择版本与仍待取得的环境／运行证据；其他已确认规则保留。K8s 1.28继续保留，三组Dapr离线渲染不作为真实集群通过证明。
 
 本文件可供人工审阅，并可在明确选用后作为 AD 的公共输入。它不证明某项目的整体技术设计已经批准，也不证明所有主题可交 Plan、可直接 Build 或已通过运行验收。
 
-版本记录：v0.0.1（2026-10-20）为首次来源整理，原文完整保留。v0.0.2（2026-10-20）落实本轮确认，并引用当前工程目录规范0.2.0；不再把旧代码模板／工程锁方案作为统一前置。原说明、公共模板、AD模板、Skill、命令、SOP与工程骨架运行资源、业务稿保持原状，未提交或发布。
+版本记录：v0.0.4（2026-10-22）统一SOP Skill内的工程目录来源1.0.0及资源引用，技术选型、版本矩阵和验证边界保留。通用模板、AD模板、原版Skill／命令、已有UI原型能力与业务稿未改。未执行技术栈安装、升级、部署或npm发布，i3发行版本未调整。