@givolt/i3-composer-agent 3.2.1 → 4.0.0

package/.agents/plugins/marketplace.json

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

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

@@ -1,6 +1,7 @@
 ---
 description: "按任务增量实现、构建、测试、验证并提交；添加 auto 可按已获批准的完整计划执行。"
 # i3-description-source: "description: Implement tasks incrementally — build, test, verify, commit. Add \"auto\" to run the whole plan in one approved pass."
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

package/.claude/commands/i3-code-simplify.md

@@ -1,6 +1,7 @@
 ---
 description: "简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。"
 # i3-description-source: "description: Simplify code for clarity and maintainability — reduce complexity without changing behavior"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。"
 # i3-description-source: "description: Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "把工作拆成带验收标准、验证步骤和依赖顺序的小任务。"
 # i3-description-source: "description: Break work into small verifiable tasks with acceptance criteria and dependency ordering"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "从正确性、可读性、架构、安全和性能五个维度审查代码。"
 # i3-description-source: "description: Conduct a five-axis code review — correctness, readability, architecture, security, performance"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。"
 # i3-description-source: "description: Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "先编写结构化规格、目标、范围与验收标准，再进入实现。"
 # i3-description-source: "description: Start spec-driven development — write a structured specification before writing code"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。"
 # i3-description-source: "description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern."
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

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

@@ -1,6 +1,7 @@
 ---
 description: "调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。"
 # i3-description-source: "description: Run a web performance audit via the web-performance-auditor persona"
+disable-model-invocation: true
 ---
 
 <!-- i3:zh-CN:start -->

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "3.2.1",
+      "version": "4.0.0",
       "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.2.1",
+  "version": "4.0.0",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.codex-plugin/plugin.json

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

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v3.2.1
+# i3 Composer Agent v4.0.0
 
 **Intelligence. Integration. Innovation.**
 
@@ -9,31 +9,44 @@ Skill 和命令使用 `i3-` 前缀。默认简体中文交互；用户明确要
 
 ## 企业开发 SOP
 
-通过 `/i3-sop` 命令或显式选择 `i3-enterprise-sop` Skill，使用同一套四阶段模板、工程 SPEC 和项目规划规则。本版统一为28个技能、12个命令，企业流程由用户逐阶段发起。
+通过 `/i3-sop` 命令或显式选择 `i3-enterprise-sop` Skill，使用同一套四阶段模板、工程 SPEC 和项目规划规则。本版提供 27 个技能、11 个命令，企业流程由用户逐阶段发起。
 
 ```text
 /i3-sop brd 根据这份业务诉求梳理业务能力并编写 BRD。
-/i3-sop prd 根据这份 BRD 编写当前主题 PRD，关键缺口先问我。
+/i3-sop prd 根据这份 BRD 编写本PBC PRD，关键缺口先问我。
 /i3-sop ad 根据选定 PRD 编写 AD，优先采用本项目已有的技术规约。
-/i3-sop testcase 根据当前主题的 PRD、配套 AD 设计用例和测试报告要求。
-/i3-sop spec 为当前主题生成工程 SPEC。
+/i3-sop testcase 根据本PBC的 PRD、配套 AD 设计用例和测试报告要求。
+/i3-sop spec 为本PBC生成工程 SPEC。
 /i3-sop plan 根据我认可的工程 SPEC 制定计划和任务。
 ```
 
-显式 Skill 使用同一规则，例如“使用 i3-enterprise-sop prd，根据这份 BRD 编写当前主题 PRD”。没有给出动作或范围不清楚时，由主会话引导选择。
+显式 Skill 使用同一规则，例如“使用 i3-enterprise-sop prd，根据这份 BRD 编写本PBC PRD”。没有给出动作或范围不清楚时，由主会话引导选择。
 
 - T1：`brd`、`prd`、`ad`、`testcase` 分别编写、整理或修订企业文档，真实显式调用原 Spec Skill；采用完整模板和必要来源，保存并核对完整性后自动登记交接清单，交人审阅并停止。
