@givolt/i3-composer-agent 2.3.0 → 2.3.2

package/.agents/plugins/marketplace.json

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

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "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.0
+# i3 Composer Agent v2.3.2
 
 **Intelligence. Integration. Innovation.**
 
@@ -161,7 +161,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 +176,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 +214,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 角色

package/bin/i3-composer-agent.cjs

@@ -21,6 +21,9 @@ ${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} --prepare --claude --dir <directory>
   npx ${pkg.name} --extract --dir <directory>
 
@@ -32,6 +35,8 @@ ${pkg.name}
   --claude           预选 Claude Code
   --scope <scope>    project 项目 / global 全局（也可 --global / --local）
   --project-dir <dir> 项目安装根目录，默认当前目录
+  --prototype-skills <ids> 可选原型依赖：none（默认）、uiux、antdv、uiux,antdv；跟随所选宿主和范围
+  --migrate-tools     显式迁移有 i3 来源记录的旧独立 antDv 工具；仅项目范围且需选择 antdv
   --yes              确认明确指定的非交互安装
   --list-agents      列出全部支持的工具目录
   --prepare          另行导出插件目录并显示宿主注册步骤
@@ -154,6 +159,11 @@ 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 (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 +174,15 @@ 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'].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 options.projectDir = path.resolve(value);
     } else if (arg === '--global' || arg === '--local') {
       const scope = arg === '--global' ? 'global' : 'project';
@@ -177,6 +191,7 @@ 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);
@@ -187,9 +202,11 @@ 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');
   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 } : {}) }, null, 2));
     return;
   }
   if (!options.yes) {
@@ -213,5 +230,19 @@ async function main() {
   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 需按宿主事件协议启用。');
+  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

@@ -98,6 +98,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 +148,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 +184,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 +209,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 +225,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-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/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/docs/codebuddy-setup.md

@@ -9,7 +9,7 @@ npx @givolt/i3-composer-agent --codebuddy
 ```
 
 向导预选 CodeBuddy，可增加其他工具，再选择项目或全局范围。
-项目安装提供 `.codebuddy/skills/`（26 个技能）、`references/`、
+项目安装提供 `.codebuddy/skills/`（26 个技能）、
 `commands/`（10 个命令）和 `agents/`（4 个角色）。
 同级 `i3-composer-agent/` 是配套工具根，集中提供 `package.json`、`evals/`、`hooks/`、`scripts/`、`docs/`、`references/` 和校验输入 `adapters/`，
 只有一份实际技能、命令和角色，评测与宿主共用。
@@ -25,9 +25,10 @@ npx @givolt/i3-composer-agent --codebuddy
 /i3-build auto
 /i3-review
 /i3-ship
+/i3-prototype
 ```
 
-命令直接调用安装的技能 ID，保留 `$ARGUMENTS`、原工程规则和审批边界。
+命令保留 `$ARGUMENTS`、原工程规则和审批边界。原型命令由主会话使用 `i3-ui-prototype`，其他命令沿用各自流程。
 发布命令按宿主能力并行审查或顺序降级，主会话汇总并提供回滚计划。
 
 ```bash
@@ -39,6 +40,68 @@ CodeBuddy 与 WorkBuddy 项目共用 `.codebuddy/`；同版本追加客户端会
 全局目录彼此独立。WorkBuddy 桌面版建议全局安装，详见 [WorkBuddy 说明](workbuddy-setup.md)。
 升级或同名冲突先查看 `--dry-run`，再确认或使用 `--yes --force`。
 
+## 原型官方依赖可选安装
+
+默认安装仅包含 i3 自身技能，UIUX Pro Max 与 antDv 官方 Skill 可不安装。CodeBuddy 项目安装可明确选择：
+
+```bash
+npx @givolt/i3-composer-agent --codebuddy --scope project --yes --prototype-skills uiux,antdv
+```
+
+值为 none、uiux、antdv 或 uiux,antdv；默认 none。可选工具跟随宿主和项目／全局范围，位于基址下 `tools/i3-prototype/`；旧项目 `.prototype-tools` 保持读取兼容。需要固定本次版本时使用 `npx @givolt/i3-composer-agent@2.3.2`。已安装后可随时单独检测／补装，无需重装 i3：
+
+```bash
+node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --host codebuddy --scope project --project .
+node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs install --host codebuddy --scope project --project . --skills uiux,antdv
+```
+
+检测只读，不下载安装。安装需要网络，固定官方版本并保留原名与来源，已有可用安装复用；已有不可用目录保留并提示修复，不自动覆盖、全局升级或安装 Python。UIUX 专业模式缺项时提示，用户明确选择基础模式后仍可生成并保留同样功能验收；antDv Skill 缺失可按官方版本资料渠道实施。后续安装不改变已有实例模式或旧验收，CodeBuddy 必要时重载窗口／新建会话。目录与检测通过不等于宿主实际调用。
+
+## 主会话原型流程与使用入口
+
+原型由主会话使用 `.codebuddy/skills/i3-ui-prototype/`，按同一方法完成需求理解、设计、制作、修订与验证。Skill 保存模板、能力、框架和验收规则；按任务需要复用前端工程方法、官方框架知识、UIUX Pro Max 和浏览器测试能力。HTML 是内容参考，生成结果采用真实框架组件。
+
+模板编辑、构建、证据登记和后续修改的完整命令见[首期使用与续接](ui-prototype-native/USAGE.md)。
+
+自然语言可以这样提出任务：
+
+> 根据资产清单需求，参考完整 enterprise-admin 内容模板，用 Vue 3＋antDv-next 生成交互原型。保留筛选、多选、分页和编辑抽屉，验证失败重试、开合动效和遮罩模糊。请使用 UIUX Pro Max 优化体验，交付待评审候选。
+
+或明确使用命令：
+
+```text
+/i3-prototype analyze 先检查需求与内容模板，不修改任何文件
+/i3-prototype create 参考完整 enterprise-admin 模板，用 Vue 3＋antDv-next 生成资产清单原型
+```
+
+自然语言、`/i3-prototype`、已加载的 `i3-using-agent-skills` 和直接使用 `i3-ui-prototype` 都进入同一主会话流程。`i3-using-agent-skills` 按普通技能发现选择工作 Skill；命令只提供快捷入口。普通安装不注册原型专责角色，也不安装常驻原型分派规则。命令菜单、Skill 被读取和真实执行分别验证；CodeBuddy IDE 与 CodeBuddy Code CLI 的证据不能互相替代。
+
+直接使用方法也是正式入口：说“请当前会话使用 i3-ui-prototype 技能，只读分析这个原型”。主会话交付自然语言分析、候选与真实证据，不以父子 Agent JSON 或回传标记为前置。只读分析不写入；原型基线认可需真实用户认可，后续工程仍按现有规格、计划和实现流程交接。
+
+升级只退出清单归属明确且内容匹配已知原型增量的旧角色和旧入口规则。旧入口经过用户修改或来源未知时保留原文件并停止安装，提示人工检查；`--force` 不绕过此保护。同名用户自建 Agent 保留并报告。这样可以在升级前明确处理仍可能生效的旧常驻规则。
+
+默认只读使用 Skill 内置模板，模板由维护者在 Skill 源码中修改并随包发布；业务项目不默认生成 ui-templates。生成的真实组件工程在 `prototypes/<id>/app/`，业务修改直接作用于该工程，生成依据固定在 inputs。已有模板副本仅在明确指定 --template-root 时复用并保留手工修改。按实际 PRD 固定页面、区域和适用能力；旧原型按原合同继续读取，不自动迁移。professional 默认使用真实 UIUX 查询；明确选择 template 时仍完成同样功能验收，不声称使用了 UIUX。
+
+框架官方 antdv Skill 是独立知识来源，按本次版本和授权接入，不随本包安装而自动全局安装或升级 CLI。首期固定库 1.5.3；已探测的 CLI 0.0.0-beta.1 没有该知识文件，显式回退查询 1.5.2 只能作参考，再核对 1.5.3 包内类型／源码。错误文本或退出码 0、仅打印 Parsed args 的 lint，均不能作为查询或验收通过。
+
+工具前置使用依赖检测返回的实际 Node 入口，也兼容已有 `.prototype-tools/node_modules` 布局或宿主明确的绝对入口；缺失时只读分析报告未决项，不以 npm exec／npx 下载或补缓存。工具准备须有明确选择，写范围仅指定工具目录，不含业务内容或 SDK。analyze 只交覆盖、选型、验收计划和缺口，不套用创建阶段的 UIUX 采纳、构建或浏览器门禁。
+
+本轮新原生流程还要求执行者真实调用 `i3-browser-testing-with-devtools` Skill，并使用 Chrome DevTools MCP 对当前构建取得 DOM／计算样式、截图、console、network、可访问性和性能观测。只读取 Skill 文件或运行 Playwright 脚本都不等于调用该 Skill；Playwright 保留为原型专项补充。缺可调用 Skill 或 MCP 时整链不 complete，按已授权范围准备宿主工具后再验；analyze 不启动或安装浏览器。具体工具接入以实际宿主暴露为准，不能从其他会话或维护 smoke 推断当前执行环境可用。旧实例按固定合同保留，其他宿主等效结果单列。
+
+新完整模板原生流程默认包含明亮、暗黑、清新、科技，首次默认明亮，菜单无编号；生成工程用原生框架主题，验证四预设、刷新记忆、实例隔离及业务状态保留。旧实例继续按原有固定合同，不隐式增加能力；步骤见首期指南。
+
+## 原型本地检查与预览
+
+以下使用项目安装路径，原型目录替换为实际值。首次构建允许安装依赖时使用 --install；后续复用依赖构建。预览命令持续运行并输出本地 URL。
+
+```bash
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs inspect prototypes/device-list
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs build prototypes/device-list --install
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs preview prototypes/device-list
+```
+
+真实浏览器执行场景后，使用 inspect --acceptance 核对当前候选、实际构建和证据引用。检查通过仍待用户评审。只读分析不执行以上写入构建步骤，也不安装、持久化设计或更新原型状态。
+
 ## 配套检查
 
 在业务项目运行 `node .codebuddy/i3-composer-agent/scripts/run-evals.js --min-rank1 95`，

package/docs/codex-setup.md

@@ -34,3 +34,7 @@ Codex 短命令适配是独立的宿主能力，不影响技能中文化与品
 Codex 已有原生技能路由，勿把元技能全文预加载为常驻上下文。
 元技能仍可安装并按需显式调用。CLI 保留已有插件设置；测试本地目录时使用绝对路径。
 文件安装、宿主发现与实际模型工作流分别验证。
+
+## 可选原型工具
+
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。项目安装可使用 `npx @givolt/i3-composer-agent@2.3.2 --codex --scope project --yes --prototype-skills uiux,antdv`；全局安装将 scope 改为 global。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。

package/docs/other-hosts.md

@@ -6,7 +6,7 @@
 
 ## 使用本地分发目录
 
-以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@2.3.0` 的对应入口。
+以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@2.3.2` 的对应入口。
 
 ### fx
 

package/docs/ui-prototype-native/MAIN-SESSION-REPORT.md

@@ -0,0 +1,66 @@
+# 主会话原型改造验证报告
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+日期：2026-10-17。源码分支：feature/prototype-native-pilot。首期为CodeBuddy＋admin-list小模板＋Vue 3/antDv-next设备流程。实施及样例技术验收完成，补充复核后的当前收据已完成；用户视觉/业务评审仍为pending-review。正式main与上游保全基线未变，未合并或发布。
+
+## 已完成改造
+
+取消prototype-specialist专责Agent、常驻分派规则及父子JSON强制；自然语言、using、/i3-prototype、直接Skill均由主会话执行。using以原版aeac41d4为基线，只增加普通原型分支和Quick Reference行；移除两行后SHA256为30787ef2c77bf1a4729fffed0f6523ba6fcbe81bdc436b36371b78c21394d3c3。三宿主命令格式仍是薄入口，不承担企业调度。
+
+企业SOP在外层组织PRD、设计取舍、制作、技术验证、人工认可与工程交接；原型Skill按需复用前端、官方框架、UIUX和浏览器方法。业务/技术规格、任务tracker及正式发布仍依上游方法，不增加企业审批库或专属Agent。
+
+HTML继续可离线修改，是内容和能力输入。生成原型采用真实ConfigProvider/Table/Form/Drawer等组件；本次需求明确绑定“明亮、暗黑、清新、科技”，首次默认明亮，页面内切换，不重挂应用或丢失筛选/页码/选择/未保存输入。旧HTML及未绑定主题的固定实例不自动加入主题、不重写摘要。模板内容和最终框架效果分别验证。
+
+已有安装按清单归属＋已审原字节指纹安全退出旧角色/规则；修改过、来源不明的受管退出资产会阻断，force不绕过；用户文件保留。维护宿主工具不自动成为上游/全局Hook。
+
+## 主要实证
+
+证据根：工作区artifacts/verification/prototype-main-session-20261017/。
+
+| 范围 | 实际结果 | 证据 |
+|---|---|---|
+| 源码与分发 | 全回归528/528、零跳过；实际打包/安装各340/340；最终冻结复验以相邻JSON/log为准 | source-final-guidance.*、source-delivery-final.*、candidate-3-*-test.*、delivery-package/ |
+| 退出与升级 | 真实旧tgz→新tgz项目/global角色5→4，用户规则保留；16项迁移保护通过 | installation/real-upgrade-RESULT.json |
+| 离线HTML | 实际断网file://修改、展示、同步提取，3本地请求、0外部请求/console错误，未起服务 | offline-html-check/ |
+| CLI四入口 | 真实Skill调用、完整分析回传，无Agent；734文件前后同一，SDK/工具/缓存未变 | ENTRY-MATRIX.json、probe-*/ |
+| CodeBuddy IDE入口 | 实际识别/展开命令、UseSkill及主会话中文回传，732安装文件比较无异常差异 | ide-command/ |
+| 全新业务冷生成 | 100工具/22MCP，无Agent，processComplete=true；官方/前端/browser Skill及真实UIUX查询/设计/构建；7/7单测、类型与构建通过 | cold-main-session-v2/、cold-v2-preflight.json |
+| 完整原型专项 | 23/23、零console错误/警告，同一candidate/build，含四主题/状态/偏好/隔离、Drawer动效/毛玻璃/焦点、窄屏/键盘和故障对照 | cold-project-v2/prototypes/main-devices/qa/runs/chrome-1792253902290/ |
+| UIUX实际Skill复查 | Skill(ui-ux-pro-max)真实加载，31工具，零文件/缓存变更；采纳/拒绝与效果分别核对，无阻断 | uiux-final-review/ |
+| 真实交互DevTools补录 | 实际browser Skill，44次MCP/51工具，trace含13 click/1 input，六类观测与操作后console/network已保存；48轮上限后无最终模型回复，未算该轮自动完成 | devtools-interaction-supplement/ |
+| 独立输入/焦点诊断 | 实际固定MCP原生Backspace恢复21；空名保存拒绝、错误/焦点/抽屉/列表均正确，console0 | mcp-empty-fill-diagnostic/run-006/ |
+| 审定与交付 | 原始事件审计、修正登记后build/browser/devtoolsReview/delivery均current，nextAction=return-result；passed、pending-review | FINAL-COLD-AUDIT.json、audited-state-final.json、实例qa/delivery.json |
+| 兼容保护 | 337摘要/模式未变、原先REPORT/TASKS字节前缀保留；旧v1/v2固定合同不追随新模板 | protected-current.json |
+
+当前原型：main-devices/r001，candidateDigest=793e0a1eee86bad6e9a081548840cc6408aded05347fa8485f050611f71f1954；buildId=b-193a4dfa2f1be867ceb1，buildDigest=193a4dfa2f1be867ceb103690bdc451ceabcbee0ef29875d388fc420c88f637c。
+
+## 发现、修复与证据纠正
+
+真实冷运行发现原生分页内部隐藏链接仍能获得焦点。中央starter只将page项渲染为不可聚焦span，保留外层LI及鼠标/键盘；新固定快照启用paginationFocusGuard，旧快照缺字段维持原合同。AX普通鼠标可复现、故障负例能失败、修复后的23项与零候选warning均有实证。
+
+CodeBuddy2.168.2初层fill参数scalar与后层完整对象换ID格式，维护宿主已做极窄兼容（固定managed1.11.0、非只读、精确PreToolUse和fill），19/19及独立审查通过，实际新补录也无auditDenied。不能据此建立通用跨层deny绑定保证；实际文件边界另由OS策略及差异证明，不扩大写目录，不改上游Hook/全局配置。
+
+独立审计发现初版模型报告的时区错误、调用ID占位、MCP网络摘要和冷缓存措辞不实，性能trace只覆盖reload。原始字节与原最终回复保留，未接受其自评结论。当前报告从真实UTC/call_*生成；MCP仅确认URL/状态，真实响应字节SHA来自独立Playwright观测。UIUX原生成有provider查询但没有Skill调用，真实Skill复查由后续只读阶段完成，不改写历史。
+
+补录的完整五分钟交互trace解压70,406,491字节，登记器64MiB边界正确拒绝。原件未改；以明确标注来源、摘要和窗口的前120秒连续原事件导出登记（34,338,470字节、7 click/1 input），不改上限、不筛事件类别、不宣称该片段就是完整录制。索引在实例qa/devtools/audited/trace-excerpt-index.json。
+
+另独立复现固定MCP1.11.0的空fill直接清DOM而未发input/change：查询/校验仍读旧绑定。正常键盘/Playwright为空可正确工作。真实MCP以当前文本和末尾光标为准逐次Backspace验证通过；Meta+A/Control+A未全选、空格可能追加旧值等失败保留。自有Skill已补实测指引，上游浏览器Skill/MCP/组件库不改。该工具事件问题与宿主scalar参数兼容分别记录。诊断run-004在抛弃的独立profile中误做一次非空保存已披露；通过run-006无成功保存，应用文件、共享模型profile、旧QA均未变。
+
+第一次源码/机械浏览器失败、第一次冷生成120轮未完、维护者误期待revise自动刷新快照而停止的阶段、补录48轮上限、客户端参数/解析错误、64MiB拒绝均保留。revise只接受已整理输入摘要，不自动迁移framework；旧实例未手补新字段。
+
+## 结论边界
+
+首期样例经过实际主会话制作、专项回归及补充复核后具备待评审交付条件。不能扩展为所有模型/宿主/页面或单轮无人复核都可靠。短种子未触发长文本ellipsis的专门视觉用例，未声称该效果已经实测。技术验证不代替人类认可，不执行confirm-baseline。
+
+四CLI入口和IDE入口来自C1；C2的using/三命令字节相同，C2完成新业务冷生成。其后仅自有输入事件指引与维护文档修订；最终包与C2实现/模板/框架/浏览器执行器/入口的字节比较、精确包摘要和最终打包/安装结果以delivery-package/及FINAL-PACKAGE.json为准，不冒认最终说明版本另跑了一次完整冷生成。
+
+只读CLI的工具限制、OS写保护及零缓存结论不外推到任意IDE/全工具配置；IDE实际界面请求保留无害残留前缀，项目根重定位只归一确切安装路径，不对用户级会话日志宣称零写入。可写冷生成使用独立npm缓存产生正常依赖缓存/日志；SDK与固定工具未改。
+
+本次改造提交保留在试点分支，未安装覆盖用户现有全局环境、未合并、未发布。最终可预览当前候选，仍需用户针对明确revision/digest进行业务和视觉评审。