@givolt/i3-composer-agent 2.3.1 → 2.3.3

package/.agents/plugins/marketplace.json

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

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

@@ -1,6 +1,6 @@
 ---
-description: "选择模板并生成、评审和迭代交互原型，维护已确认的 UI 基线。"
-# i3-description-source: "description: Create, review and iterate interactive UI prototypes with template selection and approved baselines"
+description: "在主会话中分析、创建、检查与迭代 UI 交互原型。"
+# i3-description-source: "description: Create, analyze, inspect and iterate UI prototypes in the main session"
 ---
 
 <!-- i3:zh-CN:start -->
@@ -11,13 +11,11 @@ description: "选择模板并生成、评审和迭代交互原型，维护已确
 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 基线。
+适用说明：在主会话中分析、创建、检查与迭代 UI 交互原型。
 <!-- i3:zh-CN:end -->
 
-Invoke the i3-ui-prototype skill.
+Use the i3-ui-prototype skill in the main session for the user's request below. Follow its shared preflight, operation boundaries and applicable runtime workflow.
 
 $ARGUMENTS
 
-With no arguments, use create. Supported operations: create, revise, inspect, confirm-baseline.
-Default to professional enhancement mode. Detect UI/UX Pro Max in the current host; if unavailable, offer installation or explicit template mode. Never silently downgrade.
-Use the skill workflow for template selection, business mapping, professional advice, real browser verification and version-specific human confirmation. Preserve approved snapshots during iteration.
+With no arguments use create; explicit analysis or read-only limits take precedence. Preserve the user's scope, manual edits, fixed inputs and approved baselines. Use supporting engineering, framework, design and browser skills as the working skill requires; keep its workflow and evidence requirements there.

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

package/.codex-plugin/plugin.json

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

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

@@ -1,5 +1,5 @@
-description = "选择模板并生成、评审和迭代交互原型，维护已确认的 UI 基线。"
-# i3-description-source: "description = \"Create, review and iterate interactive UI prototypes with template selection and approved baselines\""
+description = "在主会话中分析、创建、检查与迭代 UI 交互原型。"
+# i3-description-source: "description = \"Create, analyze, inspect and iterate UI prototypes in the main session\""
 
 prompt = """
 <!-- i3:zh-CN:start -->
@@ -10,14 +10,12 @@ 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 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
 
-适用说明：选择模板并生成、评审和迭代交互原型，维护已确认的 UI 基线。
+适用说明：在主会话中分析、创建、检查与迭代 UI 交互原型。
 <!-- i3:zh-CN:end -->
 
-Invoke the i3-ui-prototype skill.
+Use the i3-ui-prototype skill in the main session for the user's request below. Follow its shared preflight, operation boundaries and applicable runtime workflow.
 
 $ARGUMENTS
 
-With no arguments, use create. Supported operations: create, revise, inspect, confirm-baseline.
-Default to professional enhancement mode. Detect UI/UX Pro Max in the current host; if unavailable, offer installation or explicit template mode. Never silently downgrade.
-Use the skill workflow for template selection, business mapping, professional advice, real browser verification and version-specific human confirmation. Preserve approved snapshots during iteration.
+With no arguments use create; explicit analysis or read-only limits take precedence. Preserve the user's scope, manual edits, fixed inputs and approved baselines. Use supporting engineering, framework, design and browser skills as the working skill requires; keep its workflow and evidence requirements there.
 """

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v2.3.1
+# i3 Composer Agent v2.3.3
 
 **Intelligence. Integration. Innovation.**
 
@@ -25,6 +25,8 @@ WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；
 搜索、翻页和命令参数预选均保留选择。搜索外 `q`、Esc 或 Ctrl-C 取消。
 确认工具后选择项目/全局范围并确认安装。
 
