@givolt/i3-composer-agent 2.3.0 → 2.3.2

package/docs/ui-prototype-native/USAGE.md

@@ -0,0 +1,91 @@
+# 原型制作与续接
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+当前默认内容模板为完整企业管理后台，生成目标为 Vue3＋antDv-next。HTML 参考可以离线编辑；生成的框架工程需要安装依赖、构建并启动预览。安装方式见 [CodeBuddy 说明](../codebuddy-setup.md)。
+
+## 在 CodeBuddy 发起
+
+```text
+/i3-prototype analyze 根据 PRD 分析原型范围和模板适用能力，先不写入或安装
+/i3-prototype create 根据 PRD，参考完整 enterprise-admin 模板，生成 Vue3＋antDv-next 原型，ID 为 assets
+```
+
+自然语言、命令、using 选择及直接调用 Skill 均由主会话执行，无原型专责 Agent。using 按普通发现逻辑选择原型 Skill；原型流程按阶段复用前端、官方框架、UIUX 和浏览器能力，避免一次加载全部模板、依赖源码及历史日志。
+
+只读分析交付覆盖、选型、验收计划及缺口，不创建原型、安装依赖、启动浏览器或保存用户级记忆。创建／修订的写入限于本次项目与明确范围，长期记忆、全局配置及其他项目另需明确授权。
+
+## 可选官方 Skill 与后续检测
+
+从业务项目根运行：
+
+```sh
+node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --project .
+# 以下仅在明确选择安装后执行，可单独选 uiux 或 antdv：
+node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs install --project . --skills uiux,antdv
+```
+
+i3 默认不安装这两项依赖，跳过不永久禁用。后续补装后重新检测即可，无需重装 i3；必要时重载 CodeBuddy 窗口或新建会话让宿主发现。已有可用全局 UIUX 可复用，已有第三方技能和工具不覆盖。缺 Python 仅报告，不安装系统运行环境。官方正文、许可、版本和来源保留，详情见已安装 Skill 的 references/optional-skills.md。
+
+UIUX 专业模式为默认，缺少可用查询资源会提示，不静默降级；用户明确选择基础模板模式后仍完成同样业务功能、四主题和验收。安装依赖不会自动改变既有原型的模式、源码或证据。检测不代表真实宿主调用；CodeBuddy 仍须通过其 Skill 工具实际加载。
+
+antDv 官方 Skill 和组件库是独立部分：未安装 Skill 时可使用对应版本官方文档／类型／源码，记录实际渠道；生成工程仍需 antDv-next 库。新工具目录为对应宿主基址下的 tools/i3-prototype/antdv-cli，支持项目和全局安装；旧 .prototype-tools/antdv-cli 保留读取兼容；只读检测返回可执行的 Node 入口，也识别既有 .prototype-tools/node_modules 布局。固定 CLI 0.0.0-beta.1 的 1.5.2 知识仅作参考，目标组件库 1.5.3 仍核对实际类型／源码。不自动升级 CLI，不以 Error 文本、exit 0 或占位 lint 代替成功。
+
+## 内置模板与业务原型
+
+```sh
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs template-page --page models-page
+```
+
+默认只读使用 Skill 安装目录 assets/templates/enterprise-admin 中随版本发布的完整模板，业务项目不生成 ui-templates。可双击内置 index.html 离线查看；模板内容由维护者在 Skill 源码中修改、校验并随包发布，业务使用期间不修改安装目录。索引在内存只读计算，随生成时的模板、范围与能力快照固定到 inputs。业务修改直接落在 prototypes/<id>/app/，Skill 升级不隐式改写已有原型。
+
+只读取本次相关页面。完整索引提供参考页面、路由和资源清单，不表示自动理解或实现全部旧业务。已有 ui-templates 副本保留，不自动读取、覆盖或删除；明确需要其手工内容时，先显式 sync-template 该副本，再在 create 时传 --template-root <已有目录>。旧 prepare-template 命令继续用于兼容，不是新流程必需步骤。
+
+## 需求范围与创建
+
+主会话根据实际 PRD 整理 .prototype-preparation/assets/scope.json：逐页声明业务标题、referencePage、区域类型、需求原文及来源。列表适用查询、复选、分页、批量与状态反馈；编辑区域适用校验、保存失败保留和重试。豁免须有明确需求依据。不能漏报实际区域来逃避能力。
+
+新原型默认提供明亮、暗黑、清新、科技，默认明亮，无编号。列表默认可调分页 10／20／50，默认 10；在 scope 的区域参数中明确覆盖真实需要。旧实例仍按原有固定输入，不追溯修改。
+
+```sh
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs create --project . --id assets --scope .prototype-preparation/assets/scope.json --host codebuddy
+# 仅在明确选择基础模板模式后，增加 --expert-mode template。
+```
+
+必须提供有来源的 scope，不再自动回退设备演示需求。目标存在时先读取 state，按修订流程保留已有手改，不重新 create。初始化仅提供需求对应的原生框架骨架和主题，business.status 为 needs-adaptation；主会话继续实现实际业务页面、字段、模拟数据和交互后才可验收。
+
+## 实现、构建与真实验收
+
+按需使用 i3-frontend-ui-engineering、可调用的 antDv 官方 Skill、UIUX 查询和取舍。官方 Skill 可调用时先实际加载；无法调用时记录官方资料等效渠道。UIUX 的加载、真实查询、建议采用与效果验证分别有依据。
+
+```sh
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs build prototypes/assets --install
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs preview prototypes/assets
+```
+
+首次且允许安装工程依赖时用 --install，之后复用已安装依赖。业务流程覆盖查询、多选、分页、编辑抽屉、校验失败、提交失败、重试保存及列表同步；另验抽屉进入／退出、模糊遮罩、四主题保留状态、窄屏、键盘与焦点恢复。
+
+主会话实际加载 i3-browser-testing-with-devtools，通过 Chrome DevTools MCP 对当前构建检查 DOM／计算样式、截图、console、network、可访问性及性能。缺少工具时保留未验证；读取 Skill、只有截图或运行补充脚本不能冒充该链路通过。浏览器使用项目 localhost 和隔离测试环境。
+
+按 inputs/acceptance.json 的本次业务场景实测，保存真实报告，再登记：
+
+```sh
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-run prototypes/assets --report /absolute/path/actual-business-report.json
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-devtools-review prototypes/assets --report /absolute/path/actual-devtools-report.json
+node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
+```
+
+从 state 取得当前准确的 finalize／revise 命令；不要复用修改前摘要。结构校验及报告导入不证明真实 Skill 调用，仍须核对原始宿主调用记录。源码或固定输入变化后重建并重验受影响场景。native-pilot 的历史 browser 子命令仅服务旧设备合同，不适用于新完整模板业务。
+
+## 续接、兼容与交付
+
+新会话先 state 恢复身份、范围、模式、构建与证据，按 nextAction 继续，不重新生成覆盖。已有 v1 HTML 与旧 v2 原生实例按原合同检查，保留原摘要、手改和认可基线；小模板仅保留测试夹具，旧设备框架起点在 legacy-starter，不作为新生成入口。
+
+最终回复给出原型路径、范围、revision、实际模式、已执行检查、证据及未决项。完成本地技术验证仍为 pending-review，人工认可具体 revision／digest 后才能冻结基线；不把骨架、安装通过或自填报告当作业务完成。