-- T2：用户主动选择 `spec`，读取本 EBC 的交接清单，检查当前主题的 BRD、PRD、AD 及必要依据，真实显式调用原 Spec Skill，形成包含六项内容的工程 SPEC。缺项或冲突先说明，生成后交人审阅并停止。TestCase可选。
+- T2：用户主动选择 `spec`，读取本 EBC 的交接清单，检查本PBC的 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`，相对路径基于业务项目根，也支持手动传递准确路径；既有明确采用位置或外部原件保留实际路径，不自动迁移。
+一个业务项目对应一个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/`根目录定位本PBC的`SPEC*.md`。同一EBC可包含多个PBC，每个PBC一套PRD／AD／TestCase，文档版本分别维护。Schema 3清单只保留`schemaVersion`、`scope`、`selected`，按`selected.pbcs[]`中的唯一`pbcId`选择，不再按PRD主题分组，相对路径基于业务项目根，也支持手动传递准确路径；既有明确采用位置或外部原件保留实际路径，不自动迁移。
 
 输入可以是自然语言或外部文档，用户明确选用的自改模板和项目规范优先。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默认带入具体规约与目录规范；目录规范不等于已生成代码。
 
-正常保存不强制再次全文加载新稿，保留落盘完整性检查、内容自查、人工修改及每阶段审阅停点。原型按需，可与AD并行。完整规则见 [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md)。
+正常保存不强制再次全文加载新稿，保留落盘完整性检查、内容自查、人工修改及每阶段审阅停点。原型按需另行发起 ui-demo，可与 AD 并行；PRD／AD 固定引用实际实例版本、HANDOFF 与设计／QA 资料。完整规则见 [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md)。
 
 标准流程继续使用原 `/i3-spec`、`/i3-plan`、`/i3-build` 等入口。普通安装或原 using 不会自动切换企业流程；原版方法和命令保持。
 
+### 4.0 升级与已知限制
+
+4.0采用“一PBC一套文档”的Schema 3清单，不自动迁移旧Schema 1／2或合并多主题文稿。升级前保留旧清单、业务文档和人工修改，先核实各PBC完整范围及引用，确认后再另存或修订。旧`/i3-prototype`入口退出，原型制作改用`/i3-ui-demo`；业务原型和用户Hook配置保留。
+
+CodeBuddy实测中，仅输入`/i3-sop plan`仍可能漏读原Plan命令和SPEC引用的必要AD／PRD。本版没有修复该问题，也不将“调用成功、文件生成”当作读取合规。现阶段可明确说明：
+
+```text
+/i3-sop plan 请先按SOP读取原Plan命令、选定工程SPEC及其本次必要依据，再真实调用原规划Skill，生成计划和任务后交我审阅。
+```
+
+上述方式已有单次通过记录，不代表稳定性保证。按现有SOP取得必要正文、处理冲突并审阅计划后再启动Build；BRD不是T3无条件必读项，TestCase也不作为所有项目的统一前置。
+
+
 ## 通过向导安装
 
 在要使用技能的项目中运行：
@@ -52,10 +65,10 @@ WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；
 搜索、翻页和命令参数预选均保留选择。搜索外 `q`、Esc 或 Ctrl-C 取消。
 确认工具后选择项目/全局范围并确认安装。
 
-可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围及最终确认支持数字选择。原型审计 Hooks 已移除，新安装不注册，升级精确清理本包旧注册并保留其他设置与历史。原版 Hook 脚本随包交付，按需通过统一管理器明确选择组启用。ui-ux-pro-max 和 antDv 官方 Skill／CLI 默认准备：同版复用，高版保留并验证，低版提示升级；两项检查通过后才显示安装完毕和版本。
+可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围及最终确认支持数字选择。定制 Hook 管理器已移除，安装升级不修改用户 Hook 配置。原版 Hook 脚本、说明和测试随包保留，按宿主原有机制使用。ui-ux-pro-max 和 antDv 官方 Skill／CLI 默认准备：同版复用，高版保留并验证，低版提示升级；两项检查通过后才显示安装完毕和版本。
 
