@givolt/i3-composer-agent 3.0.0 → 3.2.1

package/.agents/plugins/marketplace.json

@@ -6,7 +6,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "3.0.0",
+      "version": "3.2.1",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "source": {
         "source": "local",

package/.claude/commands/i3-sop.md

@@ -1,6 +1,6 @@
 ---
-description: "显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
-# i3-description-source: "description: 显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
+description: "显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划"
+# i3-description-source: "description: 显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划"
 ---
 
 <!-- i3:zh-CN:start -->
@@ -11,7 +11,7 @@ description: "显式使用企业 SOP，复用原规格方法完成单阶段文
 Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
 严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
 
-适用说明：显式使用企业 SOP，复用原规格方法完成单阶段文档与交接
+适用说明：显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划
 <!-- i3:zh-CN:end -->
 
 Invoke the i3-enterprise-sop skill and pass the complete arguments unchanged. The skill owns operation handling, resource selection, original-method invocation, handoff and stopping rules.

package/.claude/commands/i3-ui-demo.md

@@ -0,0 +1,21 @@
+---
+description: "使用内置模板和固定设计、组件能力创建及增量修改 UI 原型。"
+# i3-description-source: "description: Create and incrementally update template-based Vue and antdv-next UI demos"
+---
+
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：使用内置模板和固定设计、组件能力创建及增量修改 UI 原型。
+<!-- i3:zh-CN:end -->
+
+Explicitly invoke the i3-ui-demo skill in the current session for the request below.
+Keep its template choices, dependency preparation, output locations and verification rules in that skill.
+Preserve explicit read-only limits, confirmed choices and manual edits. Continue necessary user choices in this session.
+
+$ARGUMENTS

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "3.0.0",
+      "version": "3.2.1",
       "source": "./",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "homepage": "https://github.com/49780522/i3-composer-agent",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "3.0.0",
+  "version": "3.2.1",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "3.0.0",
+  "version": "3.2.1",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"
@@ -12,7 +12,7 @@
   "interface": {
     "displayName": "i3 Composer Agent",
     "shortDescription": "中文软件工程全流程技能",
-    "longDescription": "i3 Composer Agent 提供 27 项工程技能，覆盖需求、计划、实现、测试、审查与发布，默认使用简体中文。",
+    "longDescription": "i3 Composer Agent 提供 28 项工程技能，覆盖需求、计划、实现、测试、审查与发布，默认使用简体中文。",
     "developerName": "Givolt",
     "category": "Productivity",
     "capabilities": [

package/.gemini/commands/i3-sop.toml

@@ -1,5 +1,5 @@
-description = "显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
-# i3-description-source: "description = \"显式使用企业 SOP，复用原规格方法完成单阶段文档与交接\""
+description = "显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划"
+# i3-description-source: "description = \"显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划\""
 
 prompt = """
 <!-- i3:zh-CN:start -->
@@ -10,7 +10,7 @@ prompt = """
 Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
 严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
 
-适用说明：显式使用企业 SOP，复用原规格方法完成单阶段文档与交接
+适用说明：显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划
 <!-- i3:zh-CN:end -->
 
 Invoke the i3-enterprise-sop skill and pass the complete arguments unchanged. The skill owns operation handling, resource selection, original-method invocation, handoff and stopping rules.

package/.gemini/commands/i3-ui-demo.toml

@@ -0,0 +1,21 @@
+description = "使用内置模板和固定设计、组件能力创建及增量修改 UI 原型。"
+# i3-description-source: "description = \"Create and incrementally update template-based Vue and antdv-next UI demos\""
+
+prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：使用内置模板和固定设计、组件能力创建及增量修改 UI 原型。
+<!-- i3:zh-CN:end -->
+
+Explicitly invoke the i3-ui-demo skill in the current session for the request below.
+Keep its template choices, dependency preparation, output locations and verification rules in that skill.
+Preserve explicit read-only limits, confirmed choices and manual edits. Continue necessary user choices in this session.
+
+$ARGUMENTS
+"""

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v3.0.0
+# i3 Composer Agent v3.2.1
 
 **Intelligence. Integration. Innovation.**
 
@@ -7,37 +7,32 @@
 Skill 和命令使用 `i3-` 前缀。默认简体中文交互；用户明确要求时可切换语言。
 代码标识、路径、参数、工具协议和机器状态保持原样。
 
-## 企业 SOP 文档与规划
+## 企业开发 SOP
 
-新增 `/i3-sop` 命令和 `i3-enterprise-sop` Skill，共 27 个技能、11 个命令。
-标准流程继续使用原 `/i3-spec`、`/i3-plan`、`/i3-build` 等入口；企业 SOP 需要明确选择，
-普通安装或原 using 不会自动切换为企业流程。
-
-在项目中使用短命令加一句任务，缺少范围、主题或来源时由模型先澄清：
+通过 `/i3-sop` 命令或显式选择 `i3-enterprise-sop` Skill，使用同一套四阶段模板、工程 SPEC 和项目规划规则。本版统一为28个技能、12个命令，企业流程由用户逐阶段发起。
 
 ```text
-/i3-sop brd 梳理设备运营的业务能力，先确认业务边界。
-/i3-sop prd 根据已选 BRD，为巡检管理编写任务编排主题 PRD。
-/i3-sop ad 根据已选 PRD 制定详细设计，优先采用本项目现有技术规约。
-/i3-sop testcase 根据当前 AD 设计测试用例和测试报告要求。
-/i3-sop plan 为已选主题制定实施计划，读取完整的设计和必要工程依据。
+/i3-sop brd 根据这份业务诉求梳理业务能力并编写 BRD。
+/i3-sop prd 根据这份 BRD 编写当前主题 PRD，关键缺口先问我。
+/i3-sop ad 根据选定 PRD 编写 AD，优先采用本项目已有的技术规约。
+/i3-sop testcase 根据当前主题的 PRD、配套 AD 设计用例和测试报告要求。
+/i3-sop spec 为当前主题生成工程 SPEC。
+/i3-sop plan 根据我认可的工程 SPEC 制定计划和任务。
 ```
 
-显式 Skill 使用同一规则，例如“使用 i3-enterprise-sop，根据当前 PRD 编写 AD”。
-文档生成／修订复用原 Spec 方法，Plan 动作复用原规划方法，输出原 `tasks/plan.md` 和
-`tasks/todo.md`，交人审阅。计划获准后继续使用原 `/i3-build` 或 `/i3-build auto`；
-auto 仍遵守原规格、Git 基线、明确认可、测试与逐任务提交要求。
+显式 Skill 使用同一规则，例如“使用 i3-enterprise-sop prd，根据这份 BRD 编写当前主题 PRD”。没有给出动作或范围不清楚时，由主会话引导选择。
+
+- T1：`brd`、`prd`、`ad`、`testcase` 分别编写、整理或修订企业文档，真实显式调用原 Spec Skill；采用完整模板和必要来源，保存并核对完整性后自动登记交接清单，交人审阅并停止。
+- T2：用户主动选择 `spec`，读取本 EBC 的交接清单，检查当前主题的 BRD、PRD、AD 及必要依据，真实显式调用原 Spec Skill，形成包含六项内容的工程 SPEC。缺项或冲突先说明，生成后交人审阅并停止。TestCase可选。
+- T3：用户主动选择 `plan`，读取已认可的工程 SPEC，真实显式调用原规划 Skill，输出原 `tasks/plan.md` 与唯一任务清单，交人审阅并停止。计划获准后，由用户启动原 `/i3-build`、`/i3-build auto` 及后续流程。
+
+一个业务项目对应一个EBC。BRD默认直接存于`spec/`根目录，路径为`spec/{EBC名称}-BRD_v{业务版本}.md`；PRD、AD、TestCase默认存于各自PBC目录，路径为`spec/{PBC名称}/{PBC名称}-{主题名称}-{PRD|AD|TestCase}_v{各自版本}.md`。交接清单保存在`spec/handoff.json`，工程规格保存在`spec/SPEC-{PBC名称}-{主题名称}.md`，规划时默认从`spec/`根目录定位当前主题的`SPEC*.md`。同一EBC可包含多个PBC及各自独立主题的PRD，文档版本分别维护。清单只保留`schemaVersion`、`scope`、`selected`，相对路径基于业务项目根，也支持手动传递准确路径；既有明确采用位置或外部原件保留实际路径，不自动迁移。
+
+输入可以是自然语言或外部文档，用户明确选用的自改模板和项目规范优先。Skill自带四份模板、[企业应用具体技术规约](skills/i3-enterprise-sop/references/technical-baseline/baselines/enterprise-application-technical-baseline-v0-0-4.md)、[通用技术规约模板](skills/i3-enterprise-sop/references/technical-baseline/templates/technical-baseline.md)和[目录规范1.0.0](skills/i3-enterprise-sop/references/engineering-skeleton/directory-standard.md)。没有项目替代规范时，AD默认带入具体规约与目录规范；目录规范不等于已生成代码。
 
-支持同一 PBC 的多份独立主题 PRD，各自独立版本并关联对应 AD／TestCase；
-原型按需，可与 AD 并行；独立 TestCase 不作为 Plan 的统一必填前置。
-JSON 交接只保留 `schemaVersion`、`scope`、`selected`，也保留手动传递路径的方式。
-项目自改模板与已有工程规范优先采用，审查只报告问题，不自动修改业务稿。
+正常保存不强制再次全文加载新稿，保留落盘完整性检查、内容自查、人工修改及每阶段审阅停点。原型按需，可与AD并行。完整规则见 [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md)。
 
-包内提供四阶段模板／提示词、公共技术规约模板及采用示例，以及工程目录与采用资源 **1.0.0**。
-技术规约示例需按实际项目确认采用，工程目录资源不等于已生成整套业务代码。
-安装后的配套根中可读 [SOP 采用说明](references/enterprise-sop-resources/README.md) 和
-[工程骨架资源](references/engineering-skeleton-resources/README.md)。
-3.0.0 由人逐阶段发起与审阅；SOP 全流程自动调度和 i3-config 不包含在本次发行。
+标准流程继续使用原 `/i3-spec`、`/i3-plan`、`/i3-build` 等入口。普通安装或原 using 不会自动切换企业流程；原版方法和命令保持。
 
 ## 通过向导安装
 
@@ -57,10 +52,10 @@ WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；
 搜索、翻页和命令参数预选均保留选择。搜索外 `q`、Esc 或 Ctrl-C 取消。
 确认工具后选择项目/全局范围并确认安装。
 
-可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围、UIUX／antDv 及最终确认支持数字选择。CodeBuddy／WorkBuddy 默认注册原型审计 Hooks，保留明确禁用状态；无需选择 Hook 组或 IDE／CLI。其他原版 Hook 脚本随包交付，按需通过统一管理器另行启用。UIUX／antDv 可选择安装两项、单项或跳过，之后也可补装。
+可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围及最终确认支持数字选择。原型审计 Hooks 已移除，新安装不注册，升级精确清理本包旧注册并保留其他设置与历史。原版 Hook 脚本随包交付，按需通过统一管理器明确选择组启用。ui-ux-pro-max 和 antDv 官方 Skill／CLI 默认准备：同版复用，高版保留并验证，低版提示升级；两项检查通过后才显示安装完毕和版本。
 
-全部目标均安装 27 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
-全部目标同时提供 11 个命令和 4 个 Agent 角色提示。
+全部目标均安装 28 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
+全部目标同时提供 12 个命令和 4 个 Agent 角色提示。
 CodeBuddy、WorkBuddy、Claude Code 使用原生命令入口；其他工具通过 Skills 机制使用，
 命令和角色文件可作为资料读取，是否自动发现取决于宿主。
 目录预设来自固定的 [Skills CLI 工具登记](https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/src/agents.ts)
@@ -198,9 +193,10 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 | /i3-composer-agent:i3-prototype | 在主会话中分析、创建、检查与迭代 UI 交互原型。 |
 | /i3-composer-agent:i3-review | 从正确性、可读性、架构、安全和性能五个维度审查代码。 |
 | /i3-composer-agent:i3-ship | 并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。 |
-| /i3-composer-agent:i3-sop | 显式使用企业 SOP，复用原规格方法完成单阶段文档与交接 |
+| /i3-composer-agent:i3-sop | 显式使用企业 SOP，生成或修订企业文档、工程 SPEC 和项目计划 |
 | /i3-composer-agent:i3-spec | 先编写结构化规格、目标、范围与验收标准，再进入实现。 |
 | /i3-composer-agent:i3-test | 执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。 |
+| /i3-composer-agent:i3-ui-demo | 使用内置模板和固定设计、组件能力创建及增量修改 UI 原型。 |
 | /i3-composer-agent:i3-webperf | 调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。 |
 
 `/i3-build auto` 按已获批准的任务计划执行完整流程。
@@ -215,8 +211,8 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 完整企业后台 HTML 内容模板可双击 index.html 离线查看与修改；生成的 Vue 3＋antDv-next 工程
 使用真实组件，支持明亮、暗黑、清新、科技四主题，默认明亮。已有原型按原合同继续使用。
 模板在 Skill 源码中维护并随版本发布，生成时只读引用；业务直接修改原型工程，不默认创建项目 ui-templates。
-UI/UX Pro Max 与 antDv 官方 Skill 可通过 `--prototype-skills uiux,antdv` 明确选择安装，
-也可稍后检测／补装；工具随所选宿主和范围存入 `tools/i3-prototype/`，旧路径继续兼容。
+ui-ux-pro-max 2.15.0 与 antDv 官方 Skill／CLI（默认 0.0.0-beta.6 固定快照）随安装向导默认准备。
+同版不动，高版保留并验证，低版提示升级；i3-ui-demo 专用工具位于 `tools/i3-ui-demo/`，查询知识与业务组件固定 1.6.0。
 默认采用专业增强模式，UIUX 不可用时提示修复或由用户明确选择模板模式继续。
 两项外部能力不计入本包技能数量。AI 工作台、数字孪生大屏和移动端模板仍在规划中。
 每个生成原型仍需独立的交互验收和用户评审；本包尚未实现企业 SOP 自动编排。
@@ -236,7 +232,7 @@ UI/UX Pro Max 与 antDv 官方 Skill 可通过 `--prototype-skills uiux,antdv`
 | [i3-deprecation-and-migration](skills/i3-deprecation-and-migration/SKILL.md) | 管理废弃与迁移。适用于替换旧系统、API 或功能、迁移用户、生产数据库无停机扩展/收缩，以及决定维护或退役现有代码。 |
 | [i3-documentation-and-adrs](skills/i3-documentation-and-adrs/SKILL.md) | 记录文档、架构决策与设计理由。适用于编写 ADR、公共 API 发生变化时补充文档、交付功能，以及保存后续工程师和代理理解设计取舍所需的背景。 |
 | [i3-doubt-driven-development](skills/i3-doubt-driven-development/SKILL.md) | 对非平凡决策进行独立的对抗式审查。适用于核查假设、压力测试计划、寻找隐藏失败模式、陌生代码、安全敏感功能、生产认证或高风险不可逆迁移。 |
-| [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md) | 组织显式选择的企业 SOP 文档与规划交接。适用于明确调用 i3-enterprise-sop 起草 BRD、PRD、AD、TestCase、制定 Plan 或传递选定资料；短命令先澄清缺口，再复用原版方法。 |
+| [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md) | 组织企业开发文档、工程规格和项目规划。适用于显式调用 i3-enterprise-sop 编写、整理或修订 BRD、PRD、AD、TestCase、生成工程 SPEC 或依据规格规划任务。 |
 | [i3-frontend-ui-engineering](skills/i3-frontend-ui-engineering/SKILL.md) | 实现可访问、响应式、具有生产质量的前端界面。适用于页面/组件开发、布局、状态管理、WCAG 无障碍、交互与视觉质量改进。 |
 | [i3-git-workflow-and-versioning](skills/i3-git-workflow-and-versioning/SKILL.md) | 组织 Git 分支、提交、冲突处理、PR 与版本发布。适用于任何代码改动、拆分工作区改动、并行开发、推送、合并、语义化版本、标签及变更日志。 |
 | [i3-idea-refine](skills/i3-idea-refine/SKILL.md) | 通过发散与收敛思考完善模糊想法。适用于创意探索、细化方案、验证假设、压力测试计划，以及确定方向前比较更多选项。 |
@@ -250,6 +246,7 @@ UI/UX Pro Max 与 antDv 官方 Skill 可通过 `--prototype-skills uiux,antdv`
 | [i3-source-driven-development](skills/i3-source-driven-development/SKILL.md) | 以官方文档和权威来源支撑实现决策。适用于核对框架/库用法、验证方案、查证 API 和避免过时实现，并保留来源证据。 |
 | [i3-spec-driven-development](skills/i3-spec-driven-development/SKILL.md) | 在实现前形成结构化规格。适用于新项目、功能或重大改动、PRD、需求澄清、目标与范围、场景和验收标准，以及将需求拆为独立可测试能力。 |
 | [i3-test-driven-development](skills/i3-test-driven-development/SKILL.md) | 执行测试先行的红绿重构循环。适用于实现逻辑、修复缺陷、修改行为、复现报错及证明改动有效；也用于为函数补测试、修复或修改直接粘贴的代码，即使请求未提到测试；缺陷修复使用先证明失败的 Prove-It 模式。 |
+| [i3-ui-demo](skills/i3-ui-demo/SKILL.md) | 基于业务文档或提示词和内置模板创建、增量修改 Vue 3 与 antdv-next 1.6.0 交互原型。适用于明确请求 ui-demo、模板驱动的界面演示与只读方案分析，以及新增页面、调整设计或修复交互；结合自有能力定义、原生组件映射、模板视觉变量和专业技能完成生成与检查。 |
 | [i3-ui-prototype](skills/i3-ui-prototype/SKILL.md) | 将 HTML 内容模板、业务需求与目标组件框架组合为可操作 UI 原型。适用于原型分析、原型候选生成、原型交互验证和已确认原型基线维护；生产页面实现使用工程流程。 |
 | [i3-using-agent-skills](skills/i3-using-agent-skills/SKILL.md) | 发现并调用合适的工程技能。适用于开始会话、判断任务意图、选择技能或工作流；作为元技能协调其他技能的发现和调用。 |
 

package/bin/i3-composer-agent.cjs

@@ -21,7 +21,6 @@ ${pkg.name}
   npx ${pkg.name} --workbuddy --scope global
   npx ${pkg.name} --agents codebuddy,workbuddy --scope global --yes
   npx ${pkg.name} --agents codebuddy,codex --scope project --yes
-  npx ${pkg.name} --codebuddy --scope project --yes --prototype-skills uiux,antdv
   npx ${pkg.name} prototype-deps check --host codex --scope project --project <project>
   npx ${pkg.name} prototype-deps query --host codebuddy --scope project --project <project> --kind info --component Table
   npx ${pkg.name} prototype-deps install --host workbuddy --scope global --skills uiux,antdv
@@ -37,12 +36,10 @@ ${pkg.name}
   --claude           预选 Claude Code
   --scope <scope>    project 项目 / global 全局（也可 --global / --local）
   --project-dir <dir> 项目安装根目录，默认当前目录
-  --prototype-skills <ids> 可选原型依赖：none、uiux、antdv、uiux,antdv；向导数字选择，--yes 未指定时跳过
-  --migrate-tools     显式迁移有 i3 来源记录的旧独立 antDv 工具；仅项目范围且需选择 antdv
-  --hooks <action>    默认注册原型 Hooks；keep 保留 / enable / list / check / disable
-  --hook-groups <ids> session-start,sdd-cache,simplify-ignore,prototype 或 all；启停默认 prototype
+  --hooks <action>    不默认启用 Hook；keep 保留原版组并清理退役原型注册 / enable / list / check / disable
+  --hook-groups <ids> session-start,sdd-cache,simplify-ignore 或 all；启用需明确选择
   --codebuddy-skill-routing <mode> hook（明确需要会话注入）/ native（已有原生路由）
-  --prototype-hooks <action> 旧参数保留，仅管理 prototype 组
+  --prototype-hooks <action> 退役兼容参数：check / disable / keep；enable 不再支持
   --codebuddy-product <form> 旧版 ide / cli 参数兼容；新注册默认 auto 自动识别
   --codebuddy-transcript-root <dir|auto> 默认自动识别；可选手动原生日志限制，auto 切回自动
   --codebuddy-version <version> 实际宿主版本，便于核验记录
@@ -58,13 +55,13 @@ ${pkg.name}
 
 终端向导先显示常用工具，WorkBuddy 在第 2 项；选择“更多”可分页/搜索全部工具。
 输入工具编号（如 1,2）后回车，或上下键移动/跨页、空格勾选、回车确认；q/Esc 退出。
-范围、可选原型依赖和最终确认使用数字选择；默认注册原型 Hooks，不再选择 IDE/CLI 或 Hook 组。
+安装范围和最终确认使用数字选择。默认准备 ui-ux-pro-max、antdv 官方 Skill 与 @antdv-next/cli。
 CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
 其他工具通过 Skills 调用，短命令支持取决于宿主。
 所有工具默认安装单份 skills、commands、agents；配套资料集中在 i3-composer-agent/。
 评测、脚本和 Hook 读取同一份已安装技能。--prepare 用于另行导出标准插件并按宿主方式注册。
 WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
-评测需主动运行；CodeBuddy/WorkBuddy 默认注册原型 Hooks，保留明确禁用状态。实际生效需宿主审核/重载和回调验证。
+原型审计 Hooks 不再注册；升级仅清理本包旧注册，其他设置保留。
 --prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
@@ -194,8 +191,7 @@ async function main() {
       if (arg === '--agents') options.agents.push(value);
       else if (arg === '--scope') { if (options.scope && options.scope !== value) throw new Error('请选择一个安装范围。'); options.scope = value; }
       else if (arg === '--prototype-skills') {
-        require('../skills/i3-ui-prototype/scripts/optional-skill-install.cjs').selection(value);
-        options.prototypeSkills = value;
+        if (!['uiux,antdv', 'antdv,uiux'].includes(value)) throw new Error('UI Demo 必备依赖已改为默认准备，--prototype-skills 不再支持跳过或单项安装。请移除此参数后重试。');
       }
       else if (arg === '--prototype-hooks') {if(!['keep','enable','check','disable'].includes(value))throw new Error('原型 Hooks 请选择 keep / enable / check / disable');options.prototypeHooks=value;}
       else if (arg === '--hooks') {if(!['keep','enable','disable','list','check'].includes(value))throw new Error('Hooks 请选择 keep / enable / disable / list / check');options.hooks=value;}
@@ -231,57 +227,55 @@ async function main() {
   } else if (!options.agents.length || !options.scope || (!options.yes && !options.dryRun)) {
     throw new Error('请在交互终端使用向导，或明确指定 --agents <ids> --scope project|global --yes。');
   }
-  if (options.migrateTools && (options.scope !== 'project' || !options.prototypeSkills?.split(',').includes('antdv'))) throw new Error('--migrate-tools requires project scope and selected antdv');
+  if (options.migrateTools) throw new Error('默认安装将保留旧工具，在新目录准备约定版本；请移除 --migrate-tools 后重试。');
   const buddyHosts=options.agents.filter(id=>['codebuddy','workbuddy'].includes(id));
-  if(!['keep','default'].includes(hookOptions().action)&&!buddyHosts.length)throw new Error('原型 Hooks 当前适配 CodeBuddy 和 WorkBuddy');
+  if(!['keep','default'].includes(hookOptions().action)&&!buddyHosts.length)throw new Error('Hooks 管理当前适配 CodeBuddy 和 WorkBuddy');
   const hookManager=require('../hooks/manage.cjs');
   const hookChanges=(options.scope==='project'?buddyHosts.slice(0,1):buddyHosts).map(host=>hookManager.prepare(hookOptions(host)));
   const hookSummary=hookChanges.length===1?hookChanges[0].summary:hookChanges.map(change=>change.summary);
   const plan = installer.planInstallation(options);
+  const dependencies = require('../skills/i3-ui-demo/scripts/dependencies.cjs');
+  const required = plan.targets.flatMap(target => options.agents.filter(host => target.agents.includes(host)).map(host => {
+    const settings = { project: options.projectDir, host, scope: plan.scope };
+    return { settings, detection: dependencies.check(settings) };
+  }));
   if (options.dryRun) {
     console.log(JSON.stringify({ name, version: pkg.version, mode: plan.mode, scope: plan.scope, agents: plan.agents, targets: plan.targets, conflicts: plan.conflicts, reused: plan.reused,
-      ...(options.prototypeSkills !== undefined ? { optionalPrototypeSkills: options.prototypeSkills, migrateTools: !!options.migrateTools } : {}),...(hookChanges.length?{hooks:hookSummary}:{}) }, null, 2));
+      requiredDependencies: required.map(item => item.detection),...(hookChanges.length?{hooks:hookSummary}:{}) }, null, 2));
     return;
   }
+  for (const item of required) {
+    for (const notice of item.detection.notices) console.log(notice);
+    dependencies.assertPreparable(item.detection);
+  }
   if (!options.yes) {
-    const confirmed = await require('./wizard.cjs').confirm(plan, { prototypeSkills: options.prototypeSkills, hooks: hookChanges.length?hookSummary:null });
+    const confirmed = await require('./wizard.cjs').confirm(plan, { hooks: hookChanges.length?hookSummary:null });
     if (!confirmed) { console.log('安装已取消，未修改文件。'); return; }
     options.force = plan.conflicts.length > 0;
   }
   installer.executeInstallation(plan, { force: options.force });
   for(const hookChange of hookChanges)if(hookChange.summary.changed) {
-    try {console.log(JSON.stringify({hooks:hookManager.apply(hookChange)},null,2));}
-    catch(error){throw new Error(`核心文件已安装，Hooks 注册未完成；请保留当前配置并重试或提供错误。${error.message}`);}
-  }
-  console.log(identity);
-  if (plan.reused.length) console.log(`已复用同版本的 ${plan.reused.length} 个未修改内容。`);
-  for (const target of plan.targets) {
-    console.log(`已为 ${target.agents.join(', ')} 安装技能：${target.skillsDirectory}`);
-    if (target.nativeCommands) console.log(`命令：/i3-spec、/i3-plan、/i3-build、/i3-ship（共 ${target.catalog.commands.length} 个工作流）：${target.commandsDirectory}`);
-    else console.log(`命令和角色资料已提供；是否自动发现取决于宿主：${target.commandsDirectory}、${target.personasDirectory}`);
-    console.log(`评测资料：${target.evalsDirectory}`);
-    console.log(`完整校验：进入 "${target.toolkitDirectory}" 后运行 npm test`);
-    console.log(`中文评测：node "${path.join(target.scriptsDirectory, 'run-evals.js')}" --locale zh-CN --min-rank1 95`);
-    console.log(`Hooks：${target.hooksDirectory}${target.agents.some(id=>['codebuddy','workbuddy'].includes(id))?'；统一检查：node "'+path.join(target.hooksDirectory,'manage.cjs')+'" check --host '+target.agents.find(id=>['codebuddy','workbuddy'].includes(id))+' --scope '+plan.scope+' --project "'+options.projectDir+'"':'；按宿主协议手动配置'}`);
-  }
-  for (const file of plan.preserved || []) console.log(`保留了用户文件：${file}`);
-  console.log('请重新加载 IDE 窗口或新建宿主会话以发现安装内容。');
-  if (plan.agents.some(id => !['codebuddy', 'workbuddy', 'claude-code'].includes(id))) console.log('这些工具通过技能 ID 调用；生命周期短命令支持取决于宿主。');
-  console.log('核心安装完成。评测说明见 i3-composer-agent/evals/README.md。');
-  for(const hookChange of hookChanges)console.log(hookChange.summary.enabledGroups.length?`Hooks 已注册：${hookChange.summary.enabledGroups.join('、')}；${hookChange.summary.host}，IDE/CLI 自动识别。桌面端重载；CodeBuddy CLI 在 /hooks 审核。实际调用与补调另行验证。`:'Hooks 保留禁用或未启用状态；使用 hooks check 检查。');
-  if (options.prototypeSkills !== undefined && options.prototypeSkills !== 'none') {
     try {
-      // Shared project targets (for example CodeBuddy + WorkBuddy) prepare once.
-      for (const target of plan.targets) {
-        const result = await require('../skills/i3-ui-prototype/scripts/optional-skill-install.cjs').install({ project: options.projectDir,
-          host: target.agents[0], scope: plan.scope, skills: options.prototypeSkills, migrateTools: !!options.migrateTools });
-        console.log(JSON.stringify({ optionalPrototypeDependencies: result }, null, 2));
-      }
-    } catch (error) {
-      throw new Error(`i3 核心已安装成功；可选原型依赖未完成，可稍后用 prototype-deps install 重试。${error.message}`);
+      const result=hookManager.apply(hookChange);
+      if(hookChange.summary.action==='enable')console.log(JSON.stringify({hooks:result},null,2));
+    }
+    catch(error){
+      const operation=hookChange.summary.action==='enable'?'Hooks 注册':'旧原型审计注册清理';
+      throw new Error(`核心文件已安装，${operation}未完成；请保留当前配置并重试或提供错误。${error.message}`);
     }
-  } else {
-    console.log('UIUX / antDv 独立依赖未自动安装。可随时用 prototype-deps check 检测，或 prototype-deps install --skills uiux,antdv 按需准备。');
   }
+  try {
+    // Shared native folders reuse the first successful preparation. Each
+    // selected host still has to discover and validate its own dependencies.
+    for (const item of required) {
+      const result = await dependencies.prepare({ ...item.settings, accept: true });
+      if (!result.continue || !result.detection?.ready) throw new Error('必备依赖未全部通过检查');
+      for (const backup of result.backups || []) console.log(`ui-ux-pro-max 已升级，原目录完整保留于：${backup}`);
+    }
+  } catch (error) {
+    throw new Error(`必备依赖准备未完成，本次安装尚未完成；核心文件已保留，可重新运行安装向导重试。${error.message}`);
+  }
+  console.log('安装完毕');
+  console.log(identity);
 }
 main().catch(error => { console.error(`${name}: ${error.message}`); process.exitCode = 1; });

package/bin/install.cjs

@@ -7,7 +7,7 @@ const crypto = require('node:crypto');
 const registry = require('./agent-targets.json');
 const { cleanupBackups } = require('./cleanup-backups.cjs');
 const { nativeAssets, renderAsset } = require('./native-layout.cjs');
-const { migrationAssets, pruneRetiredDirectories, ownsAsset } = require('./native-migration.cjs');
+const { migrationAssets, pruneRetiredDirectories, ownsAsset, sopResource } = require('./native-migration.cjs');
 const { fingerprint } = require('./asset-fingerprint.cjs');
 const root = path.resolve(__dirname, '..');
 const name = 'i3-composer-agent';
@@ -54,6 +54,8 @@ function manifestContent(plan, asset) {
   return JSON.stringify({ name, version, layoutVersion: 3, entryPrefix: 'i3-', scope: plan.scope, agents: asset.target.agents,
     capabilities: { nativeCommands: !!asset.target.nativeCommands, nativeAgents: !!asset.target.nativeCommands, hooks: asset.target.agents.includes('codebuddy')?'codebuddy-managed':'manual' },
     catalog: asset.target.catalog, resources: asset.target.resources,
+    sopResourceFingerprints: Object.fromEntries(plan.assets.filter(item => item.base === asset.base && sopResource(item.relative) && item.source)
+      .map(item => [item.relative, fingerprint(item.source, item)])),
     assets: plan.assets.filter(item => item.base === asset.base && !['legacy', 'result'].includes(item.kind)).map(item => assetPath(asset.base, item.destination)) }, null, 2) + '\n';
 }
 function planInstallation({ agents, scope, projectDir = process.cwd(), home = os.homedir(), env = process.env }) {
@@ -104,10 +106,16 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
       // A new grouped resource must not take ownership of an unrelated file,
       // even when --force confirms replacement of a previous installation.
       const previousOwned = owned && ownsAsset(previous, asset.relative);
-      asset.protectedResource = /^(references|evals|hooks|scripts|docs|i3-composer-agent)\//.test(asset.relative);
+      asset.protectedResource = /^(references|evals|hooks|scripts|docs|i3-composer-agent)\//.test(asset.relative) || sopResource(asset.relative);
       if (exists(asset.destination) && !previousOwned && asset.protectedResource) {
         throw new Error(`未归属本包的同名资源，不能覆盖，请先处理：${asset.destination}`);
       }
+      if (previousOwned && sopResource(asset.relative) && exists(asset.destination)) {
+        const expected = previous.sopResourceFingerprints?.[asset.relative] || fingerprint(asset.source, asset);
+        const observed = fingerprint(asset.destination);
+        if (observed !== expected) throw new Error(`保留了项目自改或来源未知的SOP资料，不能覆盖，请先比较并明确处理：${asset.destination}`);
+        asset.protectedSopFingerprint = observed;
+      }
     }
     assets.push({ target, destination: destination(manifestFile), kind: 'manifest', mergeable: sameVersion });
     for (const asset of assets.slice(start)) {
@@ -186,7 +194,11 @@ function executeInstallation(plan, { force = false } = {}) {
       if (asset.kind === 'result' && fingerprint(asset.source) !== asset.expectedFingerprint) throw new Error(`安装期间评测结果已改变：${asset.source}`);
       if (asset.kind === 'result' && asset.existing && fingerprint(asset.destination) !== asset.expectedFingerprint) throw new Error(`安装期间目标评测结果已改变：${asset.destination}`);
       if (asset.retiredFingerprint && fingerprint(asset.destination) !== asset.retiredFingerprint) {
-        throw new Error(`安装期间旧原型入口已改变，保留文件并停止自动退出：${asset.destination}`);
+        const label = sopResource(asset.relative) || /references\/(?:enterprise-sop-resources|engineering-skeleton-resources)\//.test(asset.relative) ? '旧SOP资料' : '旧原型入口';
+        throw new Error(`安装期间${label}已改变，保留文件并停止自动退出：${asset.destination}`);
+      }
+      if (asset.protectedSopFingerprint && fingerprint(asset.destination) !== asset.protectedSopFingerprint) {
+        throw new Error(`安装期间SOP资料已改变，保留人工修改并停止：${asset.destination}`);
       }
       if (asset.reusable) {
         const unchanged = fingerprint(asset.destination) === asset.expectedFingerprint

package/bin/native-layout.cjs

@@ -65,6 +65,7 @@ function nativeScript(text, relative) {
 
 function renderAsset(buffer, asset) {
   const relative = asset.sourceRelative || '';
+  if (relative.startsWith('docs/upstream-repository/')) return buffer;
   if (relative.startsWith('evals/fixtures/')) return buffer;
   let text = buffer.toString('utf8');
   if (asset.kind === 'toolkit-package') {
@@ -78,7 +79,7 @@ function renderAsset(buffer, asset) {
     '本目录提供评测、校验、回归测试、Hook、共享参考资料和使用指南。技能、命令和 Agent 位于上一级的对应目录，只有一份；这里的评测读取宿主实际安装的内容。\n\n' +
     '进入本目录后运行：\n\n```bash\nnpm test\nnode scripts/run-evals.js --locale zh-CN --min-rank1 95\n```\n\n' +
     '`npm test` 执行内容校验、中英文确定性评测及全部脚本回归测试，不需要 npm install。模型行为评测需要另行配置执行宿主；详见 [evals/README.md](evals/README.md)。\n\n' +
-    '`adapters/` 保留其他命令格式和插件清单，供原版一致性校验与回归测试使用，不自动注册或启用插件。CodeBuddy 通过 `hooks/manage.cjs` 统一管理原版三组和新增原型审计，默认不启用；其他宿主仍按各自协议配置。缓存与代码块保护分别详见 [hooks/SDD-CACHE.md](hooks/SDD-CACHE.md) 和 [hooks/SIMPLIFY-IGNORE.md](hooks/SIMPLIFY-IGNORE.md)，CodeBuddy 管理见 [docs/codebuddy-setup.md](docs/codebuddy-setup.md)。\n');
+    '`adapters/` 保留其他命令格式和插件清单，供原版一致性校验与回归测试使用，不自动注册或启用插件。CodeBuddy 通过 `hooks/manage.cjs` 管理原版三组，默认不启用；原型审计已移除，升级精确清理本包旧注册并保留其他设置和历史。其他宿主仍按各自协议配置。缓存与代码块保护分别详见 [hooks/SDD-CACHE.md](hooks/SDD-CACHE.md) 和 [hooks/SIMPLIFY-IGNORE.md](hooks/SIMPLIFY-IGNORE.md)，CodeBuddy 管理见 [docs/codebuddy-setup.md](docs/codebuddy-setup.md)。\n');
   if (asset.kind === 'runtime') return Buffer.from(text.replace('__I3_INSTALL_VERSION__', asset.version));
   if (asset.kind === 'script') return Buffer.from(nativeScript(text, relative));
   if (relative === 'hooks/session-start.sh') {

package/bin/native-migration.cjs

@@ -6,6 +6,8 @@ const { fingerprint } = require('./asset-fingerprint.cjs');
 const inventory = require('./legacy-native-files.json').files;
 const name = 'i3-composer-agent';
 const publishedFiles = new Set(inventory);
+const retiredSopFingerprints = require('./retired-sop-fingerprints.json').files;
+const sopResource = relative => /^skills\/(?:i3-)?enterprise-sop\/references\//.test(relative);
 // Reviewed native bytes from the 99b5eae / 521c958 pilot package. Earlier or
 // edited variants have no reliable content record in layout-3 manifests, so
 // they require manual handling rather than trusting a path-only ownership claim.
@@ -63,9 +65,24 @@ function migrationAssets(target, previous, current) {
     if (retired.has(relative) || current.has(relative)) return;
     const file = fileAt(base, relative);
     if (!file || !fs.statSync(file).isFile()) return;
+    let retiredFingerprint = retiredPrototypeAssets[relative];
+    if (/^(?:i3-composer-agent\/)?references\/(?:enterprise-sop-resources|engineering-skeleton-resources)\//.test(relative)) {
+      const expected = retiredSopFingerprints[relative];
+      const observed = fingerprint(file);
+      if (!expected?.includes(observed)) {
+        throw new Error(`保留了已修改或来源未知的旧SOP资料，不能自动退出，请先比较并明确处理：${file}`);
+      }
+      retiredFingerprint = observed;
+    } else if (sopResource(relative)) {
+      const observed = fingerprint(file);
+      if (!previous.sopResourceFingerprints?.[relative] || previous.sopResourceFingerprints[relative] !== observed) {
+        throw new Error(`保留了已修改或缺少原件记录的SOP资料，不能自动退出，请先比较并明确处理：${file}`);
+      }
+      retiredFingerprint = observed;
+    }
     retired.add(relative);
     assets.push({ base, destination: file, relative, kind: 'legacy',
-      ...(retiredPrototypeAssets[relative] ? { retiredFingerprint: retiredPrototypeAssets[relative] } : {}) });
+      ...(retiredFingerprint ? { retiredFingerprint } : {}) });
   }
   for (const relative of previous.assets) {
     const file = fileAt(base, relative);
@@ -120,4 +137,4 @@ function pruneRetiredDirectories(assets) {
   }
 }
 
-module.exports = { migrationAssets, pruneRetiredDirectories, ownsAsset };
+module.exports = { migrationAssets, pruneRetiredDirectories, ownsAsset, sopResource };