+可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。CodeBuddy 的安装范围、Hooks、启用组、IDE／CLI、路由、UIUX／antDv 及最终确认均支持数字选择。新范围推荐启用 Hooks，已有安装默认保留现状；升级时要启用 Hooks 请明确选“启用”。UIUX／antDv 可选择安装两项、单项或跳过，之后也可补装。
+
 全部目标均安装 26 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
 全部目标同时提供 10 个命令和 4 个 Agent 角色提示。
 CodeBuddy、WorkBuddy、Claude Code 使用原生命令入口；其他工具通过 Skills 机制使用，
@@ -161,7 +163,7 @@ 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-prototype | 在主会话中分析、创建、检查与迭代 UI 交互原型。 |
 | /i3-composer-agent:i3-review | 从正确性、可读性、架构、安全和性能五个维度审查代码。 |
 | /i3-composer-agent:i3-ship | 并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。 |
 | /i3-composer-agent:i3-spec | 先编写结构化规格、目标、范围与验收标准，再进入实现。 |
@@ -176,10 +178,15 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 由主会话汇总 GO/NO-GO 决策，回滚计划必需。代码审查使用 Critical、Required、Optional、Nit
 四级；Critical 和 Required 问题默认阻止发布，各专业角色仍保留自己的报告字段和判断规则。
 
-`/i3-prototype` 调用 `i3-ui-prototype` 技能，支持先选模板，再按业务需求生成原型。默认采用专业增强模式，
-UI/UX Pro Max 是需要单独安装的外部设计能力，不计入本包的技能数量；未安装时提示安装，
-用户也可明确选择模板模式继续。企业后台模板可用于人工测试，AI 工作台、数字孪生大屏和
-移动端模板仍在规划中。原型验收、后续迭代约束与项目需求需要单独确认；本包尚未实现企业 SOP 自动编排。
+`/i3-prototype` 在主会话调用 `i3-ui-prototype` 技能，按需求使用前端与浏览器技能完成原型。
+完整企业后台 HTML 内容模板可双击 index.html 离线查看与修改；生成的 Vue 3＋antDv-next 工程
+使用真实组件，支持明亮、暗黑、清新、科技四主题，默认明亮。已有原型按原合同继续使用。
+模板在 Skill 源码中维护并随版本发布，生成时只读引用；业务直接修改原型工程，不默认创建项目 ui-templates。
+UI/UX Pro Max 与 antDv 官方 Skill 可通过 `--prototype-skills uiux,antdv` 明确选择安装，
+也可稍后检测／补装；工具随所选宿主和范围存入 `tools/i3-prototype/`，旧路径继续兼容。
+默认采用专业增强模式，UIUX 不可用时提示修复或由用户明确选择模板模式继续。
+两项外部能力不计入本包技能数量。AI 工作台、数字孪生大屏和移动端模板仍在规划中。
+每个生成原型仍需独立的交互验收和用户评审；本包尚未实现企业 SOP 自动编排。
 
 ## Skills
 
@@ -209,7 +216,7 @@ UI/UX Pro Max 是需要单独安装的外部设计能力，不计入本包的技
 | [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-prototype](skills/i3-ui-prototype/SKILL.md) | 根据业务需求选择 UI 模板，生成、评审并迭代交互原型。适用于选择原型模板、制作可操作审查原型、检查原型一致性及维护已确认的原型基线。 |
+| [i3-ui-prototype](skills/i3-ui-prototype/SKILL.md) | 将 HTML 内容模板、业务需求与目标组件框架组合为可操作 UI 原型。适用于原型分析、原型候选生成、原型交互验证和已确认原型基线维护；生产页面实现使用工程流程。 |
 | [i3-using-agent-skills](skills/i3-using-agent-skills/SKILL.md) | 发现并调用合适的工程技能。适用于开始会话、判断任务意图、选择技能或工作流；作为元技能协调其他技能的发现和调用。 |
 
 ## Agent 角色
@@ -234,3 +241,5 @@ npx @givolt/i3-composer-agent --codebuddy --dir /path/to/plugin --force
 仓库维护用的 AGENTS.md、CLAUDE.md 不复制进业务项目。
 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。

package/bin/agent-targets.json

@@ -8,8 +8,10 @@
       "label": "CodeBuddy",
       "projectSkillsDir": ".codebuddy/skills",
       "globalSkillsDir": {
-        "base": "home",
-        "path": ".codebuddy/skills"
+        "base": "env",
+        "env": "CODEBUDDY_CONFIG_DIR",
+        "fallback": ".codebuddy",
+        "path": "skills"
       }
     },
     {

package/bin/i3-composer-agent.cjs

@@ -21,6 +21,10 @@ ${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 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>
 
@@ -32,6 +36,15 @@ ${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>    CodeBuddy 统一 Hooks：keep（非交互默认）/ enable / list / check / disable
+  --hook-groups <ids> session-start,sdd-cache,simplify-ignore,prototype 或 all；启停默认 prototype
+  --codebuddy-skill-routing <mode> hook（明确需要会话注入）/ native（已有原生路由）
+  --prototype-hooks <action> 旧参数保留，仅管理 prototype 组
+  --codebuddy-product <form> 启用时明确 ide 或 cli；CLI 注册后需在 /hooks 审核
+  --codebuddy-transcript-root <dir|auto> 默认自动识别；可选手动原生日志限制，auto 切回自动
+  --codebuddy-version <version> 实际宿主版本，便于核验记录
   --yes              确认明确指定的非交互安装
   --list-agents      列出全部支持的工具目录
   --prepare          另行导出插件目录并显示宿主注册步骤
@@ -43,13 +56,14 @@ ${pkg.name}
   --help             显示帮助
 
 终端向导先显示常用工具，WorkBuddy 在第 2 项；选择“更多”可分页/搜索全部工具。
-上下键移动/跨页，空格勾选/取消，回车确认；列表下实时显示已选，q/Esc 退出。
+输入工具编号（如 1,2）后回车，或上下键移动/跨页、空格勾选、回车确认；q/Esc 退出。
+范围、Hooks、IDE/CLI、可选原型依赖和最终确认使用数字选择，Hook 组支持逗号分隔数字多选。
 CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
 其他工具通过 Skills 调用，短命令支持取决于宿主。
 所有工具默认安装单份 skills、commands、agents；配套资料集中在 i3-composer-agent/。
 评测、脚本和 Hook 读取同一份已安装技能。--prepare 用于另行导出标准插件并按宿主方式注册。
 WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
-评测需主动运行；Hook 文件已提供，需按宿主事件协议单独启用。
+评测需主动运行；向导可注册 CodeBuddy Hooks，实际生效仍需宿主审核/重载和回调验证。
 --prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
@@ -154,6 +168,15 @@ 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');
+    console.log(JSON.stringify(await dependencies.main(args.slice(1)), null, 2));
+    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') {
@@ -164,11 +187,22 @@ 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'].includes(arg)) {
+    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)) {
       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') {
+        require('../skills/i3-ui-prototype/scripts/optional-skill-install.cjs').selection(value);
+        options.prototypeSkills = value;
+      }
+      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(!['ide','cli'].includes(value))throw new Error('CodeBuddy 形态请选择 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';
@@ -177,9 +211,18 @@ 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=()=>({action:options.hooks||options.prototypeHooks||'keep',groups:options.hookGroups||(options.prototypeHooks!==undefined?'prototype':undefined),skillRouting:options.codebuddySkillRouting,host:'codebuddy',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||options.agents[0]!=='codebuddy'||!options.scope)throw new Error('Hooks check / disable 需明确 --codebuddy --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; }
@@ -187,17 +230,26 @@ 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(hookOptions().action!=='keep'&&!options.agents.includes('codebuddy'))throw new Error('首期统一 Hooks 仅适配 CodeBuddy');
+  const hookManager=require('../hooks/manage.cjs');
+  const hookChange=options.agents.includes('codebuddy')?hookManager.prepare(hookOptions()):null;
   const plan = installer.planInstallation(options);
   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 }, null, 2));
+    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 } : {}),...(hookChange?{hooks:hookChange.summary}:{}) }, null, 2));
     return;
   }
   if (!options.yes) {
-    const confirmed = await require('./wizard.cjs').confirm(plan);
+    const confirmed = await require('./wizard.cjs').confirm(plan, { prototypeSkills: options.prototypeSkills, hooks: hookChange?.summary });
     if (!confirmed) { console.log('安装已取消，未修改文件。'); return; }
     options.force = plan.conflicts.length > 0;
   }
   installer.executeInstallation(plan, { force: options.force });
