@givolt/i3-composer-agent 2.2.2 → 2.3.0

package/skills/i3-ui-prototype/references/enterprise-admin.md

@@ -0,0 +1,38 @@
+# 企业管理后台复用
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+企业后台的来源是工作区的 EASEL v0.14 HTML 审查成果。模板完整保留 326 个来源文件：运行页面、控件、样式、图标、规则测试、来源、许可及历史验收材料。原 history/easel-history 目录不修改。
+
+## 完整示例与新业务
+
+- 用户要审查原来的整套后台时，使用 enterprise-admin 和 purpose=template-review，保留示例菜单与业务，便于和原版对照。
+- 用户要根据新业务做原型时，使用默认 business-prototype，先明确模块、字段、角色、状态和需求映射，修改原型副本中的相关文件；未适配状态 needs-adaptation 不能通过业务验收。
+- 审查完整示例不代表批准其全部 EASEL 业务，也不代表其他项目已完成业务适配。
+- 模板根 origin.json 保存全部来源文件的 SHA-256。reference/ 是完整来源快照，品牌转换不改写其中内容。实例仅进行明确的启动、设计 token 和本地数据命名空间接入。
+- 资源库中的 5 个 Markdown 文件按技能命名规范存放为小写名称，原名到存放路径记录在 origin.storagePaths；内容不变，生成实例时还原原文件名，原文链接继续有效。既有验证器保持原有规则。
+- design-system/source.json 记录本实例的局部接入及用途。app/qa 保存的是来源历史记录，当前验收使用原型根 qa/。
+
+## 页面与组件
+
+完整示例包括工作台、模型、Agent、意图、规格、流程、任务、PBC、权限、评审、发布、运行等原有页面，以及原来的占位范围。它仍是本地模拟；不接入真实模型、SSO、GitLab、Dapr、CI、监控或生产服务。
+
+表格、列设置、批量操作、抽屉、表单校验、详情、向导、画布、版本与证据链均沿用已有交互。EASEL 语义变量和 Antdv 变量共同保留，不能只调整一组颜色。原生 HTML 运行层无需安装 Vue/React 依赖；进入真实工程时另做组件和接口映射。
+
+## 自适应与验收
+
+检查 320、390、768、1024、1440px，覆盖工作台、管理列表、抽屉表单、向导和画布。导航在窄屏切换为菜单，内容区域重排，宽表格允许局部滚动，整页不能横向溢出。键盘检查菜单、Escape、返回、取消与焦点恢复；减少动态效果设置保持原规则。
+
+UI/UX Pro Max 使用专项 UX 查询校核这些规则，匹配的建议写入 qa/design-advice.json 并实际验证。专业建议不重新定义原版配色、字号、导航或控件尺度。
+
+AI 工作台、数字孪生大屏、移动端应用在目录中为 planned。不得将三类请求悄悄生成成企业后台。旧三套通用模板仅作兼容和历史原型迭代。
+
+## 完整内容与滚动
+
+原始 EASEL 文件不删减。实例和预览入口使用独立 usability.css 解除导出样式残留的页面滚动锁，恢复完整宽度，并显示表格、标签栏的横向滚动条。弹窗运行时的滚动锁仍有效。验收应实际滚到页面底部、表格最右操作列和最后一个标签，不能仅检查整页 scrollWidth。

package/skills/i3-ui-prototype/references/expert-adapter.md