-全部目标均安装 28 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
-全部目标同时提供 12 个命令和 4 个 Agent 角色提示。
+全部目标均安装 27 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
+全部目标同时提供 11 个命令和 4 个 Agent 角色提示。
 CodeBuddy、WorkBuddy、Claude Code 使用原生命令入口；其他工具通过 Skills 机制使用，
 命令和角色文件可作为资料读取，是否自动发现取决于宿主。
 目录预设来自固定的 [Skills CLI 工具登记](https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/src/agents.ts)
@@ -190,7 +203,6 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 | /i3-composer-agent:i3-code-simplify | 简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。 |
 | /i3-composer-agent:i3-constraints | 访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。 |
 | /i3-composer-agent: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，生成或修订企业文档、工程 SPEC 和项目计划 |
@@ -207,15 +219,9 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 由主会话汇总 GO/NO-GO 决策，回滚计划必需。代码审查使用 Critical、Required、Optional、Nit
 四级；Critical 和 Required 问题默认阻止发布，各专业角色仍保留自己的报告字段和判断规则。
 
-`/i3-prototype` 在主会话调用 `i3-ui-prototype` 技能，按需求使用前端与浏览器技能完成原型。
-完整企业后台 HTML 内容模板可双击 index.html 离线查看与修改；生成的 Vue 3＋antDv-next 工程
-使用真实组件，支持明亮、暗黑、清新、科技四主题，默认明亮。已有原型按原合同继续使用。
-模板在 Skill 源码中维护并随版本发布，生成时只读引用；业务直接修改原型工程，不默认创建项目 ui-templates。
-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 自动编排。
+`/i3-ui-demo` 在主会话调用 `i3-ui-demo`，使用本技能内置模板、ui-ux-pro-max、antdv 和前端／浏览器技能制作或增量修改交互原型。默认企业管理后台模板，交付 Vue 3 与 antdv-next 1.6.0；其他模板的可用状态以 Skill 为准。
+安装向导默认准备必备设计技能与官方 Skill／CLI，同版复用，高版保留并验证，低版提示升级；工具位于 `tools/i3-ui-demo/`。制作与检查以当前 Skill 为准，技术验证和具体版本的用户认可分别判断。
+SOP 中可在 PRD 后按需制作原型，与 AD 并行；PRD／AD 固定引用实际实例、版本、HANDOFF和设计／QA资料，SPEC、TestCase及Plan沿文档引用承接。不自动生成后续规格、计划或进入Build。
 
 ## Skills
 
@@ -225,7 +231,7 @@ ui-ux-pro-max 2.15.0 与 antDv 官方 Skill／CLI（默认 0.0.0-beta.6 固定
 | [i3-browser-testing-with-devtools](skills/i3-browser-testing-with-devtools/SKILL.md) | 通过 Chrome DevTools MCP 在真实浏览器测试。适用于网页开发或排错、检查 DOM、控制台错误、网络请求、性能及视觉结果；需要配置 chrome-devtools MCP。 |
 | [i3-ci-cd-and-automation](skills/i3-ci-cd-and-automation/SKILL.md) | 配置 CI/CD 构建与部署流水线。适用于每次 PR 自动执行 lint 和测试、失败阻止合并，配置持续集成质量门禁与部署策略。 |
 | [i3-code-review-and-quality](skills/i3-code-review-and-quality/SKILL.md) | 按正确性、可读性、架构、安全与性能审查代码。适用于合并前审查自己、其他代理或人工编写的改动，包括 diff、PR 和内联代码评审。 |
-| [i3-code-simplification](skills/i3-code-simplification/SKILL.md) | 在保持行为不变的前提下简化代码。适用于简化现有代码结构、重构复杂逻辑、保留全部现有行为，并提高可读性、维护性与可扩展性。 |
+| [i3-code-simplification](skills/i3-code-simplification/SKILL.md) | 在保持行为不变的前提下简化代码。适用于简化现有代码结构、重构复杂逻辑、保留全部现有行为，并提高可读性、维护性与可扩展性；也适用于直接粘贴函数或模块，要求简化、清理或减少嵌套而无需其他改动的请求。 |
 | [i3-constraint-driven-development](skills/i3-constraint-driven-development/SKILL.md) | 把项目质量标准写入 CONSTRAINTS.md 并落实为约束。适用于制定无障碍、性能、覆盖率等门槛，选择合理默认值，防止跳过测试、削弱断言、压低阈值、屏蔽错误或以空实现通过检查。 |
 | [i3-context-engineering](skills/i3-context-engineering/SKILL.md) | 优化代理上下文与项目规则。适用于新会话、输出质量下降、任务切换，以及配置项目规则文件、上下文和提示。 |
 | [i3-debugging-and-error-recovery](skills/i3-debugging-and-error-recovery/SKILL.md) | 系统复现故障、定位根因并验证修复。适用于测试失败、构建损坏、运行崩溃、功能回归、异常报错或行为不符合预期。 |
@@ -247,7 +253,6 @@ ui-ux-pro-max 2.15.0 与 antDv 官方 Skill／CLI（默认 0.0.0-beta.6 固定
 | [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) | 发现并调用合适的工程技能。适用于开始会话、判断任务意图、选择技能或工作流；作为元技能协调其他技能的发现和调用。 |
 
 ## Agent 角色
@@ -273,4 +278,5 @@ npx @givolt/i3-composer-agent --codebuddy --dir /path/to/plugin --force
 Codex 通过 `$i3-spec-driven-development` 等技能名调用；其原生 `/plan` 是宿主计划模式。
 中文语言策略、工程方法、审批要求与工具限制在各入口独立生效。
 
-原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。
+
+原型实例默认位于 `prototypes/<id>/`，来源、设计、QA和接续资料随实例保存。已有业务原型、旧索引和历史资料不自动改名、搬迁或删除；本次采用内容由PRD／AD的准确引用确定。已有用户配置若仍调用已删除的定制原型 Hook，需自行检查并移除相应注册；安装器不提供清理或改写配置的入口。

package/bin/i3-composer-agent.cjs

@@ -21,10 +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} 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
-  npx ${pkg.name} hooks list --host codebuddy --scope project --project <project>
   npx ${pkg.name} --prepare --claude --dir <directory>
   npx ${pkg.name} --extract --dir <directory>
 
@@ -36,13 +32,6 @@ ${pkg.name}
   --claude           预选 Claude Code
   --scope <scope>    project 项目 / global 全局（也可 --global / --local）
   --project-dir <dir> 项目安装根目录，默认当前目录
-  --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> 退役兼容参数：check / disable / keep；enable 不再支持
-  --codebuddy-product <form> 旧版 ide / cli 参数兼容；新注册默认 auto 自动识别
-  --codebuddy-transcript-root <dir|auto> 默认自动识别；可选手动原生日志限制，auto 切回自动
-  --codebuddy-version <version> 实际宿主版本，便于核验记录
   --yes              确认明确指定的非交互安装
   --list-agents      列出全部支持的工具目录
   --prepare          另行导出插件目录并显示宿主注册步骤
@@ -61,7 +50,7 @@ CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
 所有工具默认安装单份 skills、commands、agents；配套资料集中在 i3-composer-agent/。
 评测、脚本和 Hook 读取同一份已安装技能。--prepare 用于另行导出标准插件并按宿主方式注册。
 WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
-原型审计 Hooks 不再注册；升级仅清理本包旧注册，其他设置保留。
+安装器不注册或修改 Hook 设置；原版 Hook 脚本随包提供，按宿主原有方式使用。
 --prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