+  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) {
@@ -207,11 +259,26 @@ async function main() {
     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(`Hook：${target.hooksDirectory}（尚未启用）`);
+    console.log(`Hooks：${target.hooksDirectory}${target.agents.includes('codebuddy')?'；统一检查：node "'+path.join(target.hooksDirectory,'manage.cjs')+'" check --host codebuddy --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；Hook 需按宿主事件协议启用。');
+  console.log('核心安装完成。评测说明见 i3-composer-agent/evals/README.md。');
+  if (hookChange) console.log(hookChange.summary.action === 'enable' ? `Hooks 已注册：${hookChange.summary.enabledGroups.join('、')}。${hookChange.summary.product === 'cli' ? '请在 CodeBuddy Code /hooks 审核并开启新会话。' : '请重载 CodeBuddy 窗口。'}实际触发另行检查。` : '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}`);
+    }
+  } else {
+    console.log('UIUX / antDv 独立依赖未自动安装。可随时用 prototype-deps check 检测，或 prototype-deps install --skills uiux,antdv 按需准备。');
+  }
 }
 main().catch(error => { console.error(`${name}: ${error.message}`); process.exitCode = 1; });

package/bin/install.cjs

@@ -29,6 +29,7 @@ function globalSkillsDir(agent, home, env) {
   let base = home;
   if (config.base === 'config') base = env.XDG_CONFIG_HOME && path.isAbsolute(env.XDG_CONFIG_HOME) ? env.XDG_CONFIG_HOME : path.join(home, '.config');
   if (config.base === 'env') base = env[config.env]?.trim() || path.join(home, config.fallback);
+  if (config.env === 'CODEBUDDY_CONFIG_DIR' && (!path.isAbsolute(base) || /[\x00\r\n]/.test(base))) throw new Error('CODEBUDDY_CONFIG_DIR must be an absolute safe directory');
   if (config.alternatives && !fs.existsSync(path.join(home, path.dirname(config.path)))) {
     const alternative = config.alternatives.find(relative => fs.existsSync(path.join(home, path.dirname(relative))));
     if (alternative) return path.join(home, alternative);
@@ -51,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: 'manual' },
+    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,
     assets: plan.assets.filter(item => item.base === asset.base && !['legacy', 'result'].includes(item.kind)).map(item => assetPath(asset.base, item.destination)) }, null, 2) + '\n';
 }
