@givolt/i3-composer-agent 3.1.0 → 4.0.0

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/template.json

@@ -1,9 +0,0 @@
-{
-  "schemaVersion": 1,
-  "kind": "content-reference",
-  "id": "enterprise-admin",
-  "version": "1.0.0",
-  "entry": "index.html",
-  "definition": "capability-definition.json",
-  "title": "完整企业管理后台内容模板"
-}

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/usability.css

@@ -1,44 +0,0 @@
-/* Instance-level usability fixes. The complete EASEL reference stays unchanged. */
-:root {
-  --prototype-scroll-track: #f0f0f0;
-  --prototype-scroll-thumb: #8c8c8c;
-}
-
-/* The captured Ant stylesheet contains temporary document scroll-lock rules.
-   Restore the full body and native document scrolling. Live dialogs still
-   apply their own inline overflow:hidden while they are open. */
-html body {
-  width: 100%;
-  overflow-y: visible;
-}
-
-/* Explicit sizing keeps scrollbars visible on hosts with overlay scrollbars. */
-*::-webkit-scrollbar {
-  width: 12px;
-  height: 12px;
-}
-*::-webkit-scrollbar-track,
-*::-webkit-scrollbar-corner {
-  background: var(--prototype-scroll-track);
-}
-*::-webkit-scrollbar-thumb {
-  background: var(--prototype-scroll-thumb);
-  border: 2px solid var(--prototype-scroll-track);
-  border-radius: 6px;
-}
-*::-webkit-scrollbar-thumb:hover {
-  background: #595959;
-}
-
-/* Ant's exported CSS expects overflow navigation controls. The native runtime
-   uses real tab buttons, so expose native scrolling rather than clipping them. */
-.ant-tabs > .ant-tabs-nav .ant-tabs-nav-wrap,
-.ant-tabs > div > .ant-tabs-nav .ant-tabs-nav-wrap {
-  overflow-x: auto;
-  overflow-y: hidden;
-}
-
-.ant-table-content,
-.ant-tabs-nav-wrap {
-  scrollbar-color: var(--prototype-scroll-thumb) var(--prototype-scroll-track);
-}

package/skills/i3-ui-prototype/assets/templates/gallery/index.html