@@ -166,15 +155,6 @@ function prepare() {
 async function main() {
   if (args.includes('--help') || (!args.length && !process.stdin.isTTY)) { console.log(help); return; }
   if (args.length === 1 && args[0] === '--version') { console.log(pkg.version); return; }
-  if (args[0] === 'prototype-deps') {
-    const dependencies = require('../skills/i3-ui-prototype/scripts/prototype-dependencies.cjs');
-    const result=await dependencies.main(args.slice(1));console.log(JSON.stringify(result, null, 2));if(result.status==='failed')process.exitCode=1;
-    return;
-  }
-  if (['hooks','prototype-hooks'].includes(args[0])) {
-    const result=require('../hooks/manage.cjs').main([...args.slice(1),...(args[0]==='prototype-hooks'?['--groups','prototype']:[])]);
-    console.log(JSON.stringify(result,null,2));if(result.status==='failed')process.exitCode=1;return;
-  }
   if (args.some(arg => ['--extract', '--prepare', '--dir'].includes(arg))) { prepare(); return; }
   const installer = require('./install.cjs');
   if (args.length === 1 && args[0] === '--list-agents') {
@@ -185,21 +165,11 @@ async function main() {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (['--codebuddy', '--workbuddy', '--codex', '--claude'].includes(arg)) options.agents.push(arg.slice(2));
-    else if (['--agents', '--scope', '--project-dir', '--prototype-skills','--prototype-hooks','--hooks','--hook-groups','--codebuddy-skill-routing','--codebuddy-product','--codebuddy-transcript-root','--codebuddy-version'].includes(arg)) {
+    else if (['--agents', '--scope', '--project-dir'].includes(arg)) {
       if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error(`${arg} 需要指定值。`);
       const value = args[++i];
       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') {
-        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;}
-      else if (arg === '--hook-groups') {require('../hooks/manage.cjs').selection(value);options.hookGroups=value;}
-      else if (arg === '--codebuddy-skill-routing') {if(!['native','hook'].includes(value))throw new Error('请选择 native 或 hook');options.codebuddySkillRouting=value;}
-      else if (arg === '--codebuddy-product') {if(!['auto','ide','cli'].includes(value))throw new Error('CodeBuddy 形态请选择 auto、ide 或 cli');options.codebuddyProduct=value;}
-      else if (arg === '--codebuddy-transcript-root') options.codebuddyTranscriptRoot=value==='auto'?'auto':path.resolve(value);
-      else if (arg === '--codebuddy-version') options.codebuddyVersion=value;
       else options.projectDir = path.resolve(value);
     } else if (arg === '--global' || arg === '--local') {
       const scope = arg === '--global' ? 'global' : 'project';
@@ -208,18 +178,9 @@ async function main() {
     } else if (arg === '--yes') options.yes = true;
     else if (arg === '--force') options.force = true;
     else if (arg === '--dry-run') options.dryRun = true;
-    else if (arg === '--migrate-tools') options.migrateTools = true;
     else throw new Error(`未知选项： ${arg}`);
   }
   options.agents = installer.selectAgents(options.agents);
-  if(options.prototypeHooks!==undefined&&(options.hooks!==undefined||options.hookGroups!==undefined))throw new Error('--prototype-hooks 旧参数不可与 --hooks / --hook-groups 混用');
-  const hookOptions=(host=options.agents.find(id=>['codebuddy','workbuddy'].includes(id))||'codebuddy')=>({action:options.hooks||options.prototypeHooks||'default',groups:options.hookGroups||(options.prototypeHooks!==undefined?'prototype':undefined),skillRouting:options.codebuddySkillRouting,host,scope:options.scope,project:options.projectDir,product:options.codebuddyProduct,transcriptRoot:options.codebuddyTranscriptRoot,productVersion:options.codebuddyVersion,agents:options.agents});
-  if(['list','check','disable'].includes(hookOptions().action)) {
-    if(options.agents.length!==1||!['codebuddy','workbuddy'].includes(options.agents[0])||!options.scope)throw new Error('Hooks check / disable 需明确一个 Buddy 宿主和 --scope project|global，不执行安装');
-    const manager=require('../hooks/manage.cjs');
-    const result=['list','check'].includes(hookOptions().action)?manager.check(hookOptions()):manager.configure({...hookOptions(),preview:!!options.dryRun});
-    console.log(JSON.stringify(result,null,2));if(result.status==='failed')process.exitCode=1;return;
-  }
   if (process.stdin.isTTY && process.stdout.isTTY && !options.yes && !options.dryRun) {
     const selection = await require('./wizard.cjs').choose(options, identity);
     if (!selection) { console.log('安装已取消，未修改文件。'); return; }
@@ -227,12 +188,6 @@ 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) 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');
-  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 => {
@@ -241,7 +196,7 @@ async function main() {
   }));
   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,
-      requiredDependencies: required.map(item => item.detection),...(hookChanges.length?{hooks:hookSummary}:{}) }, null, 2));
+      requiredDependencies: required.map(item => item.detection) }, null, 2));
     return;
   }
   for (const item of required) {
@@ -249,21 +204,11 @@ async function main() {
     dependencies.assertPreparable(item.detection);
   }
   if (!options.yes) {
-    const confirmed = await require('./wizard.cjs').confirm(plan, { hooks: hookChanges.length?hookSummary:null });
+    const confirmed = await require('./wizard.cjs').confirm(plan);
     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 {
-      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}`);
-    }
-  }
   try {
     // Shared native folders reuse the first successful preparation. Each
     // selected host still has to discover and validate its own dependencies.

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, sopResource } = require('./native-migration.cjs');
+const { migrationAssets, pruneRetiredDirectories, ownsAsset, sopResource, assertRetirementSafe } = require('./native-migration.cjs');
 const { fingerprint } = require('./asset-fingerprint.cjs');
 const root = path.resolve(__dirname, '..');
 const name = 'i3-composer-agent';
@@ -52,7 +52,7 @@ function checkDestination(file) {
 function assetPath(base, file) { return path.relative(base, file).split(path.sep).join('/'); }
 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' },
+    capabilities: { nativeCommands: !!asset.target.nativeCommands, nativeAgents: !!asset.target.nativeCommands, hooks: '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)])),
@@ -101,7 +101,6 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
     const additions = nativeAssets(root, target, pluginFiles, version);
     const current = new Set(additions.map(asset => asset.relative));
     assets.push(...additions, ...migrationAssets(target, owned ? previous : undefined, current));
-    target.retiredEntryRuleAbsent = target.agents.includes('codebuddy') && !exists(path.join(target.base, 'rules/i3-prototype-entry.md'));
     for (const asset of additions) {
       // A new grouped resource must not take ownership of an unrelated file,
       // even when --force confirms replacement of a previous installation.
@@ -146,6 +145,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
 }
 function executeInstallation(plan, { force = false } = {}) {
   if (plan.conflicts.length && !force) throw new Error('已有安装内容需要确认或使用 --force 才能替换。');
+  assertRetirementSafe(plan.assets, plan.targets);
   const contexts = new Map();
   const createdDirectories = [];
   const committed = [];
@@ -157,14 +157,7 @@ function executeInstallation(plan, { force = false } = {}) {
     fs.mkdirSync(directory);
     createdDirectories.push(directory);
   }
-  function checkRetiredEntryRules() {
-    for (const target of plan.targets) {
-      const file = path.join(target.base, 'rules/i3-prototype-entry.md');
-      if (target.retiredEntryRuleAbsent && exists(file)) throw new Error(`安装期间出现未归属的旧原型入口，保留文件并停止安装：${file}`);
-    }
-  }
   try {
-    checkRetiredEntryRules();
     // Stage every target before replacing the first installed asset.
     for (const [index, asset] of plan.assets.entries()) {
       if (!contexts.has(asset.base)) {
@@ -183,6 +176,7 @@ function executeInstallation(plan, { force = false } = {}) {
         fs.chmodSync(asset.staged, fs.statSync(asset.source).mode & 0o777);
       }
     }
+    assertRetirementSafe(plan.assets, plan.targets);
     for (const asset of plan.assets) {
       const context = contexts.get(asset.base);
       if (destination(asset.destination) !== asset.destination) throw new Error(`安装期间目录变成符号链接（symlink）：${asset.destination}`);
@@ -194,7 +188,7 @@ 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) {
-        const label = sopResource(asset.relative) || /references\/(?:enterprise-sop-resources|engineering-skeleton-resources)\//.test(asset.relative) ? '旧SOP资料' : '旧原型入口';
+        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) {
@@ -222,7 +216,7 @@ function executeInstallation(plan, { force = false } = {}) {
         change.written = true;
       }
     }
-    checkRetiredEntryRules();
+    assertRetirementSafe(plan.assets, plan.targets);
     pruneRetiredDirectories(plan.assets);
     completed = true;
     const ownedPaths = new Set(plan.assets.filter(asset => asset.kind !== 'legacy').map(asset => asset.destination));
@@ -238,8 +232,6 @@ function executeInstallation(plan, { force = false } = {}) {
     for (const target of plan.targets) {
       findUserFiles(path.join(target.base, name));
       for (const category of ['references', 'evals', 'hooks', 'scripts', 'docs']) findUserFiles(path.join(target.base, category, name));
-      const userPrototypeAgent = path.join(target.base, 'agents', 'prototype-specialist.md');
-      if (exists(userPrototypeAgent) && !ownedPaths.has(userPrototypeAgent)) plan.preserved.push(userPrototypeAgent);
     }
     return [];
   } catch (error) {

package/bin/native-layout.cjs

@@ -24,6 +24,14 @@ function nativeScript(text, relative) {
     return replaceOnce(text, 'const REFERENCE = path.join(', setup + '\nconst REFERENCE = path.join(', relative)
       .replace("__dirname, '..', 'skills',", "(INSTALLATION ? INSTALLATION.root : path.resolve(__dirname, '..')), 'skills',");
   }
+  if (relative === 'scripts/run-evals-test.js') {
+    // The upstream sandbox copies its own libraries, including execution-status.
+    // Native ownership belongs to the real toolkit, never to this test fixture.
+    return replaceOnce(text,
+      "fs.cpSync(path.join(__dirname, 'lib'), path.join(root, 'scripts', 'lib'), { recursive: true });",
+      "fs.cpSync(path.join(__dirname, 'lib'), path.join(root, 'scripts', 'lib'), { recursive: true, filter: file => path.basename(file) !== 'installation.js' });",
+      relative);
+  }
   if (/-test\.js$/.test(relative)) return text;
   if (relative === 'scripts/validate-skills.js') {
     text = replaceOnce(text, "const SKILLS_DIR = path.resolve(__dirname, '..', 'skills');", setup + "\nconst SKILLS_DIR = INSTALLATION ? INSTALLATION.skillsDirectory : path.resolve(__dirname, '..', 'skills');", relative);
@@ -79,7 +87,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/` 保留其他命令格式和插件清单，供原版一致性校验与回归测试使用，不自动注册或启用插件。原版 Hook 脚本及说明随包保留，按宿主原有方式配置；安装器不自动注册、清理或修改用户 Hook 设置。缓存与代码块保护分别详见 [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') {
@@ -96,7 +104,8 @@ function renderAsset(buffer, asset) {
   if (!relative.endsWith('.md')) return buffer;
   if (['skill', 'command', 'persona', 'reference'].includes(asset.kind)) text = nativeContent(text, asset);
   if (asset.kind === 'skill') {
-    text = text.replace(/^bash (skills\/[a-z0-9-]+\/scripts\/[a-z0-9.-]+\.sh)$/gm, (command, source) => {
+    text = text.replace(/^bash (?:<skill-dir>\/(scripts\/[a-z0-9.-]+\.sh)|(skills\/[a-z0-9-]+\/scripts\/[a-z0-9.-]+\.sh))$/gm, (command, localScript, repositoryScript) => {
+      const source = repositoryScript || path.posix.join(path.posix.dirname(relative), localScript);
       const mapped = asset.mapping?.[source];
       if (!mapped) throw new Error(`技能引用了未安装的脚本：${source}`);
       const file = path.join(asset.base, mapped).replaceAll('\\', '/');