package/docs/workbuddy-setup.md

@@ -82,3 +82,7 @@ npx @givolt/i3-composer-agent --workbuddy --scope global --yes --force
 [命令格式](https://www.codebuddy.cn/docs/cli/slash-commands) 和
 [项目目录说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Project)。
 目录落盘、发现与模型行为分别验收。
+
+## 可选原型工具
+
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。推荐使用 `npx @givolt/i3-composer-agent@2.3.2 --workbuddy --scope global --yes --prototype-skills uiux,antdv`；项目安装将 scope 改为 project。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。

package/evals/cases/i3-frontend-ui-engineering.json

@@ -31,6 +31,10 @@
       {
         "prompt": "Tag and publish the release",
         "owner": "i3-git-workflow-and-versioning"
+      },
+      {
+        "prompt": "Generate a reviewable interactive UI prototype from business requirements",
+        "owner": "i3-ui-prototype"
       }
     ]
   },
@@ -47,6 +51,18 @@
         "ARIA roles or semantic elements are used correctly",
         "Component state is managed deliberately rather than ad hoc"
       ]
+    },
+    {
+      "id": 2,
+      "kind": "dialogue",
+      "prompt": "An approved production design now needs a reusable accessible Vue form component. Separately, a product owner wants an interactive review prototype from an editable HTML reference. Explain the owner of each request and how frontend implementation guidance can support prototype work. Do not implement anything.",
+      "expected_output": "Production frontend ownership and prototype support are distinguished without duplicating or replacing either workflow",
+      "expectations": [
+        "Production component implementation remains in the frontend implementation method and the existing engineering workflow",
+        "The review-prototype request belongs to the prototype workflow in the main session, where frontend guidance can support actual interface implementation",
+        "Frontend guidance does not require creating a prototype, installing a dedicated prototype role or changing its general method",
+        "Prototype-specific version, baseline and acceptance ownership stays with the prototype workflow; no runtime work or human approval is invented"
+      ]
     }
   ]
 }

package/evals/cases/i3-ui-prototype.json

@@ -17,6 +17,22 @@
       {
         "prompt": "Iterate the interactive prototype using review feedback and preserve the approved baseline",
         "top_k": 1
+      },
+      {
+        "prompt": "Use this editable HTML reference to generate a device management prototype with native Vue and antDv-next components",
+        "top_k": 1
+      },
+      {
+        "prompt": "Analyze a plan for turning this content template and business brief into an interactive prototype, without changing any files",
+        "top_k": 1
+      },
+      {
+        "prompt": "Revise the prototype using my feedback and preserve my manual edits while reviewing the drawer animation",
+        "top_k": 1
+      },
+      {
+        "prompt": "Use the prototype skill directly to inspect our review candidate without starting another agent",
+        "top_k": 1
       }
     ],
     "negative": [
@@ -27,6 +43,14 @@
       {
         "prompt": "Optimize slow database indexes",
         "owner": "i3-performance-optimization"
+      },
+      {
+        "prompt": "Implement the approved production design as an accessible reusable Vue form component",
+        "owner": "i3-frontend-ui-engineering"
+      },
+      {
+        "prompt": "Debug an existing application failure: the save request broke after a network error",
+        "owner": "i3-debugging-and-error-recovery"
       }
     ]
   },
@@ -44,6 +68,91 @@
         "A runnable prototype and verification evidence are produced; absent browser evidence is marked pending",
         "The prototype remains pending human review and no approved baseline is invented"
       ]
+    },
+    {
+      "id": 2,
+      "kind": "dialogue",
+      "prompt": "Use the i3-ui-prototype skill directly in this session to analyze how an editable HTML content template and capability list could produce a Vue 3 plus antDv-next device-list prototype. This is analysis only: do not change files, install or upgrade tools, persist design output, or start a separate agent.",
+      "expected_output": "A read-only prototype analysis that keeps direct Skill execution valid and states the framework, content, capability and acceptance boundaries",
+      "expectations": [
+        "The current executor runs the shared preflight without redispatching to an Agent, command or meta-skill",
+        "The response preserves analysis-only scope and does not initialize, install, persist design output or update project execution state",
+        "Editable content reference, reusable capabilities and target-framework behavior are explained as separate inputs",
+        "Unavailable provider, host or browser capabilities remain explicitly unverified rather than reported as executed",
+        "The analysis deliverable is the conversation; it does not invent prototype completion or human approval"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "Create a separate device-list review prototype with the admin-list editable content template and native Vue 3 plus antDv-next components. For this case explicitly use template mode. Requirements: 21 deterministic devices, 10 per page; filtering or changing page clears current-page selection; batch status changes affect only selected records; an edit drawer validates required name, preserves input on simulated save failure, retries, and updates the correct row. Verify normal drawer exit and mask blur on the current build when a real browser is available. Preserve any existing prototype and leave this candidate for human review.",
+      "expected_output": "An isolated native component prototype with fixed capability inputs, reproducible local data, current-build verification or a truthful verification gap",
+      "files": [
+        "i3-ui-prototype"
+      ],
+      "expectations": [
+        "The instance uses the native framework runtime and fixed template, capability, scope and framework inputs rather than converting an existing legacy instance",
+        "Real antDv-next components implement filtering, current-page selection, pagination and the edit flow with deterministic isolated mock state",
+        "Required capability bindings remain independently checkable and are not removed or arbitrarily marked inapplicable to make checks pass",
+        "The executor distinguishes source inspection, successful build and real browser execution; unavailable checks remain unverified",
+        "Browser evidence, when present, refers to the current candidate and actual build, with drawer motion and blur verified separately from static screenshots",
+        "Template mode is explicit and does not claim UIUX use; existing prototypes remain unchanged and no human baseline approval is invented"
+      ]
+    },
+    {
+      "id": 4,
+      "kind": "dialogue",
+      "prompt": "Inspect this prototype verification claim without modifying files: the source was changed after testing, the server still serves the previous build, and the only evidence is a screenshot plus a report manually marked passed. A teammate suggests removing the pagination capability and marking it inapplicable so we can approve the candidate. Explain the valid next step; do not execute a new test or approve a baseline.",
+      "expected_output": "A read-only rejection of stale evidence and unsupported exemption, with concrete required revalidation and pending human review",
+      "expectations": [
+        "The changed candidate and previous build invalidate the supplied acceptance claim",
+        "A screenshot or manually passed report is not treated as proof of current-build browser execution or drawer animation",
+        "Pagination remains required unless an explicit requirement or scope-change source justifies an exemption",
+        "The response proposes rebuilding and revalidating against fixed inputs without claiming those actions already occurred",
+        "No files are changed, no tests are pretended, and human baseline approval remains separate"
+      ]
+    },
+    {
+      "id": 5,
+      "kind": "dialogue",
+      "prompt": "In this main session, analyze an editable admin-list HTML reference and a business brief for a Vue 3 plus antDv-next review prototype. Keep this read-only. The host has no dedicated prototype role and no parent-child JSON transport. State the useful analysis and next steps without installing tools or running creation-stage checks.",
+      "expected_output": "A complete read-only main-session analysis with useful coverage and a truthful acceptance plan",
+      "expectations": [
+        "The main session directly applies the shared prototype preflight without requiring or simulating a dedicated Agent",
+        "The analysis delivers requirement and bound-capability coverage, template and framework selection, acceptance planning and concrete gaps",
+        "No initialization, installation, persisted design, project state update, build, browser run or creation-stage UIUX adoption gate occurs",
+        "No parent-child JSON, PROTOTYPE_RESULT_V1 marker or validate-result execution is made a prerequisite for the natural-language deliverable",
+        "Unavailable capabilities and fixed-parameter conflicts remain visible; analysis completion is distinct from implemented coverage and human approval"
+      ]
+    },
+    {
+      "id": 6,
+      "prompt": "Create a separate native Vue 3 plus antDv-next device-list review candidate from the editable admin-list reference. Use template mode explicitly. I authorize four in-page themes named 明亮、暗黑、清新、科技, defaulting to 明亮. Enable and fix the theme requirement in my HTML working copy, preserve business state while switching, and preserve all existing prototypes and manual edits. Do not ask again whether themes are wanted. Keep fixed required capabilities and verify the current build when the specified browser tools are available.",
+      "expected_output": "A main-session native review candidate with explicitly fixed four-theme inputs, preserved state and truthful current-build evidence or gaps",
+      "files": [
+        "i3-ui-prototype"
+      ],
+      "expectations": [
+        "The main session uses the prototype workflow and supporting frontend and version-matched official framework knowledge for actual implementation, without requiring a dedicated persona",
+        "The authorized theme capability is bound in the user HTML working copy and fixed with its requirement source rather than left disabled or sent for repeat confirmation",
+        "The generated framework implements the four exact theme names, defaults to 明亮, and verifies that business state survives theme changes",
+        "Existing or unrequested-theme instances, user edits and approved baselines remain unchanged",
+        "Template mode does not claim UIUX use; fixed required capabilities and applicable acceptance scenarios are retained",
+        "Build, actual browser Skill and DevTools observations, supplemental regression and current delivery evidence are distinguished; unavailable checks remain incomplete",
+        "The final natural-language delivery identifies the candidate, current evidence and gaps, and leaves human review pending without requiring a parent-child result envelope"
+      ]
+    },
+    {
+      "id": 7,
+      "kind": "dialogue",
+      "prompt": "Compare how you would handle three requests: analyze a prototype plan without writing; revise the prototype drawer interaction for review; implement the approved drawer as a reusable production component. Explain which skills and evidence apply to each, without executing the requests.",
+      "expected_output": "Operation-specific support and a clear boundary between prototype work and production frontend engineering",
+      "expectations": [
+        "Read-only prototype analysis uses only material needed for coverage and selection and plans later verification without executing it",
+        "Prototype interaction revision stays within prototype workflow ownership and uses frontend, official framework and browser capabilities when the revision requires them",
+        "Professional UIUX lookup, adoption and effect verification remain distinct and apply to professional design work, with no silent downgrade to template mode",
+        "Approved production component implementation follows the frontend implementation method and the existing engineering workflow rather than creating a new review prototype",
+        "No claim of completed runtime checks or human baseline approval is made"
+      ]
     }
   ]
 }

package/evals/cases/i3-using-agent-skills.json

@@ -23,6 +23,10 @@
       {
         "prompt": "Make the modal accessible for keyboard users",
         "owner": "i3-frontend-ui-engineering"
+      },
+      {
+        "prompt": "Generate a reviewable interactive UI prototype from business requirements",
+        "owner": "i3-ui-prototype"
       }
     ]
   },
@@ -39,6 +43,30 @@
         "The rationale references the routing logic rather than guessing",
         "Core operating behaviors (assumptions surfaced) are respected"
       ]
+    },
+    {
+      "id": 2,
+      "kind": "dialogue",
+      "prompt": "A user asks for a device-management review prototype from an editable HTML reference and a short business brief. Choose the applicable skill and explain the next step in this session; do not create files or launch a separate task.",
+      "expected_output": "Ordinary routing to i3-ui-prototype in the main session, with operation and scope decided by the working skill",
+      "expectations": [
+        "The meta-skill selects the prototype workflow for reviewable prototype work",
+        "The main session uses the working skill without requiring a dedicated persona, persistent routing rule or parent-child result protocol",
+        "Detailed operation, framework and acceptance decisions remain in the prototype workflow rather than being copied into the meta-skill",
+        "The requested read-only routing explanation does not initialize a prototype or claim implementation"
+      ]
+    },
+    {
+      "id": 3,
+      "kind": "dialogue",
+      "prompt": "Two tasks arrive separately: implement an approved production Vue form component with keyboard support; inspect a review prototype against its approved baseline. Route each task and explain how the existing engineering workflow still applies. Do not perform either task.",
+      "expected_output": "Separate routing for production engineering and prototype review without changing the general lifecycle",
+      "expectations": [
+        "Production UI implementation follows the engineering workflow with the frontend implementation method",
+        "Prototype fidelity inspection selects the prototype workflow",
+        "The prototype route does not replace generic planning, implementation or review methods or impose prototype-specific delegation on them",
+        "The response does not invent runtime verification or human approval"
+      ]
     }
   ]
 }

package/evals/fixtures/i3-ui-prototype/admin-list/assets/reference.css

@@ -0,0 +1,3 @@
+:root{font-family:system-ui,-apple-system,"Segoe UI",sans-serif;color:#202936;background:#f5f7fa;line-height:1.5;font-synthesis:none;--border:#dce2ea;--primary:#245bc7}
+*{box-sizing:border-box}body{margin:0}main{max-width:1360px;margin:auto;padding:40px 32px}h1{font-size:30px;letter-spacing:-.02em;margin:4px 0 8px}h2{font-size:18px;margin:0 0 20px}.eyebrow{font-size:11px;letter-spacing:.14em;color:#66758b;font-weight:700}.page-heading>p:last-child,.hint,footer{color:#647287;font-size:13px}.page-heading{margin-bottom:28px}.workspace{display:grid;grid-template-columns:minmax(0,1fr) 300px;gap:20px}.panel{background:#fff;border:1px solid var(--border);border-radius:10px;padding:24px}.filters{display:flex;gap:12px;align-items:end;flex-wrap:wrap}label{display:flex;flex-direction:column;gap:6px;font-size:13px}input,select,button{font:inherit;border:1px solid #cdd5e1;border-radius:5px;background:white;color:inherit;padding:8px 10px}input:focus-visible,select:focus-visible,button:focus-visible{outline:3px solid #b6d0ff;outline-offset:2px}button{cursor:pointer;font-size:13px;min-height:36px}button:hover{border-color:var(--primary)}button.primary{background:var(--primary);color:#fff;border-color:var(--primary)}input[type=checkbox]{width:16px;height:16px;padding:0;accent-color:var(--primary)}.toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:22px 0 6px;font-size:12px}.toolbar>span{margin-right:auto;color:#647287}.table-scroll{overflow:auto}table{width:100%;border-collapse:collapse;text-align:left;white-space:nowrap;font-size:13px}th,td{border-bottom:1px solid #e9edf3;padding:14px 12px}th{background:#f8fafc;font-weight:600}th:first-child,td:first-child{width:42px}.badge{display:inline-block;color:#24794e;background:#eef8f2;border-radius:4px;padding:2px 8px;font-size:12px}.badge.muted{color:#657184;background:#f0f2f5}.pagination{display:flex;align-items:center;justify-content:end;gap:10px;margin:22px 0;font-size:12px;flex-wrap:wrap}.pagination label{flex-direction:row;align-items:center}.pagination select{padding:6px}.state-reference{border-top:1px dashed var(--border);padding-top:18px;font-size:12px;color:#647287}.state-reference label{max-width:230px}.state-message{min-height:24px;margin:10px 0 0}.editor label{margin-bottom:16px}.editor input,.editor select{width:100%}.editor-actions{display:flex;justify-content:end;gap:8px;margin:22px 0}.editor ul{padding-left:18px}.editor li{margin:8px 0}footer{margin-top:22px}a{color:var(--primary)}
+@media(max-width:1000px){.workspace{grid-template-columns:1fr}.editor{max-width:none}}@media(max-width:600px){main{padding:24px 14px}.panel{padding:18px}.filters>label{width:100%}.pagination{justify-content:start}h1{font-size:26px}}

package/evals/fixtures/i3-ui-prototype/admin-list/assets/reference.js

@@ -0,0 +1,8 @@
+'use strict';
+// This reference only switches sample state text. Framework behavior belongs to the generated prototype.
+document.querySelectorAll('[data-field-id="preview-state"]').forEach(function (control) {
+  control.addEventListener('change', function () {
+    var messages = { success: '已展示示例内容。', loading: '正在加载设备…', empty: '未找到匹配设备，可调整条件。', error: '设备加载失败，请重试；已有输入应保留。' };
+    control.closest('[data-capability-id]').querySelector('[data-preview-message]').textContent = messages[control.value];
+  });
+});

package/evals/fixtures/i3-ui-prototype/admin-list/capability-definition.json

@@ -0,0 +1,67 @@
+{
+  "schemaVersion": 1,
+  "id": "admin-list",
+  "version": "1.2.0",
+  "regionModes": ["management-list", "edit-form"],
+  "capabilities": [
+    {
+      "id": "theme", "title": "可选命名主题", "appliesTo": ["management-list"], "requirement": "optional",
+      "parameters": {"defaultTheme": {"type": "string", "required": true, "enum": ["light"]}, "presets": {"type": "array", "required": true, "includes": ["light", "dark", "fresh", "tech"]}},
+      "scenarios": [
+        {"id": "switch", "title": "原生组件主题一致且保留业务状态", "expected": "明亮、暗黑、清新、科技按名称选择；Table/Form/Drawer/Select浮层同步，切换不重挂、不丢筛选选择与未保存输入"},
+        {"id": "persistence", "title": "实例主题偏好隔离与恢复", "expected": "独立namespace主题键，刷新恢复；同源第二实例隔离；坏缓存与拒存储安全回退"},
+        {"id": "accessibility", "title": "四主题可访问与窄屏", "expected": "实际文字对比度、键盘焦点、320/375窄屏和减少动效均可验证"}
+      ]
+    },
+    {
+      "id": "filter", "title": "查询与重置", "appliesTo": ["management-list"], "requirement": "required",
+      "parameters": {"resetPage": {"type": "boolean", "required": true, "enum": [true]}, "clearSelection": {"type": "boolean", "required": true, "enum": [true]}},
+      "scenarios": [
+        {"id": "query", "title": "查询命中与无结果", "expected": "条件只显示匹配记录，无匹配时显示空结果"},
+        {"id": "reset", "title": "重置查询", "expected": "条件清空、回到第一页并清空选择"}
+      ]
+    },
+    {
+      "id": "selection", "title": "当前页多选", "appliesTo": ["management-list"], "requirement": "required",
+      "parameters": {"strategy": {"type": "string", "required": true, "enum": ["current-page-clear-on-change"]}},
+      "scenarios": [
+        {"id": "select-page", "title": "单选、全选与部分选中", "expected": "选中数量和当前页全选状态与记录一致"},
+        {"id": "clear-on-change", "title": "换页或筛选清空选择", "expected": "翻页或重新筛选后选中数量为零"}
+      ]
+    },
+    {
+      "id": "pagination", "title": "分页", "appliesTo": ["management-list"], "requirement": "required",
+      "parameters": {
+        "mode": {"type": "string", "required": false, "enum": ["fixed", "adjustable"], "default": "fixed"},
+        "fixedPageSize": {"type": "integer", "required": false, "minimum": 1, "requiredInMode": "fixed"},
+        "defaultPageSize": {"type": "integer", "required": false, "minimum": 1, "requiredInMode": "adjustable"},
+        "pageSizeOptions": {"type": "array", "required": false, "items": {"type": "integer", "minimum": 1}, "minItems": 2, "uniqueItems": true, "requiredInMode": "adjustable"},
+        "minimumTestPages": {"type": "integer", "required": true, "minimum": 3}
+      },
+      "scenarios": [
+        {"id": "pages", "title": "默认容量下至少三页记录", "expected": "按固定容量或可调模式的默认容量核对首、中、末页及总数"},
+        {"id": "page-size", "title": "绑定分页容量", "expected": "fixed 只允许 fixedPageSize 且无容量切换；adjustable 只允许 defaultPageSize 与唯一正整数 pageSizeOptions，默认值必须包含其中；实际切换每个绑定选项并恢复默认值，重置页码与选择"}
+      ]
+    },
+    {
+      "id": "bulk", "title": "批量状态变更", "appliesTo": ["management-list"], "requirement": "required",
+      "parameters": {"target": {"type": "string", "required": true, "enum": ["selected-only"]}},
+      "scenarios": [{"id": "selected-only", "title": "批量操作正确对象", "expected": "未选择时禁用；操作只更新选中记录并反馈结果"}]
+    },
+    {
+      "id": "edit", "title": "编辑表单", "appliesTo": ["edit-form"], "requirement": "required",
+      "parameters": {"presentation": {"type": "string", "required": true, "enum": ["drawer"]}, "preserveOnFailure": {"type": "boolean", "required": true, "enum": [true]}},
+      "scenarios": [
+        {"id": "validation", "title": "必填校验", "expected": "空名称不保存并定位错误"},
+        {"id": "save", "title": "保存同步", "expected": "保存后列表中的正确记录更新，其他记录不变"},
+        {"id": "retry", "title": "提交失败与重试", "expected": "失败保留输入，重试成功后同步列表"},
+        {"id": "drawer-motion", "title": "抽屉进入退出与模糊遮罩", "expected": "进入退出动画完整，关闭后恢复焦点和滚动，遮罩实际具有滤镜"}
+      ]
+    },
+    {
+      "id": "feedback", "title": "数据状态与反馈", "appliesTo": ["management-list", "edit-form"], "requirement": "required",
+      "parameters": {"states": {"type": "array", "required": true, "includesByMode": {"management-list": ["loading", "empty", "error", "success"], "edit-form": ["loading", "error", "success"]}}},
+      "scenarios": [{"id": "states", "title": "适用状态可触发并恢复", "expected": "绑定 states 中的各状态可确定性触发；失败后保留必要输入，恢复后显示正确数据"}]
+    }
+  ]
+}

package/evals/fixtures/i3-ui-prototype/admin-list/index.html

@@ -0,0 +1,89 @@
+<!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="stylesheet" href="assets/reference.css">
+  <script src="assets/reference.js" defer></script>
+</head>
+<body>
+  <!-- 修改文案、字段或排列即可预览；page/region 身份保持稳定。复制区域请生成新的 region-id。 -->
+  <main data-page-id="devices">
+    <header class="page-heading">
+      <p class="eyebrow">ADMIN LIST / CONTENT REFERENCE</p>
+      <h1>设备管理</h1>
+      <p data-content-id="page-description">管理设备档案与运行状态。此页是可编辑的内容参考，最终原型由目标框架生成。</p>
+    </header>
+
+    <div class="workspace">
+      <section class="panel" data-region-id="device-list" data-region-mode="management-list" aria-labelledby="list-title">
+        <h2 id="list-title">设备清单</h2>
+        <!-- OPTIONAL_FOUR_THEMES: 用户明确要求四主题时，在项目工作副本中解开下面这一段注释，再按 readme.md 补充 scope 来源并同步。
+        <aside data-capability-id="theme" data-capability-parameters='{"defaultTheme":"light","presets":["light","dark","fresh","tech"]}'>
+          页面主题：明亮、暗黑、清新、科技；首次默认明亮。
+        </aside>
+        -->
+        <div class="filters" data-capability-id="filter" data-capability-parameters='{"resetPage":true,"clearSelection":true}'>
+          <label>设备名称<input data-field-id="query-name" placeholder="输入设备名称"></label>
+          <label>设备状态<select data-field-id="query-status"><option>全部状态</option><option>运行中</option><option>已停用</option></select></label>
+          <button class="primary" data-action-id="query" type="button">查询</button>
+          <button data-action-id="reset-query" type="button">重置</button>
+        </div>
+
+        <div class="toolbar" data-capability-id="bulk" data-capability-parameters='{"target":"selected-only"}'>
+          <span>批量操作只影响选中记录</span>
+          <button data-action-id="bulk-disable" type="button">批量停用</button>
+        </div>
+
+        <div data-capability-id="selection" data-capability-parameters='{"strategy":"current-page-clear-on-change"}'>
+          <p class="hint">已选择 <strong>0</strong> 项 · 翻页或筛选后清空选择</p>
+          <div class="table-scroll">
+            <table>
+              <thead><tr>
+                <th><input type="checkbox" data-field-id="select-page" aria-label="选择当前页"></th>
+                <th data-field-id="device-code">设备编号</th>
+                <th data-field-id="device-name">设备名称</th>
+                <th data-field-id="device-category">分类</th>
+                <th data-field-id="device-status">状态</th>
+              </tr></thead>
+              <tbody>
+                <tr><td><input type="checkbox" data-field-id="select-example-1" aria-label="选择示例设备一"></td><td>DEV-001</td><td>一号循环泵</td><td>循环泵</td><td><span class="badge">运行中</span></td></tr>
+                <tr><td><input type="checkbox" data-field-id="select-example-2" aria-label="选择示例设备二"></td><td>DEV-002</td><td>二号换热器</td><td>换热器</td><td><span class="badge muted">已停用</span></td></tr>
+              </tbody>
+            </table>
+          </div>
+        </div>
+
+        <nav class="pagination" aria-label="列表分页" data-capability-id="pagination" data-capability-parameters='{"fixedPageSize":10,"minimumTestPages":3}'>
+          <span>共 21 条</span><button data-action-id="previous-page" type="button">上一页</button>
+          <span aria-current="page">1 / 3</span><button data-action-id="next-page" type="button">下一页</button>
+          <span>每页 10 条</span>
+        </nav>
+
+        <div class="state-reference" data-capability-id="feedback" data-capability-parameters='{"states":["loading","empty","error","success"]}'>
+          <label>数据状态示例<select data-field-id="preview-state"><option value="success">正常</option><option value="loading">加载</option><option value="empty">空结果</option><option value="error">失败</option></select></label>
+          <p class="state-message" role="status" data-preview-message>已展示示例内容。</p>
+        </div>
+      </section>
+
+      <aside class="panel editor" data-region-id="device-editor" data-region-mode="edit-form" aria-labelledby="editor-title">
+        <div data-capability-id="edit" data-capability-parameters='{"presentation":"drawer","preserveOnFailure":true}'>
+          <h2 id="editor-title">编辑设备</h2>
+          <button data-action-id="edit" type="button">编辑</button>
+          <p class="hint">最终原型以右侧抽屉呈现，并保留完整进入、退出和焦点恢复。</p>
+          <label>设备编号<input data-field-id="edit-code" value="DEV-001" readonly></label>
+          <label>设备名称 <span aria-label="必填">*</span><input data-field-id="edit-name" value="一号循环泵" required></label>
+          <label>分类<select data-field-id="edit-category"><option>循环泵</option><option>换热器</option><option>传感器</option></select></label>
+          <label>状态<select data-field-id="edit-status"><option>运行中</option><option>已停用</option></select></label>
+          <div class="editor-actions"><button data-action-id="cancel-edit" type="button">取消</button><button data-action-id="save-edit" class="primary" type="button">保存</button></div>
+        </div>
+        <div class="state-reference" data-capability-id="feedback" data-capability-parameters='{"states":["loading","error","success"]}'>
+          <p>提交结果示例</p><ul><li>处理中：按钮显示提交状态。</li><li>失败：保留输入并可重试。</li><li>成功：更新正确记录并关闭抽屉。</li></ul>
+        </div>
+      </aside>
+    </div>
+    <footer>修改后可直接刷新；生成前运行模板同步，核对内容与能力绑定。</footer>
+  </main>
+</body>
+</html>

package/evals/fixtures/i3-ui-prototype/admin-list/readme.md

@@ -0,0 +1,52 @@
+# 管理列表内容模板
+
+双击 `index.html` 可离线查看；直接修改 HTML，再刷新页面即可预览。安装包中的文件是起点，日常编辑项目里的 `ui-templates/admin-list/` 工作副本；重新准备模板不会覆盖已有副本。
+
+## 首期内容投影
+
+同步后，新建的 Vue＋antDv-next 原型会把以下内容写入自己的 `app/public/prototype-config.json`，由真实组件读取并展示：
+
+- 页面首个 `h1` 标题，以及 `data-content-id="page-description"` 的说明。
+- 两个区域的首个 `h2`，分别作为列表与编辑标题。
+- 现有表头、筛选字段与编辑字段的可见标签。支持包裹式 `label`、`label for`、嵌套文字和 HTML 字符实体；`data-label` 可明确覆盖标签。
+- 已有输入框的 placeholder；设备名称必填规则继续保留。
+- 查询、重置、批量停用、编辑、保存、取消、上一页和下一页的可见文案。
+
+`page-id`、`region-id`、`field-id`、`action-id` 是稳定身份，改文案时保留它们。内容绑定在生成实例时固定；之后再改模板，只影响明确使用新模板创建的候选，不会更新已有原型。
+
+首期不是通用 HTML 到 Vue 编译器。新增或删除页面、区域、字段、操作，改字段含义、枚举值、数据模式、列顺序或行为参数时，需要主会话执行者明确适配框架代码、能力映射与验收。未知字段/操作、缺少首期必需项和删除名称必填会阻止初始化，避免内容静默消失。HTML 的 CSS 与普通 JS 只服务内容参考；生成工程采用真实框架样式和行为。
+
+示例行、选择框和数据状态下拉用于参考预览；固定 21 条设备数据及其状态逻辑由原型演示需求定义。分类、状态文案与数据枚举的变更需要显式业务映射，不凭选项文字自动猜测。
+
+## 同步与生成
+
+修改 HTML 后先执行 `sync-template.cjs <模板工作目录>`；只读核对使用 `--check`。不同宿主通过 i3-ui-prototype Skill 提供的统一入口运行这些步骤。同步会重新检查身份、能力参数和索引摘要；通过后才能创建新候选。索引是派生产物，不直接编辑。
+
+## 按本次需求启用四主题
+
+默认 HTML 不绑定主题，旧 HTML、v1 和未绑定主题的 v2 实例保持原行为。本次用户要求“明亮、暗黑、清新、科技，默认明亮，页面内选择”时，先准备项目工作副本，在 `devices/device-list` 下找到 `OPTIONAL_FOUR_THEMES` 注释，仅去掉包住 `aside` 的注释边界，保留这段内容：
+
+```html
+<aside data-capability-id="theme" data-capability-parameters='{"defaultTheme":"light","presets":["light","dark","fresh","tech"]}'>
+  页面主题：明亮、暗黑、清新、科技；首次默认明亮。
+</aside>
+```
+
+在本次 `scope.json` 的 `requirements` 中保留已有需求并追加下列结构；`source.reference` 填本次真实用户消息或需求文件的准确定位，`statement` 保留确认的需求原意：
+
+```json
+{
+  "id": "THEME-01",
+  "text": "页面可选择明亮、暗黑、清新、科技四主题，首次默认明亮",
+  "source": {
+    "type": "user",
+    "reference": "<本次真实需求的准确定位>",
+    "statement": "本次生成原型四主题可页面选择：明亮、暗黑、清新、科技，默认明亮"
+  },
+  "capabilities": [{"pageId":"devices","regionId":"device-list","capabilityId":"theme"}]
+}
+```
+
+同步、只读检查工作模板，再用该工作目录和 `--scope <本次scope.json>` 创建新实例。生成结果读取固定绑定，使用真实 antDv-next `ConfigProvider`、`Select` 和语义 token；页面与抽屉内均有主题选择，浮层跟随主题。离线 HTML 仍可双击编辑，这段文字本身不模拟原生换肤。
+
+固定验收从基础 20 项增加到 23 项；额外三项验证四主题效果、偏好持久化与隔离、可访问性，并核对第二页、筛选、选择和抽屉未保存输入保持。新模板不会更新旧实例；已有实例新增主题必须按已授权范围显式 `revise --accept-inputs`，不能只改运行配置。

package/evals/fixtures/i3-ui-prototype/admin-list/template.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "id": "admin-list",
+  "version": "1.0.0",
+  "title": "管理列表内容模板",
+  "entry": "index.html",
+  "definition": "capability-definition.json"
+}

package/evals/zh-CN/cases/i3-frontend-ui-engineering.json

@@ -23,6 +23,10 @@
       {
         "prompt": "按照现有任务计划增量实现 CSV 导出，每个切片都验证。",
         "owner": "i3-incremental-implementation"
+      },
+      {
+        "prompt": "选择 UI 原型模板，制作一个可操作的申请审批交互原型供评审。",
+        "owner": "i3-ui-prototype"
       }
     ]
   },
@@ -40,6 +44,19 @@
         "Component state is managed deliberately rather than ad hoc",
         "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
       ]
+    },
+    {
+      "id": 1002,
+      "kind": "dialogue",
+      "prompt": "已认可的生产设计需要实现为可复用、可访问的 Vue 表单组件。另有产品负责人希望根据可编辑 HTML 参考制作交互评审原型。请说明两个请求各由哪项工作流负责，以及前端实现方法如何支持原型工作。不执行任何实现。",
+      "expected_output": "Production frontend ownership and prototype support are distinguished without duplicating or replacing either workflow",
+      "expectations": [
+        "Production component implementation remains in the frontend implementation method and the existing engineering workflow",
+        "The review-prototype request belongs to the prototype workflow in the main session, where frontend guidance can support actual interface implementation",
+        "Frontend guidance does not require creating a prototype, installing a dedicated prototype role or changing its general method",
+        "Prototype-specific version, baseline and acceptance ownership stays with the prototype workflow; no runtime work or human approval is invented",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
     }
   ]
 }