@@ -1,40 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
-<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>选择原型类型 · i3-Composer</title><link rel="icon" href="data:,">
-<style>
-*{box-sizing:border-box}html{height:100%}body{height:100vh;height:100dvh;display:flex;flex-direction:column;margin:0;background:#f5f5f5;color:#262626;font:14px/1.5 -apple-system,BlinkMacSystemFont,"PingFang SC","Microsoft YaHei",sans-serif}header{flex:none;padding:20px 24px 16px;background:#fff;border-bottom:1px solid #e8e8e8}h1{font-size:22px;margin:0 0 4px}p{margin:0;color:#595959}.options{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px;margin:16px 0}.option{text-align:left;border:1px solid #d9d9d9;border-radius:8px;padding:12px 14px;background:#fff;color:inherit;font:inherit;cursor:pointer}.option strong{display:block;font-size:16px;margin-bottom:4px}.option span{display:block;font-size:13px;color:#595959}.option[aria-pressed=true]{border-color:#1677ff;background:#f0f7ff}.option:disabled{cursor:default;background:#fafafa;color:#8c8c8c}.option:disabled span{color:#8c8c8c}.option:focus-visible,a:focus-visible{outline:3px solid #1677ff;outline-offset:3px}.summary{display:flex;align-items:center;justify-content:space-between;gap:16px;flex-wrap:wrap}.summary a{color:#0958d9;text-decoration:none;white-space:nowrap}.summary a:hover{text-decoration:underline}iframe{display:block;flex:1 0 240px;width:100%;min-height:240px;border:0;background:#fff}.error{color:#cf1322}
-@media(max-width:900px){header{padding:16px}.options{grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.option{padding:10px}.option strong{font-size:14px}.summary{gap:8px}}
-@media(prefers-reduced-motion:reduce){*{scroll-behavior:auto}}
-</style>
-</head>
-<body>
-<header><h1>选择原型类型</h1><p>双击即可离线预览完整内容模板；修改后刷新。生成原型时再结合需求与目标框架实现。</p>
-<div class="options" aria-label="原型类型"></div>
-<div class="summary"><a href="../presentation.html" target="_blank" rel="noopener">选择风格、布局与密度 ↗</a><p id="summary" role="status">正在读取模板…</p><a id="open" target="_blank" rel="noopener">打开完整演示 ↗</a></div>
-</header>
-<iframe title="企业管理后台完整交互演示"></iframe>
-<script src="../catalog.js"></script>
-<script>
-const assetRoot=new URL('../',location.href),frame=document.querySelector('iframe'),summary=document.querySelector('#summary');
-try{
- const catalog=I3_TEMPLATE_CATALOG;let selected=false;
- for(const entry of catalog.templates){
-  const button=document.createElement('button');button.className='option';button.type='button';
-  const title=document.createElement('strong');title.textContent=entry.name;button.append(title);
-  const hint=document.createElement('span');hint.textContent=entry.availability==='available'?'可操作演示 · 等待人工评审':'待建设';button.append(hint);
-  button.disabled=entry.availability!=='available';button.setAttribute('aria-pressed','false');
-  button.addEventListener('click',()=>{
-   const url=new URL(entry.preview,assetRoot);if(url.origin!==location.origin)throw new Error('模板入口必须来自本地资源');
-   document.querySelectorAll('.option').forEach(item=>item.setAttribute('aria-pressed',String(item===button)));
-   frame.src=url.href;frame.title=entry.name+'完整交互演示';document.querySelector('#open').href=url.href;
-   summary.textContent=(entry.brand?entry.brand+' · ':'')+entry.name+' · '+entry.version+'。保留完整示例，当前等待人工评审。';
-  });
-  document.querySelector('.options').append(button);
-  if(!selected&&!button.disabled){button.click();selected=true}
- }
- if(!selected)throw new Error('当前没有可用模板');
-}catch(error){summary.textContent=error.message;summary.classList.add('error')}
-</script>
-</body></html>

package/skills/i3-ui-prototype/assets/templates/generation-options.js

@@ -1,42 +0,0 @@
-// Generated from registered template metadata; refresh with sync-generation-assets.
-globalThis.I3_GENERATION_OPTIONS = [
-  {
-    "id": "enterprise-admin",
-    "name": "企业管理后台",
-    "defaults": {
-      "layout": "sidebar",
-      "style": "business",
-      "density": "standard"
-    },
-    "choices": {
-      "layout": {
-        "sidebar": "侧栏导航",
-        "topbar": "顶部导航",
-        "mixed": "顶部＋侧栏",
-        "focused": "独立工作区"
-      },
-      "style": {
-        "business": "商务稳重",
-        "minimal": "简约清晰",
-        "soft": "轻盈柔和"
-      },
-      "density": {
-        "compact": "紧凑",
-        "standard": "标准",
-        "comfortable": "宽松"
-      }
-    },
-    "patterns": [
-      "management-list",
-      "tree-list",
-      "tree-table",
-      "edit-form",
-      "form-page",
-      "detail",
-      "wizard",
-      "workflow",
-      "permissions",
-      "content"
-    ]
-  }
-];

package/skills/i3-ui-prototype/assets/templates/index.html

@@ -1,3 +0,0 @@
-<!doctype html>
-<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="refresh" content="0;url=gallery/index.html"><title>i3-Composer 内容模板</title></head>
-<body><p><a href="gallery/index.html">打开完整内容模板选择页</a></p></body></html>

package/skills/i3-ui-prototype/assets/templates/modern-workspace/manifest.json

@@ -1,9 +0,0 @@
-{
-  "schemaVersion": 1,
-  "adapter": "legacy-html",
-  "preset": "modern-workspace/preset.json",
-  "resources": {
-    "common": "common"
-  },
-  "defaultTitle": "立项申请"
-}

package/skills/i3-ui-prototype/assets/templates/modern-workspace/preset.json

@@ -1,6 +0,0 @@
-{
-  "layout": "workspace",
-  "primitive": { "teal": "#0f766e", "slate": "#1d3331", "spacing": [4, 8, 12, 16, 24, 32] },
-  "semantic": { "color-primary": "#0f766e", "color-text": "#1d3331", "color-muted": "#566b67", "color-background": "#f5f8f7", "color-surface": "#ffffff", "color-border": "#d9e5e1", "color-sidebar": "#ffffff", "color-sidebar-text": "#1d3331", "color-success": "#166534", "color-warning": "#92400e", "color-danger": "#b91c1c", "space-page": "32px", "font-body": "system-ui, -apple-system, 'PingFang SC', 'Microsoft YaHei', sans-serif" },
-  "component": { "radius-panel": "12px", "control-height": "44px", "table-cell-space": "20px", "sidebar-width": "220px" }
-}

package/skills/i3-ui-prototype/assets/templates/presentation.html

@@ -1,17 +0,0 @@
-<!doctype html>
-<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>原型风格与布局选择</title><link rel="icon" href="data:,"><style>
-*{box-sizing:border-box}body{margin:0;background:#f4f6fa;color:#23304a;font:15px/1.6 system-ui,sans-serif}main{max-width:1200px;margin:auto;padding:24px}h1{margin:0 0 8px}p{margin:8px 0 20px}.controls{display:flex;gap:16px;flex-wrap:wrap;margin:20px 0}label{display:grid;gap:6px}select,button,textarea{font:inherit;padding:8px;border:1px solid #b3bfd1;border-radius:6px}a{color:#1455bc}button{cursor:pointer;background:white;color:#1455bc}:focus-visible{outline:3px solid #1455bc;outline-offset:3px}.preview{--gap:20px;--radius:6px;display:grid;grid-template-columns:180px 1fr;grid-template-rows:auto auto 1fr;border:1px solid #cad2df;border-radius:var(--radius);overflow:hidden;min-height:320px;background:#edf1f7}.header{grid-column:1/-1;display:flex;justify-content:space-between;padding:16px;background:white;border-bottom:1px solid #dae1eb}.top{grid-column:1/-1;padding:10px 20px;background:white;border-bottom:1px solid #dae1eb}.side{padding:16px;background:white;border-right:1px solid #dae1eb}.side div{padding:8px;margin-bottom:8px}.active{background:#e6efff;color:#1455bc;border-radius:4px}.content{min-width:0;margin:var(--gap);padding:var(--gap);background:white;border:1px solid #dae1eb;border-radius:var(--radius)}.toolbar{display:flex;gap:8px;flex-wrap:wrap;margin-bottom:12px}.mock-input{background:#f3f5f9;border:1px solid #c4cddb;border-radius:4px;padding:6px 12px}.row{display:grid;grid-template-columns:30px 1fr 1fr;gap:8px;padding:10px;border-top:1px solid #e1e6ee}.layout-topbar,.layout-focused{grid-template-columns:1fr}.layout-topbar .side,.layout-focused .side,.layout-sidebar .top,.layout-focused .top{display:none}.layout-focused .content{width:calc(100% - 2 * var(--gap));max-width:860px;justify-self:center}.style-minimal .content{border-color:transparent}.style-soft{--radius:10px}.style-soft .content{box-shadow:0 4px 20px #23304a10}.style-minimal{--radius:4px}.density-compact{--gap:12px}.density-compact .row{padding:6px}.density-comfortable{--gap:28px}.density-comfortable .row{padding:14px}textarea{width:100%;min-height:150px;background:white}.notice{border-left:4px solid #1455bc;padding-left:14px}@media(max-width:640px){main{padding:16px}.preview{grid-template-columns:1fr}.side{display:none}.content{margin:8px;padding:12px}.header{flex-wrap:wrap;gap:8px}}
-</style></head><body><main>
-<a href="gallery/index.html">返回完整内容模板</a><h1>原型风格与布局选择</h1><p>先预览结构和间距，再把下方配置交给原型 Skill。此页可离线打开，选择不会写入业务项目。</p>
-<div class="controls"><label>模板<select id="template"></select></label><label>页面布局<select id="layout"></select></label><label>整体风格<select id="style"></select></label><label>信息密度<select id="density"></select></label></div>
-<div id="preview" class="preview" aria-label="外壳与间距示意"><div class="header"><strong>业务原型</strong><span>主题：明亮</span></div><div class="top">工作台　 ·　 业务管理　 ·　 设置</div><aside class="side"><div>工作台</div><div class="active">业务管理</div><div>设置</div></aside><section class="content"><h2>业务列表</h2><div class="toolbar"><span class="mock-input">查询条件</span><span class="mock-input">查询</span><span class="mock-input">重置</span></div><div class="row"><span>□</span><b>名称</b><b>状态</b></div><div class="row"><span>□</span><span>示例条目</span><span>正常</span></div><div class="row"><span>□</span><span>示例条目</span><span>待处理</span></div><p>共 20 条　 1　2　下一页</p></section></div>
-<p class="notice">这里展示风格、布局与密度示意。生成后的原型使用真实组件，保留明亮、暗黑、清新、科技切换；抽屉、树、校验等交互在实际业务工程中实现并验收。</p>
-<label for="configuration">交给原型 Skill 的选择配置</label><textarea id="configuration" readonly></textarea><button id="copy" type="button">复制配置</button><span id="status" role="status"></span>
-<script src="generation-options.js"></script><script>
-const byId=id=>document.getElementById(id),templates=globalThis.I3_GENERATION_OPTIONS;
-function fill(select,values,selected){select.replaceChildren();for(const [value,label]of Object.entries(values)){const option=document.createElement('option');option.value=value;option.textContent=label;select.append(option)}select.value=selected}
-function update(){const presentation=Object.fromEntries(['layout','style','density'].map(key=>[key,byId(key).value]));byId('preview').className=`preview layout-${presentation.layout} style-${presentation.style} density-${presentation.density}`;byId('configuration').value=JSON.stringify({template:byId('template').value,generation:{presentation}},null,2)}
-function chooseTemplate(){const meta=templates.find(item=>item.id===byId('template').value);for(const key of ['layout','style','density'])fill(byId(key),meta.choices[key],meta.defaults[key]);update()}
-try{fill(byId('template'),Object.fromEntries(templates.map(item=>[item.id,item.name])),templates[0].id);byId('template').addEventListener('change',chooseTemplate);for(const key of ['layout','style','density'])byId(key).addEventListener('change',update);chooseTemplate()}catch(error){byId('status').textContent='无法读取已登记选项：'+error.message}
-byId('copy').addEventListener('click',async()=>{try{await navigator.clipboard.writeText(byId('configuration').value);byId('status').textContent=' 已复制'}catch{byId('configuration').select();byId('status').textContent=' 请复制选中的配置'}});
-</script></main></body></html>

package/skills/i3-ui-prototype/assets/templates/serve-gallery.cjs

@@ -1,23 +0,0 @@
-'use strict';
-const http = require('node:http');
-const fs = require('node:fs');
-const path = require('node:path');
-const { brandRuntimeResource } = require('../../scripts/enterprise-template.cjs');
-const root = path.resolve(__dirname);
-const types = { '.html': 'text/html', '.mjs': 'text/javascript', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json', '.svg': 'image/svg+xml', '.png': 'image/png', '.jpg': 'image/jpeg', '.webp': 'image/webp' };
-const server = http.createServer((req, res) => {
-  let relative;
-  try { relative = decodeURIComponent(new URL(req.url, 'http://localhost').pathname); } catch { res.writeHead(400).end(); return; }
-  if (relative === '/') { res.writeHead(302, { Location: '/gallery/index.html' }).end(); return; }
-  const file = path.resolve(root, '.' + relative);
-  if (!file.startsWith(root + path.sep) || !fs.existsSync(file) || !fs.statSync(file).isFile() || !fs.realpathSync(file).startsWith(root + path.sep)) { res.writeHead(404).end(); return; }
-  res.writeHead(200, { 'Content-Type': (types[path.extname(file)] || 'application/octet-stream') + '; charset=utf-8', 'Cache-Control': 'no-store' });
-  const enterpriseReference = path.join(root, 'enterprise-admin/reference');
-  if (file.startsWith(enterpriseReference + path.sep) && /\.(?:html|js|mjs)$/.test(file)) {
-    const relative = path.relative(enterpriseReference, file).split(path.sep).join('/');
-    res.end(brandRuntimeResource(relative, fs.readFileSync(file, 'utf8')));
-    return;
-  }
-  fs.createReadStream(file).pipe(res);
-});
-server.listen(Number(process.argv[2] || 0), '127.0.0.1', () => process.stdout.write(`模板预览：http://127.0.0.1:${server.address().port}/\n`));

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

@@ -1,66 +0,0 @@
-# 产物与验收
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-## v2 原生组件实例
-
-schemaVersion=2、artifactKind=framework-prototype、runtime={kind:vue-antdv-next,version:"1"} 使用 native-pilot 合同；template、framework 保存 id、version、digest，expertMode 保留 professional／template。项目清单定位实例，安装包最新定义不替代实例固定输入。
-
-新流程只读使用 Skill 内随版本发布的模板，不默认生成项目 `ui-templates`；模板维护在 Skill 源码完成，业务修改直接落在实例工程。已有模板工作副本可通过 --template-root 显式复用并保留原文件。实例 `inputs/` 固定模板、范围、能力定义和 binding、框架映射及必需场景；`app/` 是真实组件工程，`mocks/` 为可复现状态，`design-system/` 保存正式规则。`requirements-map.json` 连接范围和实现。完整模板固定为参考输入，scope.pages／regions 规定实际业务范围；未知新增交互与任意 N/A 须处理。runtime.contentReference=true 时还记录 business.status；needs-adaptation 的骨架不能通过业务验收，状态变更进入候选身份。详见 [content-template.md](content-template.md)。旧 v2 输入没有该标识时保持原合同。
-
-| 身份 | 包含 |
-| --- | --- |
-| inputDigest | 固定模板、需求范围、能力绑定、框架和必需验收 |
-| candidateDigest | 固定输入＋源码、资源、正式设计、模拟数据、构建配置与锁文件 |
-| buildDigest | 实际产物文件及摘要 |
-| run | 引用候选和构建，保存真实操作、结果和证据 |
-
-node_modules、缓存、执行状态、QA 证据不进入候选摘要。正式场景定义不能因位于 QA 名下而被排除。构建身份由构建阶段形成，不回写候选源码造成循环。
-
-`builds/<build-id>/` 保存固定产物，`qa/runs/<run-id>/` 保存执行证据；`execution.json` 是可变运行记录，不承担候选身份。HANDOFF 保留已完成范围、待确认及恢复入口；实际恢复以文件／摘要为准。用户手改保留并使旧证据失效。
-
-浏览器打开的入口与实际加载资源要匹配构建，不能只读网页内声明的摘要。运行前后候选一致，否则本轮无效；未实际执行不标通过。构建、源码和输入绑定后才能交付已验证候选。
-
-新基线必须覆盖固定输入、候选源码和设计合同，并引用与该版本匹配的验收及人类确认；QA 证据作为可审计附件，不倒算影响候选摘要。使用 `native-pilot.cjs confirm-baseline <root> --confirmation <file>`，人类确认文件包含 revision、digest、reviewer、statement、source。compare-baseline 检查当前差异及基线完整性；不得通过修改 legacy JSON 假装 v2 已冻结。
-
-## Legacy v1 与原摘要
-
-以下合同保留既有实例解释，不能补写 v2 字段、重新计算旧摘要或迁移已确认快照。新执行者需要先判运行层，再选择脚本。
-
-项目新索引为 `prototypes/index.json`；只有旧 `.i3-ui-prototypes.json` 时保持兼容并继续使用原索引，直到显式迁移。prototypes 条目列出 id、相对业务项目根目录的 directory 和 appliesTo；新原生实例从固定 scope.moduleIds 去重生成关联，空数组表示未关联。旧 scope 没有 moduleIds 时不自动补写或改动旧摘要。索引与输入不一致时查询报告失败；多个匹配保持歧义，不能自动套用任意基线。目录、同步与迁移命令见 [project-layout.md](project-layout.md)。
-
-原型目录含 prototype.json、requirements-map.json、design-system/MASTER.md 与 tokens.json、app、mocks、qa、reviews、baselines、baseline.json、HANDOFF.md。企业后台生成 EASEL 完整参考示例，兼容旧模板生成通用演示；用于新业务时代理必须适配实际业务。企业后台还保留 design-system/source.json、runtime 与 purpose，记录来源、实例数据隔离及用途。模板来源与许可在技能资源中保留。生成实例 app/qa 是来源历史记录；本轮验收证据必须写入根目录 qa，不能复用历史通过状态。
-
-新增实例的 template.adapter 记录清单选定的运行层；模板指纹覆盖 manifest、preset、声明资源及 adapter 实现。旧实例不补写缺失字段或改写已有模板摘要，其原 contentManifest 身份与摘要保持兼容。运行身份、必需资源和保护路径由明确的运行层合同决定，未知运行层拒绝，不回退兼容演示；详见 [template-adapters.md](template-adapters.md)。
-
-需求映射 schemaVersion=1，每个 requirement 具有唯一 id、pages、fields、actions、roles、states、scenarios 和 confirmation。scenarios 是浏览器检查的场景 ID；涉及权限与状态变化的需求应补充可见范围、转移条件及校验。未确认规则写入 openQuestions。
-
-浏览器记录 qa/browser.json：
-
-```json
-{
-  "schemaVersion": 1,
-  "revision": "r001",
-  "digest": "当前 manifest 命令返回的 SHA-256",
-  "status": "passed",
-  "source": "实际浏览器工具与运行记录位置",
-  "screenshots": ["qa/screenshots/desktop.png", "qa/screenshots/narrow.png"],
-  "journeys": [{"id": "需求映射中的场景ID", "status": "passed"}],
-  "consoleErrors": [],
-  "viewports": [1440, 768]
-}
-```
-
-每个必要场景都必须实际执行。记录无法执行或失败的项，不以填写 JSON 替代运行。结构验收检查记录一致性与引用存在；其结果不能独立证明浏览器发生过执行。截图固定数据与视口，键盘和焦点采用实际交互验证。
-
-确认文件含当前 revision 和 digest，以及 reviewer、statement、source 三个非空字段。source 指向可信的人类确认记录；statement 保留用户认可意思。测试夹具的模拟确认仅用于验证保护逻辑。
-
-快照保存运行文件、需求、设计契约和专业建议记录，manifest.json 记录摘要，review.json 记录确认。baseline.json 引用当前已确认快照。新候选不覆盖旧快照；快照损坏或失去匹配时报告 corrupt-baseline。
-
-check-prototype --enforce-baseline 对设计契约、token、需求映射或模板/模式改变返回失败，供项目选择接入门禁。它不会自动分析不同框架的生产组件；真实工程仍需组件映射、受影响页面的浏览器与业务回归。

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

@@ -1,81 +0,0 @@
-# 完整内容模板与原生框架生成
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-## 目录与修改方式
-
-```text
-i3-ui-prototype/
-├── assets/templates/index.html                 离线选择入口
-├── assets/templates/enterprise-admin/
-│   ├── index.html                              完整内容模板，双击打开
-│   ├── offline.js                              已构建的本地经典脚本
-│   ├── template.json / capability-definition.json
-│   ├── usability.css / offline-build.json
-│   └── reference/                              不可变来源、样式与本地资源
-├── assets/capabilities/management.json          通用能力定义的维护来源
-├── assets/frameworks/vue-antdv-next/
-│   ├── starter/                                新业务的框架骨架与四主题
-│   └── legacy-starter/                         旧固定设备合同的兼容起点
-└── scripts/、references/、SKILL.md
-```
-
-内容模板只有完整企业后台作为当前可用类型，其余类型仍为 planned。正式 Skill 内不再含 `authoring/admin-list`；历史小 HTML 仅在配套工具的测试夹具中，用来验证已有输入兼容。`legacy-starter` 是旧原生框架合同的兼容代码，不是新内容模板或默认生成入口。
-
-默认直接只读使用 Skill 内随包发布的完整模板及能力定义，不复制到业务项目 `ui-templates/`，不在生成业务原型时修改安装目录。内容索引按实际已安装资源在内存中计算，实例 inputs 固定该索引及模板、范围快照，避免品牌／宿主适配后缓存摘要过期。模板由维护者在 Skill 源码中修改、校验并随版本发布；`index.html` 的 HTML／CSS 仍可离线修改查看。业务项目直接修改 `prototypes/<id>/app/`。
-
-既有 `ui-templates/enterprise-admin/` 和 prepare-template／sync-template 命令保留兼容。只有用户明确选择某个已有副本时，使用 --template-root 指向它；其手工修改保留，不自动迁移、覆盖或清理。同步该副本后，template-page 可显式传目录查看；省略目录时只读查看 Skill 内置模板。
-
-离线 HTML 是内容参考。Vue／antDv-next 工程使用真实组件，仍需要项目依赖和开发／构建预览；不能承诺框架源码也能直接以 file:// 打开。
-
-## 需求与通用能力
-
-新 scope 使用 schemaVersion=3，包含页面模式、客户选择、逐字段／操作、逐参考功能节点取舍和实施／证据绑定。完整当前格式见 [generation-contract.md](generation-contract.md)。下列 schemaVersion=2 示例仅解释旧输入兼容，不作为新任务起点。
-
-完整参考含多种页面，不能默认把所有参考业务生成到新项目。先根据实际 PRD 声明页面与区域。新整理的 scope 放在本次允许写入的 `prototypes/.preparation/<id>/scope.json`；已有范围文件只读引用，不改项目其他文件或提前创建原型目标目录。示例仅解释格式：
-
-```json
-{
-  "schemaVersion": 2,
-  "moduleIds": ["asset-management"],
-  "title": "资产管理原型",
-  "pages": [{
-    "id": "assets", "title": "资产台账", "referencePage": "models-page",
-    "regions": [
-      {"id": "list", "mode": "management-list"},
-      {"id": "editor", "mode": "edit-form"}
-    ]
-  }],
-  "requirements": [{
-    "id": "ASSET-01", "text": "按业务字段查询、选择和修改资产", "pages": ["assets"],
-    "source": {"type": "prd", "reference": "PRD.md#ASSET-01", "statement": "此处保留真实需求原文"}
-  }],
-  "exemptions": []
-}
-```
-
-moduleIds 只使用真实 PRD 或项目明确的稳定模块标识，未关联时填 []；多个 PRD 分别记录需求来源与版本，模块去重生成共享索引的 appliesTo。示例模块 ID 不能冒充真实 PRD 标识。旧 scope 不自动补字段。目录与关联查询见 [project-layout.md](project-layout.md)。
-
-`referencePage` 取本次选定模板索引的页面 ID；`template-page` 只读返回所选页面 HTML。显式引用旧副本时包含其已同步修改。业务 page/region ID 保持稳定；不能把示例 PRD 来源冒充实际需求。
-
-旧 v2 区域类型为 `management-list`、`edit-form`、`content`；只声明本次真实页面。默认列表需要查询、复选、分页、批量和反馈；编辑需要表单与反馈。默认分页为 adjustable，默认 10、选项 10／20／50，至少三页默认容量测试数据；可在区域的 `parameters.pagination` 明确覆盖。固定分页须写 mode=fixed、fixedPageSize 和 minimumTestPages，不能混入可调参数。按真实需要在区域的 `parameters.<capabilityId>` 覆盖其他参数。
-
-新流程额外固定 `app-shell/appearance/theme`，包含明亮／暗黑／清新／科技且默认明亮。原型 Skill 检查区域声明是否对应实际需求；检查器重算各区域的必需能力、参数与验收。定义检查不自动证明页面实现。
-
-## 创建与验收
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs create --project <project-root> --id assets --scope <project-root>/prototypes/.preparation/assets/scope.json --expert-mode professional --provider <uiux-root>
-```
-
-缺实际 scope 拒绝创建，不回退固定设备演示。初始化保存完整模板快照、scope、能力定义和绑定、框架版本、验收及需求映射，产生 Vue／antDv-next 骨架和四主题。主会话继续使用前端技能、官方框架知识和 UIUX 取舍实现业务。骨架是 `business.status=needs-adaptation`，state 下一步为 implement-business，不能作为已完成原型验收；完成实际页面后更新 adapted 并重新取得当前摘要。
-
-按 `inputs/acceptance.json` 的业务和框架场景执行真实浏览器操作，保存候选／构建身份、加载资源字节、截图、状态、焦点及错误证据，通过 record-run 导入；Chrome DevTools Skill 的六类观测另按现有合同登记。历史 `browser` 自动脚本只适用于设备列表固定合同，会拒绝新业务；不能用它的通过结果替代业务测试。报告结构及证据文件通过仍需原始工具记录证明真实执行。
-
-四主题必须覆盖真实 Table、Form、Drawer 及浮层，切换保留业务状态，刷新恢复偏好，实例隔离，并检查可访问性、窄屏和减少动效。新骨架默认具备切换机制；业务组件实现后仍需重新验证整页。已存在的 v1／v2 不自动迁移或追加新场景，按原固定输入继续迭代。

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

@@ -1,44 +0,0 @@
-# 企业管理后台复用
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-企业后台模板统一使用 i3-Composer 品牌，来源是工作区的 EASEL v0.14 HTML 审查成果。模板完整保留 326 个来源文件：运行页面、控件、样式、图标、规则测试、来源、许可及历史验收材料。原 history/easel-history 目录不修改。
-
-## 离线入口
-
-正式模板双击 `assets/templates/enterprise-admin/index.html` 打开，选择页入口为 `assets/templates/index.html`。可编辑 HTML 片段内嵌在 index.html，本地样式与资源跟随目录；内容／样式修改后刷新即可。离线脚本只替换模块与 fetch 加载方式，原始 reference/ 逐文件保留。新建 HTML 审查实例同样双击 app/index.html；历史模块实例仍沿用原合同和可选静态服务。
-
-完整内容模板也作为原生框架生成的参考，需求页面与通用能力选择见 [content-template.md](content-template.md)。HTML 不是被废弃的旧模板，小 HTML 试点才退出默认入口。
-
-## 完整示例与新业务
-
-- 用户要审查原来的整套后台时，使用 enterprise-admin 和 purpose=template-review，保留示例菜单与业务，便于和原版对照。
-- 用户要根据新业务做原型时，使用默认 business-prototype，先明确模块、字段、角色、状态和需求映射，修改原型副本中的相关文件；未适配状态 needs-adaptation 不能通过业务验收。
-- 审查完整示例不代表批准其全部示例业务，也不代表其他项目已完成业务适配。
-- 模板根 origin.json 保存全部来源文件的 SHA-256。reference/ 是完整来源快照，品牌转换不改写其中内容。预览响应与新生成实例共用品牌适配，页面标题、导航、示例项目及授权说明统一显示 i3-Composer；生成副本同时接入启动、设计 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/entry-contract.md

@@ -1,71 +0,0 @@
-# 入口与执行合同
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-本合同供自然语言、`/i3-prototype`、已加载的 `i3-using-agent-skills` 和直接 `i3-ui-prototype` 调用共用。主会话读取工作 Skill 并执行公共前置，命令和元技能只提供发现入口，详细流程留在工作 Skill。
-
-## 发现与执行
-
-| 入口 | 规则 |
-| --- | --- |
-| 自然语言制作、修改、分析或评审原型 | 主会话使用 `i3-ui-prototype` |
-| `/i3-prototype` | 主会话使用同一工作 Skill |
-| 已加载元技能 | 按普通原型路由使用同一工作 Skill |
-| 直接 `i3-ui-prototype` Skill | 当前主会话直接执行公共前置 |
-
-各入口不要求专责 Agent、常驻分派规则或父子回传。工作 Skill 不绕回命令或元技能。其他工程工作流已有的委派机制保持原有边界；任务若另有明确协作要求，按实际能力和授权处理，并保留一个源码／合同修改负责人。
-
-品牌发行的命令和 Skill 名称由发行映射决定。不要猜测宿主支持 `/i3-ui-prototype`、`$i3-ui-prototype` 或其他语法；以实际注册和验证结果为准。安装成功、文件存在或词法排名不证明宿主已经加载或执行 Skill。
-
-## 公共前置
-
-1. 保留用户原始要求及最新限制，读取项目规则、实际文件和原型清单。
-2. 识别 `analyze`、`create`、`revise`、`inspect` 或 `confirm-baseline`。无参数默认 create；明确分析或“不改代码／不写文件”优先。
-3. 核对项目位置、原型标识及版本、输入来源、模板工作副本、目标框架、设计要求、已确认决定与问题。恢复写任务前核对 revision 和 candidate digest，保留用户手改及已认可基线。
-4. 核对当前主会话实际可用的官方资料、UIUX、文件和浏览器能力。按本次操作使用工作 Skill 的对应方法，不把计划或声明写成已完成执行。
-
-讨论 Skill、方案或“先分析”进入 analyze，不因出现“原型”而创建业务工程。生产页面实现和普通排错沿用对应工程流程。用户可持续用自然语言推进，无需重复请求已经给出的创建、修改、检查或主题启用授权。
-
-工具先以当前宿主和范围运行只读依赖检测，使用返回的固定实际 Node 入口。新工具位于宿主基址的 `tools/i3-prototype/`，旧项目 `.prototype-tools` 继续只读兼容。analyze 中缺失或不能执行时报告缺口，使用已有只读资料，不使用 npm exec／npx 自动安装或补缓存。工具准备授权仅覆盖明确目录，不扩展到业务文件、SDK、宿主设置或全局配置。
-
-## 按操作使用能力
-
-- analyze 的交付是需求／能力覆盖、模板与框架选型、交互验收计划和缺口。结论足够后交付，不逐组件实施，不执行制作阶段的 UIUX 采纳、构建或浏览器门禁。
-- create／revise 的界面实现使用 `i3-frontend-ui-engineering`；框架适配使用当前可调用的官方 Skill，或版本匹配的官方文档、类型和源码；专业模式按 `expert-adapter` 使用 UI/UX Pro Max。
-- 需要真实浏览器验收时使用 `i3-browser-testing-with-devtools`，适用观测及专项回归由 `interaction-acceptance` 定义。Skill 加载、真实查询、建议采用、构建和实际浏览器执行分别留证。
-
-只读限制贯穿下游技能和工具：不初始化、安装升级、持久化设计、更新执行状态或为结果格式写文件。用户单独要求保存分析文档时只执行该项写入。不写临时传输文件或探测可写目录。
-
-能力覆盖须核对绑定参数。PRD 要求可调页大小而 HTML 只有 `fixedPageSize: 10` 时，应报告部分覆盖及可写阶段所需适配；固定值不是默认值。分析完整交付不等于需求已经全部实现，后续实现计划也不构成额外审批门槛。
-
-## 交付与证据
-
-最后一次工具结果之后，用简短自然语言交付实际完成范围、结论、证据位置、缺项和下一项必要动作。分析留在会话；已有实例检查返回实际读取的身份。无须统一父子 JSON、`PROTOTYPE_RESULT_V1` 标记或 `validate-result.cjs` 前置校验。该工具可保留用于特定维护检查，其结构成功不证明业务完成、真实 QA 或宿主调用。
-
-原生 create／revise 仍按工作流程完成业务适配、设计取舍、构建、全部适用的真实验收和 finalize。交付前只读核对 state 中 `delivery.current`、revision、candidateDigest 与实际 `qa/delivery.json` 收据一致。旧构建、旧 QA 或过期收据不能作为当前成功证据。
-
-本轮 CodeBuddy 新原生流程仍要求主会话实际调用 `i3-browser-testing-with-devtools`，通过 Chrome DevTools MCP 取得当前候选／构建的 DOM／计算样式、截图、console、network、可访问性和性能观测，历史设备合同另外执行其固定 Playwright 专项回归；新完整业务按固定场景执行并 record-run。缺 Skill、MCP 或必需观测时整链未完成。脚本收据和 state 不证明真实调用；原始宿主记录与实际观测另核。其他宿主结果及旧 v1／已有 v2 的固定合同按事实单列，不隐式扩展历史验收。
-
-通过本地验证的候选保持 pending-review。只有真实用户对同一 revision／digest 的明确认可，且适用验收仍当前有效，才能确认基线。原型认可不自动批准工程 Plan、生产开发或发布。Legacy HTML 保留原摘要与运行合同。
-
-缺少证据、执行中断或结果不完整时报告实际完成和未完成部分，不补造成功结论。文件承担连续性，新会话从固定输入、版本及交接恢复，不依赖旧会话或 Agent ID。
-
-## 入口验收
-
-分别记录自然语言、命令、已加载元技能、直接 Skill、只读分析和连续修改的实际表现。记录宿主产品及版本、安装方式、模型、Skill 加载、实际工具与最终交付；CLI 不代替 IDE 证据，词法排序不代替宿主执行。
-
-| 测试 | 输入要点 | 证据 |
-| --- | --- | --- |
-| 自然语言 | 给业务简述、内容模板与框架要求，先只读分析 | 主会话 Skill 执行、公共前置、零项目写入 |
-| 命令 | `/i3-prototype analyze` 加项目和输入位置 | 命令解析、同一 Skill 和只读结果 |
-| 直接 Skill | 当前会话直接使用 `i3-ui-prototype`，保持只读 | Skill 加载与公共前置 |
-| 元技能 | 加载 `i3-using-agent-skills` 后提交原型任务 | 普通原型路由及工作 Skill 实际执行 |
-| 连续修改 | 创建后提出一次小修改，再从文件恢复 | 原型身份保持，手改和旧基线未覆盖 |
-
-只读项对项目树、清单、原型和安装状态做前后比较；已授权分析文档单独说明。执行日志可保存在测试项目之外，宿主自身会话日志与项目写入分开报告。每条入口均核对最后的自然语言交付；写流程核对当前收据，分析核对需求与固定参数冲突是否如实保留。模型、权限和是否全新会话按实际记录，不用上一轮结果证明本轮。

package/skills/i3-ui-prototype/references/execution-evidence.md

@@ -1,51 +0,0 @@
-# 原型调用记录：兼容合同
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-原型自动审计 Hook 已移除，安装器不再注册 prototype 组，旧事件入口不再采集、拦截、补调或阻止 Stop。原型会话继续按 Skill 正文实际加载适用技能、制作 UI、构建和验收；不要求 execution-begin、Hook 会话绑定或内部调用记录作为正常流程的前置。配置清理见 [Hooks 维护说明](../../../hooks/PROTOTYPE.md)。
-
-## 当前执行与验收
-
-正常 build、record-run、record-devtools-review、finalize 和 state 不进入 Hook 调用审计。审计字段显示 `auditHook=retired`、`invocationVerification=unverified`，不作为已通过的调用证明。固定输入、业务断言、依赖、实际构建、业务报告、浏览器证据与交付摘要仍按各自合同检查；缺少这些证据仍不能通过。
-
-原型 Skill 仍要求前端技能在首次 UI 写入前成功加载，适用时实际调用 antDv、UIUX 和浏览器技能。读取 SKILL.md、模型自述或已有审计状态不能代替真实调用。移除自动回调不承诺自动发现或阻止所有漏调。
-
-## 安装与历史保留
-
-新装不创建原型审计注册。升级按精确归属清理所选宿主范围的旧注册，归属记录归档到 `state/i3-prototype/history/`；用户配置、其他 Hook、旧会话与原型保留。手改或未知归属先停下报告，不能覆盖。旧 helper／参数仅兼容 check、disable／keep 清理；prototype enable 已拒绝。check 只读，不扫描原生日志、不构造新的调用证据。
-
-## 新实例的固定预期
-
-先固定 scope，运行：
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs execution-assertions-template --scope <scope-file>
-```
-
-返回所有适用业务／框架场景及 `checks: []`。依据 PRD、绑定参数、框架场景填写每项检查，再传 `create --host <codebuddy|workbuddy> --execution-policy buddy-ab-v2 --execution-assertions <file>`。这个读取命令没有写入副作用。文件置于 `prototypes/.preparation/<id>/`；不更改随包 HTML 模板。每个场景至少一条，不能漏场景或用 `passed` 作实际事实；预期随其他 inputs 固定，不在验收后改到与结果一致。
-
-```json
-{"scenarioId":"orders/list/form-validation","checks":[
-  {"method":"evaluate_script","pointer":"/form/invalidFields","operator":"equals","expected":1}
-]}
-```
-
-实际原生 evaluate_script 应读取真实 DOM／组件可观察状态并返回可解析 JSON（或唯一 JSON 代码块），例如 `{"form":{"invalidFields":1}}`。使用正常 click／fill 等完成业务操作，不在求值中直接修改业务状态制造通过。支持 equals、includes、gte、lte，JSON pointer 路径必须存在。视觉、语义、动效中间态、毛玻璃呈现仍按浏览器 Skill 方法复核，数值检查不代替人工质量判断。
-
-## 历史 execution-* 兼容
-
-已有 execution-policy、execution-context、execution-evidence 和原始审计报告保留，不自动改写。显式 `execution-begin`、`execution-template`、`execution-check` 及底层协议回放仍可用于历史资料检查，它们继续要求原合同的真实来源、身份与引用；没有来源时如实报告 unverified／failed。这些命令的历史审计失败不再接管正常原型构建或交付。
-
-历史格式中的 runId、sessionId、projectKey、输入／候选摘要、toolCallId 与 resultDigest 只描述对应旧会话。旧 recovered 只表示当时观察到补调和重试；不是当前模型的 Skill 调用证明或业务认可。旧宿主适配导出的纯回放函数仅用于兼容测试；两个可执行回调入口均不再执行审计。
-
-## 保持的边界
-
-旧 HTML、四主题、业务共享索引和 moduleIds→appliesTo 保持；跨宿主读取原型不继承旧调用证明。固定预期不能事后改成与失败结果一致，真实业务意见保留人工判断空间。实际宿主调用、静态测试、安装检查与业务验收分别记录。
-
-antDv 加载与本地 CLI 查询分别留证：`prototype-deps query --host <host> --scope project --project <project> --kind info --component Table --version 1.5.2` 使用解析的本地入口；知识版本与目标组件版本分别核对。probe 不是业务查询，退出零的错误内容仍失败，不自动安装依赖。