@@ -98,6 +99,7 @@ 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.
@@ -147,7 +149,14 @@ 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)) {
@@ -176,6 +185,9 @@ 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}`);
+      }
       if (asset.reusable) {
         const unchanged = fingerprint(asset.destination) === asset.expectedFingerprint
           && fingerprint(asset.staged) === asset.expectedFingerprint;
@@ -198,6 +210,7 @@ function executeInstallation(plan, { force = false } = {}) {
         change.written = true;
       }
     }
+    checkRetiredEntryRules();
     pruneRetiredDirectories(plan.assets);
     completed = true;
     const ownedPaths = new Set(plan.assets.filter(asset => asset.kind !== 'legacy').map(asset => asset.destination));
@@ -213,6 +226,8 @@ 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

@@ -78,7 +78,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/` 保留其他命令格式和插件清单，供原版一致性校验与回归测试使用，不自动注册或启用插件。Hook 需按宿主支持的事件单独启用；缓存与代码块保护分别详见 [hooks/SDD-CACHE.md](hooks/SDD-CACHE.md) 和 [hooks/SIMPLIFY-IGNORE.md](hooks/SIMPLIFY-IGNORE.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,13 @@ const { fingerprint } = require('./asset-fingerprint.cjs');
 const inventory = require('./legacy-native-files.json').files;
 const name = 'i3-composer-agent';
 const publishedFiles = new Set(inventory);
+// 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.
+const retiredPrototypeAssets = {
+  'rules/i3-prototype-entry.md': '1c89ad58619968e1826cab31b9f6de29ac04d5fc5b8b1c2a2e1a1b64ec9449af',
+  'agents/prototype-specialist.md': '4d1aa1c6c913694e8a1c7d3373245377899f9cf3f08ec410b40814fa7cda541f',
+};
 
 function ownsAsset(previous, relative) {
   return previous.assets.some(file => file === relative
@@ -15,7 +22,8 @@ function ownsAsset(previous, relative) {
 function allowed(relative) {
   return typeof relative === 'string' && !relative.includes('\0') && !relative.includes(':') && !relative.includes('\\')
     && !relative.split('/').some(part => ['', '.', '..'].includes(part))
-    && (/^(skills|commands|agents|references|evals|hooks|scripts|docs)\//.test(relative)
+    && (relative === 'rules/i3-prototype-entry.md'
+      || /^(skills|commands|agents|references|evals|hooks|scripts|docs)\//.test(relative)
       || relative.startsWith(`${name}/`) || [`${name}-LICENSE`, `${name}-NOTICE.md`].includes(relative));
 }
 
@@ -31,17 +39,33 @@ function fileAt(base, relative) {
 }
 
 function migrationAssets(target, previous, current) {
-  if (!previous) return [];
   const assets = [];
   const oldFiles = new Set();
   const retired = new Set();
   const base = target.base;
+  for (const [relative, expectedFingerprint] of Object.entries(retiredPrototypeAssets)) {
+    if (current.has(relative)) continue;
+    const file = fileAt(base, relative);
+    let present;
+    try { present = fs.lstatSync(path.join(base, relative)); }
+    catch (error) { if (error.code === 'ENOENT') continue; throw error; }
+    const owned = previous?.assets.includes(relative);
+    // Keep the existing protection for unowned CodeBuddy rules. A user-created
+    // Agent with this name is outside our catalog and must not be claimed.
+    if (!owned && relative.startsWith('agents/')) continue;
+    if (!owned && !target.agents?.includes('codebuddy')) continue;
+    if (!owned || !file || !present.isFile() || fingerprint(file) !== expectedFingerprint) {
+      throw new Error(`保留了已修改、未知或未归属本包的旧原型入口，不能自动退出；请先检查并手动处理后重试：${path.join(base, relative)}`);
+    }
+  }
+  if (!previous) return [];
   function retire(relative) {
     if (retired.has(relative) || current.has(relative)) return;
     const file = fileAt(base, relative);
     if (!file || !fs.statSync(file).isFile()) return;
     retired.add(relative);
-    assets.push({ base, destination: file, relative, kind: 'legacy' });
+    assets.push({ base, destination: file, relative, kind: 'legacy',
+      ...(retiredPrototypeAssets[relative] ? { retiredFingerprint: retiredPrototypeAssets[relative] } : {}) });
   }
   for (const relative of previous.assets) {
     const file = fileAt(base, relative);

package/bin/tool-selector.cjs

@@ -42,7 +42,7 @@ function wrap(text, columns) {
 function selectTools(initialSelection, input = process.stdin, output = process.stdout) {
   const selected = new Set(initialSelection);
   let view = 'common', cursor = 0, commonCursor = 0, query = '', searching = false, message = '';
-  let frame = [], pageSize = 10, finished = false;
+  let frame = [], pageSize = 10, finished = false, numberInput = '';
   const wasRaw = Boolean(input.isRaw), wasFlowing = input.readableFlowing;
   const choices = () => view === 'common' ? [...orderedAgents.slice(0, commonIds.length), null]
     : view === 'more' ? orderedAgents.slice(commonIds.length)
@@ -71,8 +71,8 @@ function selectTools(initialSelection, input = process.stdin, output = process.s
     }
     const hints = searching
       ? ['输入关键词实时搜索', 'Enter/↓ 浏览结果 · Esc返回 · Ctrl-C取消']
-      : ['↑↓ 移动/跨页 · 空格勾选 · Enter确认', 'm 更多 · / 搜索 · b/← 返回 · q/Esc取消'];
-    const footer = ['', ...summary, ...hints.flatMap(line => wrap(line, columns)), message];
+      : ['数字+Enter指定工具 · ↑↓/空格勾选', 'm 更多 · / 搜索 · b/← 返回 · q/Esc取消'];
+    const footer = ['', ...summary, ...hints.flatMap(line => wrap(line, columns)), numberInput ? `编号：${numberInput}（逗号多选，Enter确认）` : message];
     const searchLine = view === 'search' ? [`搜索：${query}${searching ? '|' : ''}`] : [];
     pageSize = Math.max(1, Math.min(10, rows - footer.length - searchLine.length - 2));
     const page = Math.floor(cursor / pageSize), pages = Math.max(1, Math.ceil(entries.length / pageSize));
@@ -130,19 +130,36 @@ function selectTools(initialSelection, input = process.stdin, output = process.s
           if (view === 'search') back(); else { cancel(); return; }
         } else if (text === 'q') { cancel(); return; }
         else if (['return', 'enter'].includes(key.name)) {
+          if (numberInput) {
+            if (numberInput === '0') { cancel(); return; }
+            const numbers = numberInput.split(/[,，]/).map(Number);
+            if (numbers.every(number => Number.isInteger(number) && number >= 1 && number <= orderedAgents.length)) {
+              selected.clear();
+              for (const number of numbers) selected.add(orderedAgents[number - 1].id);
+              finish([...selected]); return;
+            }
+            numberInput = ''; message = `请输入 1–${orderedAgents.length} 的编号（逗号多选），0 取消。`;
+            render(); return;
+          }
           if (selected.size) { finish([...selected]); return; }
-          message = '请至少用空格选择一个工具。';
+          message = '请用数字编号或空格选择工具，再按 Enter。';
+        } else if (text && /^[0-9,，]$/.test(text)) {
+          if (numberInput.length < 255) numberInput += text;
+        } else if (key.name === 'backspace') {
+          numberInput = numberInput.slice(0, -1);
         } else if (key.name === 'space' || text === ' ') {
+          if (numberInput) { render(); return; }
           const entry = choices()[cursor];
           if (entry) { if (selected.has(entry.id)) selected.delete(entry.id); else selected.add(entry.id); }
           else if (view === 'common') openMore();
         } else if (['up', 'down', 'pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text)) {
+          numberInput = '';
           const direction = ['up', 'pageup'].includes(key.name) || text === 'p' ? -1 : 1;
           const step = ['pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text) ? pageSize : 1;
           cursor = Math.max(0, Math.min(choices().length - 1, cursor + direction * step));
-        } else if (text === 'm' || (key.name === 'right' && view === 'common')) openMore();
-        else if (text === 'b' || key.name === 'left') back();
-        else if (text === '/') { if (view === 'common') commonCursor = cursor; view = 'search'; query = ''; cursor = 0; searching = true; }
+        } else if (text === 'm' || (key.name === 'right' && view === 'common')) { numberInput = ''; openMore(); }
+        else if (text === 'b' || key.name === 'left') { numberInput = ''; back(); }
+        else if (text === '/') { numberInput = ''; if (view === 'common') commonCursor = cursor; view = 'search'; query = ''; cursor = 0; searching = true; }
         render();
       } catch (error) { fail(error); }
     }