@@ -0,0 +1,42 @@
+# UI/UX Pro Max 接入
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+专业增强模式对应 professional，模板模式对应 template。依赖在用户实际执行的宿主中检测；推荐先使用宿主暴露的技能根，再使用明确 --host 指定的项目和全局目录。Codex 插件安装应由宿主提供的实际路径传给 --provider，不假设固定缓存版本。
+
+检测 SKILL.md、Python 查询模块与数据库，执行只读 UX 探测。安装版本/资源摘要和当前查询记录保存为来源；探测成功只说明可执行，不意味着业务建议已经采用。
+
+缺失依赖时显示：当前环境不能使用 UI/UX Pro Max，可安装并验证，或选择模板模式继续；也可先整理需求和比较模板。默认不降级。用户已经选择安装或模板模式时沿用选择，不重复请求相同许可。
+
+按维护方 [官方安装说明](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill#installation) 选择当前宿主适用入口。对于未实测的宿主只说明已验证方法和限制，不猜测安装路径。选择安装后应安装完整技能，包括 Python 脚本、数据库与必要引用，重新检测可用性。不能只复制 SKILL.md。不自动安装 Python 或其他系统运行环境。
+
+使用已安装专业技能的指令和查询机制，向数据库传递抽象设计问题，不传私有业务数据。整体设计建议用 --design-system；专项交互用 --domain；实际技术栈支持时另查 --stack。HTML 模板不等于 html-tailwind，不为了查询参数而更换原型技术。
+
+```sh
+node <skill-root>/scripts/check-design-provider.cjs --provider <uiux-root> --query "error summary validation" --domain ux
+```
+
+对产品类型、页面结构和结果身份核对。返回失配时按专业技能契约重试一次，仍失配就拒绝；专业建议未匹配不等于可以补造业务流程。专业 provider 无可采用结果时记录 no-match 与采用的模板/工程依据，必要时由用户决定是否切换模式。
+
+qa/design-advice.json 采用以下记录结构：
+
+```json
+{
+  "schemaVersion": 1,
+  "mode": "professional",
+  "provider": {"version": "实际版本", "digest": "检测输出的摘要"},
+  "records": [
+    {"query": "error summary validation", "resultIdentity": "Focusable Error Summary", "decision": "adopted", "rationale": "适用当前申请表单；保持模板布局", "verification": "提交失败聚焦摘要且可跳到错误字段", "pages": ["#/new"], "result": {"保存实际相关返回内容": true}}
+  ]
+}
+```
+
+decision 可使用 adopted、adjusted、rejected；采用或调整的建议应写入设计契约和验收。初始化为 pending；没有记录实际查询和采用证据时不能声称 used。原始 --persist 结果只可写独立建议候选位置，不覆盖已认可的 MASTER 或使用未授权 --force。
+
+渲染后的专业复核围绕实际发现的问题查询，再由浏览器检查修复。专业数据库提供建议，不自动证明可用性、无障碍认证或用户认可。

package/skills/i3-ui-prototype/references/template-adapters.md

@@ -0,0 +1,57 @@
+# 模板目录与运行层接入
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+## 当前资源
+
+`assets/templates/catalog.json` 负责类型、可用状态、版本和预览入口，并用 `defaultTemplate` 指定默认类型。可生成条目必须指向自己目录下的 `manifest.json`；planned 条目不要求资源目录，不能初始化，也不会回退为其他模板。
+
+当前企业后台使用 `easel-html`：完整 EASEL `reference/`、`origin.json` 来源清单、设计 token 和独立滚动适配。原始 326 个文件保持原样。AI 工作台、数字孪生大屏和移动端仅为 planned 目录条目，没有假模板包。旧三套兼容模板明确使用 `legacy-html`，共享 `common/`，各自保留 preset；不能把这些兼容演示当成新三类已经实现。
+
+模板选择页按 catalog 展示可用类型并切换预览，只负责查看资源；点击卡片不会创建业务原型、采用专业建议或确认基线。实际生成仍走技能操作并按业务适配，浏览器验证和用户认可分别保存。
+
+## manifest
+
+可生成模板的最小清单示例：
+
+```json
+{
+  "schemaVersion": 1,
+  "adapter": "easel-html",
+  "preset": "enterprise-admin/preset.json",
+  "resources": { "root": "enterprise-admin" },
+  "defaultTitle": "企业管理后台 · EASEL 完整示例"
+}
+```
+
+资源路径相对于 `assets/templates/`，必须存在，不能绝对寻址、包含 `..` 或通过符号链接跳转。manifest 只能选择代码中明确登记的内置 adapter；它不是可以执行任意脚本的插件描述。未知 adapter、缺清单或不安全路径在创建实例前拒绝。摘要包含所选 catalog 条目、清单、资源、登记器、adapter 版本及其声明的实现文件；其他模板条目不会改变当前模板摘要。仅修改 preset 不足以表示一个独立运行层。
+
+## adapter 合同
+
+`scripts/template-adapters.cjs` 集中读取与校验 catalog/manifest，计算摘要并选择运行层。当前仅登记 `adapters/easel-html.cjs`、`adapters/legacy-html.cjs`，不按模板 ID 在公共生成器中分支，也不隐式复制 common。
+
+每个 adapter 提供：
+
+- `version` 和 `implementationFiles`：运行层版本、应计入摘要的实现及辅助文件；新增内置运行层应完整登记实现依赖。
+- `fingerprintInputs(context)`：实际模板资源路径。上下文的 `resource(name)` 只读取 manifest 声明且通过安全校验的位置。
+- `initialize(directory, options, context)`：写入隔离的实例暂存目录，返回 `{metadata, handoff}`；公共层再统一写配置、token、QA 和项目登记。
+- `validateRuntime(metadata, options)`：运行身份、用途及适用业务验收条件。
+- `runtime`：`kind`、`requiredFiles`、`identityFields`、`excludedBrowserPrefixes`、`protectedFiles`、`protectedDirectories`。它们定义运行检查、摘要身份和基线保护，不代替实际浏览器执行。
+
+共同设计契约、token、入口和需求映射始终受保护，运行层可增加自己的保护路径。运行身份变化也作为契约变化报告。EASEL 的历史 tools/tests/qa 不作为浏览器模块扫描；当前验收仍读取实例根 qa。
+
+`createTemplateRegistry({assetRoot, adapters})` 支持受信任的程序内集成与隔离测试；CLI 使用随包登记器，不接受从模板清单加载任意 adapter 代码。旧实例没有 `template.adapter` 时按已登记模板识别；缺新增 runtime 字段的旧 legacy 身份不补写字段，旧 EASEL 的 purpose/business/runtime 顺序保持，原有内容摘要与快照继续可读。未知模板不靠猜测识别为 common。
+
+## 扩展步骤
+
+1. 准备完整可运行资源、preset 与设计契约；有外部来源时保留来源清单、许可和固定内容。
+2. 增加 manifest，声明真实 adapter 与资源；独立运行形态实现并登记 adapter，不能只改 available 后复用错误演示。
+3. catalog 登记版本、manifest 和本地预览。planned 保持不可生成，原有实例不自动切换模板或升级摘要。
+4. 验证独立运行层无 common 也能生成，资源/实现变化改变指纹，非法清单写入前拒绝，运行检查与基线保护覆盖，旧实例摘要兼容；再做真实浏览器与业务场景验收。
+5. 在源码维护流程登记新增分发文件，完成品牌生成、打包/安装完整性检查。此登记不代表用户认可模板或授权发布。

package/skills/i3-ui-prototype/references/workflow-contract.md

@@ -0,0 +1,19 @@
+# 操作与状态
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+create 读取业务上下文、检测默认专业增强模式、展示四类模板的可用状态并记录选择，然后初始化和适配原型。企业后台当前可用；AI 工作台、数字孪生大屏和移动端尚待建设，不能自动替换为其他模板。兼容旧版三套模板仅供已有项目继续使用。脚本返回 needs-design-provider 时不得冒充创建成功；允许先完成需求和模板比较，等待安装或用户选择 template。已有原型的 expertMode 作为迭代默认值。
+
+revise 必须指定未使用的新版本；改变全局导航、token、组件行为或业务状态时解释影响并形成新的评审候选。inspect 可写检查报告但不修改页面或冻结基线。confirm-baseline 必须有用户对具体内容的明确认可和完整必需证据。
+
+verification 使用 not-run、partial、passed、failed、blocked；review 使用 pending-review、changes-requested、approved。expert 使用 pending、used、skipped、missing、unusable、no-match。它们分别表示检查、用户认可及专业能力使用；不相互推断。
+
+原型可从草拟需求开始。需求确认、原型认可、正式规格批准和生产授权各自保存。返回 scope、revision、mode、verification、review、openQuestions 和下一项必要动作，避免笼统地报告全部完成。
+
+企业后台默认 purpose=business-prototype，完整参考副本的 business.status=needs-adaptation；必须完成实际业务适配才能验收。用户明确评审 EASEL 模板本身时，使用 purpose=template-review，并将 reference-demo 范围写进交接。模板认可不等于任何新业务的需求或原型认可。

package/skills/i3-ui-prototype/scripts/adapters/easel-html.cjs

@@ -0,0 +1,30 @@
+'use strict';
+const assert = require('node:assert/strict');
+const enterprise = require('../enterprise-template.cjs');
+module.exports = {
+  version: '1',
+  implementationFiles: [__filename, require.resolve('../enterprise-template.cjs')],
+  runtime: {
+    kind: 'easel-html', identityFields: ['purpose', 'business', 'runtime'],
+    requiredFiles: ['app/app.js', 'app/enterprise-bootstrap.mjs', 'app/routes.json', 'app/runtime/dom.js', 'app/styles/tokens.css', 'design-system/source.json'],
+    excludedBrowserPrefixes: ['app/tools/', 'app/tests/', 'app/qa/'],
+    protectedFiles: ['app/tokens.css', 'app/styles.css', 'app/index.html', 'app/domain.mjs', 'requirements-map.json', 'app/app.js', 'app/routes.json', 'app/config.json', 'app/enterprise-bootstrap.mjs', 'app/usability.css'],
+    protectedDirectories: ['design-system/', 'app/styles/', 'app/runtime/', 'app/src/'],
+  },
+  fingerprintInputs(context) {
+    enterprise.verifyReference(context.resource('root'));
+    return [context.resources.root];
+  },
+  initialize(directory, options, context) {
+    const purpose = options.purpose || 'business-prototype';
+    const runtime = enterprise.initialize(directory, { ...options, purpose, templateRoot: context.resource('root') });
+    return {
+      metadata: { purpose, runtime, business: { status: purpose === 'template-review' ? 'reference-demo' : 'needs-adaptation', source: 'EASEL v0.14 示例业务' } },
+      handoff: `用途：${purpose}。业务适配：${purpose === 'template-review' ? 'reference-demo' : 'needs-adaptation'}。完整保留 EASEL 示例，不能当作其他业务已完成；app/qa 为历史来源证据，当前验收读取根 qa/。\n\n`,
+    };
+  },
+  validateRuntime(metadata, options = {}) {
+    assert.ok(metadata.runtime?.kind === 'easel-html' && ['template-review', 'business-prototype'].includes(metadata.purpose), 'Invalid enterprise runtime contract');
+    if (options.acceptance && metadata.purpose === 'business-prototype') assert.equal(metadata.business?.status, 'adapted', 'Enterprise demo needs business adaptation / 需先完成实际业务适配');
+  },
+};

package/skills/i3-ui-prototype/scripts/adapters/legacy-html.cjs

@@ -0,0 +1,28 @@
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const assert = require('node:assert/strict');
+module.exports = {
+  version: '1',
+  implementationFiles: [__filename],
+  runtime: {
+    kind: 'legacy-html', identityFields: ['runtime'],
+    requiredFiles: ['app/app.mjs', 'app/domain.mjs', 'app/styles.css', 'mocks/applications.json'],
+    excludedBrowserPrefixes: [],
+    protectedFiles: ['app/tokens.css', 'app/styles.css', 'app/index.html', 'app/domain.mjs', 'requirements-map.json'],
+    protectedDirectories: ['design-system/'],
+  },
+  fingerprintInputs: ({ resources }) => [resources.common],
+  initialize(directory, options, context) {
+    const common = context.resource('common');
+    for (const folder of ['app', 'mocks', 'design-system']) fs.cpSync(path.join(common, folder), path.join(directory, folder), { recursive: true });
+    fs.renameSync(path.join(directory, 'design-system/master.md'), path.join(directory, 'design-system/MASTER.md'));
+    fs.copyFileSync(path.join(common, 'requirements-map.json'), path.join(directory, 'requirements-map.json'));
+    return { metadata: { runtime: { kind: 'legacy-html', entry: 'app/index.html' } }, handoff: '' };
+  },
+  validateRuntime(metadata) {
+    // Older legacy instances did not store a runtime field. Do not migrate
+    // their identity or invalidate already recorded content digests.
+    assert.ok(!metadata.runtime || metadata.runtime.kind === 'legacy-html', 'Invalid legacy runtime contract');
+  },
+};

package/skills/i3-ui-prototype/scripts/check-design-provider.cjs

@@ -0,0 +1,9 @@
+'use strict';
+const lib = require('./prototype-lib.cjs');
+try {
+  const { options } = lib.parseArgs(process.argv.slice(2));
+  const provider = lib.checkDesignProvider(options);
+  const result = options.query && provider.availability === 'available' ? { provider, query: options.query, result: lib.queryProvider(provider.root, options.query, options) } : provider;
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+  if (provider.availability !== 'available') process.exitCode = 2;
+} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/skills/i3-ui-prototype/scripts/check-prototype.cjs

@@ -0,0 +1,14 @@
+'use strict';
+const lib = require('./prototype-lib.cjs');
+try {
+  const { options, positional } = lib.parseArgs(process.argv.slice(2));
+  if (!positional[0]) throw new Error('Usage: node check-prototype.cjs <prototype-directory> [--acceptance] [--enforce-baseline]');
+  const result = lib.checkPrototype(positional[0], options);
+  result.baseline = lib.compareBaseline(positional[0]);
+  if (result.baseline.status === 'corrupt-baseline' || (options.enforceBaseline && result.baseline.protectedChanges.length)) {
+    result.status = 'failed';
+    result.errors = [...(result.errors || []), result.baseline.status === 'corrupt-baseline' ? 'Approved baseline is corrupt' : 'Design constraints changed; review and confirm a new baseline'];
+  }
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+  if (result.status !== 'passed') process.exitCode = 1;
+} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/skills/i3-ui-prototype/scripts/enterprise-template.cjs

@@ -0,0 +1,88 @@
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+const assert = require('node:assert/strict');
+const assetRoot = path.resolve(__dirname, '../assets/templates/enterprise-admin');
+const hash = bytes => crypto.createHash('sha256').update(bytes).digest('hex');
+function inventory(root, prefix = '') {
+  return fs.readdirSync(path.join(root, prefix), { withFileTypes: true }).flatMap(entry => {
+    const file = prefix ? prefix + '/' + entry.name : entry.name;
+    assert.ok(!entry.isSymbolicLink(), 'Refusing reference symlink: ' + file);
+    return entry.isDirectory() ? inventory(root, file) : [file];
+  }).sort();
+}
+function verifyReference(root = assetRoot) {
+  const origin = JSON.parse(fs.readFileSync(path.join(root, 'origin.json'), 'utf8'));
+  assert.equal(origin.schemaVersion, 1, 'Invalid enterprise source record');
+  const reference = path.join(root, 'reference');
+  const storedPaths = Object.keys(origin.files).map(file => origin.storagePaths?.[file] || file);
+  assert.equal(new Set(storedPaths).size, storedPaths.length, 'Duplicate enterprise asset mapping');
+  assert.deepEqual(inventory(reference), storedPaths.sort(), 'Enterprise source inventory changed');
+  assert.equal(origin.fileCount, Object.keys(origin.files).length, 'Enterprise source file count changed');
+  for (const [file, expected] of Object.entries(origin.files)) {
+    assert.ok(!path.isAbsolute(file) && !file.split(/[\\/]/).some(part => !part || part === '..'), 'Invalid source path');
+    const stored = origin.storagePaths?.[file] || file;
+    assert.ok(!path.isAbsolute(stored) && !stored.split(/[\\/]/).some(part => !part || part === '..'), 'Invalid mapped source path');
+    assert.equal(hash(fs.readFileSync(path.join(reference, stored))), expected, 'Enterprise source integrity / 来源完整性: ' + file);
+  }
+  assert.equal(hash(fs.readFileSync(path.join(reference, 'assets-manifest.json'))), origin.sourceManifestDigest, 'Invalid source manifest digest');
+  return origin;
+}
+const mapping = {
+  schemaVersion: 1,
+  scope: 'EASEL 企业后台完整示例；模板审查范围，不代表其他业务已适配',
+  requirements: [
+    { id: 'ENT-01', pages: ['#/workbench'], roles: ['演示身份'], actions: ['查看工作台和导航'], scenarios: ['enterprise-navigation'] },
+    { id: 'ENT-02', pages: ['#/models'], roles: ['有模型编辑权限的演示身份'], actions: ['新增模型', '校验和保存草稿'], scenarios: ['enterprise-form'] },
+    { id: 'ENT-03', pages: ['#/models', '#/permissions'], roles: ['演示身份', '只读身份'], actions: ['切换身份并检查动作权限'], scenarios: ['enterprise-permissions'] },
+    { id: 'ENT-04', pages: ['#/workflows'], roles: ['演示身份'], actions: ['查看和编辑流程'], scenarios: ['enterprise-workflow'] },
+    { id: 'ENT-05', pages: ['#/pbcs'], roles: ['演示身份'], actions: ['查看 PBC 并操作业务向导'], scenarios: ['enterprise-pbc'] },
+    { id: 'ENT-06', pages: ['#/workbench', '#/models', '#/intents/new'], roles: ['演示身份'], actions: ['窄屏导航', '键盘开关菜单', '保留未保存输入'], scenarios: ['enterprise-responsive', 'enterprise-keyboard'] },
+    { id: 'ENT-07', pages: ['#/models'], roles: ['演示身份'], actions: ['查看空、失败等演示反馈'], scenarios: ['enterprise-feedback'] },
+    { id: 'ENT-08', pages: ['app/routes.json'], roles: ['演示身份'], actions: ['打开原版已提供的全部页面入口'], scenarios: ['enterprise-routes'] },
+  ],
+  openQuestions: ['新项目的模块、字段、状态、权限及接口需按实际需求替换。原有 EASEL 示例不自动成为新业务规格。'],
+};
+function initialize(directory, { id, title, purpose, templateRoot = assetRoot }) {
+  const origin = verifyReference(templateRoot);
+  assert.ok(['template-review', 'business-prototype'].includes(purpose), 'Invalid enterprise prototype purpose');
+  const app = path.join(directory, 'app');
+  const instanceId = crypto.randomUUID();
+  const storagePrefix = 'i3-enterprise-' + id + '-' + instanceId + '-';
+  fs.cpSync(path.join(templateRoot, 'reference'), app, { recursive: true });
+  // Skill-supporting Markdown follows the repository naming convention. The
+  // source name and bytes are recorded, then restored in each runnable copy.
+  for (const [original, stored] of Object.entries(origin.storagePaths || {})) {
+    fs.renameSync(path.join(app, stored), path.join(app, original));
+  }
+  const adaptations = [];
+  for (const file of inventory(app).filter(name => /\.(?:js|mjs)$/.test(name))) {
+    const location = path.join(app, file), old = fs.readFileSync(location, 'utf8');
+    const next = old.replaceAll('i3-prototype-antdv-', storagePrefix);
+    if (next !== old) {
+      fs.writeFileSync(location, next);
+      adaptations.push({ file, reason: '仅替换本地演示存储前缀，隔离不同原型实例', source: origin.files[file], generated: hash(next) });
+    }
+  }
+  const index = path.join(app, 'index.html'), original = fs.readFileSync(index, 'utf8');
+  assert.ok(original.includes('src="app.js"'), 'Review changed EASEL boot entry before adapting');
+  const adapted = original.replace('</head>', '  <link rel="stylesheet" href="tokens.css">\n  <link rel="stylesheet" href="usability.css">\n</head>')
+    .replace('src="app.js"', 'src="enterprise-bootstrap.mjs"');
+  fs.writeFileSync(index, adapted);
+  adaptations.push({ file: 'index.html', reason: '接入原有设计 token、实例配置和独立滚动适配，完整保留页面内容', source: origin.files['index.html'], generated: hash(adapted) });
+  fs.copyFileSync(path.join(templateRoot, 'usability.css'), path.join(app, 'usability.css'));
+  fs.writeFileSync(path.join(app, 'enterprise-bootstrap.mjs'), "const response = await fetch(new URL('./config.json', import.meta.url));\nif (!response.ok) throw new Error('无法读取企业后台实例配置');\nconst config = await response.json();\ndocument.title = config.title;\nawait import('./app.js');\n");
+  fs.copyFileSync(path.join(templateRoot, 'serve.cjs'), path.join(app, 'serve.cjs'));
+  fs.mkdirSync(path.join(directory, 'design-system'), { recursive: true });
+  fs.writeFileSync(path.join(directory, 'design-system/MASTER.md'), fs.readFileSync(path.join(templateRoot, 'design-system.md')));
+  fs.writeFileSync(path.join(directory, 'design-system/source.json'), JSON.stringify({
+    schemaVersion: 1, source: origin.source, sourceVersion: origin.sourceVersion, sourceManifestDigest: origin.sourceManifestDigest,
+    sourceFileCount: origin.fileCount, adaptations, purpose, description: '所有来源文件已复制；局部适配仅用于初始化接入。app/qa 是历史来源证据，当前验收使用原型根 qa/。',
+  }, null, 2) + '\n');
+  fs.mkdirSync(path.join(directory, 'mocks'), { recursive: true });
+  fs.writeFileSync(path.join(directory, 'mocks/README.md'), '# 演示数据\n\n完整 EASEL 示例的数据与规则保留在 app/src/ 各模块中，并使用实例独立的本地存储。它们用于模板审查；新业务需要按需求替换，不能当作真实服务或已完成业务适配。\n');
+  fs.writeFileSync(path.join(directory, 'requirements-map.json'), JSON.stringify(mapping, null, 2) + '\n');
+  return { kind: 'easel-html', entry: 'app/index.html', sourceVersion: origin.sourceVersion, instanceId, storagePrefix };
+}
+module.exports = { verifyReference, initialize };

package/skills/i3-ui-prototype/scripts/init-prototype.cjs

@@ -0,0 +1,8 @@
+'use strict';
+const lib = require('./prototype-lib.cjs');
+try {
+  const { options, positional } = lib.parseArgs(process.argv.slice(2));
+  const result = positional[0] === 'templates' ? { templates: lib.listTemplates() } : lib.initPrototype(options);
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+  if (result.status === 'needs-design-provider') process.exitCode = 2;
+} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/skills/i3-ui-prototype/scripts/manage-baseline.cjs

@@ -0,0 +1,11 @@
+'use strict';
+const fs = require('node:fs');
+const lib = require('./prototype-lib.cjs');
+try {
+  const { options, positional } = lib.parseArgs(process.argv.slice(2));
+  const [operation, directory] = positional;
+  if (!directory || !['inspect', 'manifest', 'revise', 'confirm-baseline'].includes(operation)) throw new Error('Usage: manage-baseline.cjs <inspect|manifest|revise|confirm-baseline> <directory> [--revision r002] [--confirmation file.json]');
+  const result = operation === 'manifest' ? lib.contentManifest(directory) : operation === 'inspect' ? lib.compareBaseline(directory) : operation === 'revise' ? lib.revisePrototype(directory, options.revision) : lib.freezeBaseline(directory, JSON.parse(fs.readFileSync(options.confirmation, 'utf8')));
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+  if (result.status === 'corrupt-baseline') process.exitCode = 1;
+} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }