@givolt/i3-composer-agent 2.3.2 → 2.3.4

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/generation-component-map.json

@@ -0,0 +1,300 @@
+{
+  "schemaVersion": 1,
+  "frameworkId": "vue-antdv-next",
+  "version": "1.0.0",
+  "boundary": "Native controls provide primitives. Business rules, graph behavior and persistence require application implementation and actual browser verification.",
+  "capabilities": {
+    "layout": {
+      "components": [
+        "Layout",
+        "LayoutHeader",
+        "LayoutSider",
+        "LayoutContent",
+        "Drawer"
+      ],
+      "applicationResponsibilities": [
+        "所选导航与内容布局实际呈现，区域顺序和滚动边界与固定选择一致",
+        "桌面、平板与窄屏主要内容和操作可达，不通过隐藏必需字段适配"
+      ]
+    },
+    "navigation": {
+      "components": [
+        "Menu",
+        "Breadcrumb",
+        "Button",
+        "Result"
+      ],
+      "applicationResponsibilities": [
+        "每个声明页面可达，当前项、返回、深链接及不存在页面状态正确",
+        "按固定规则检查折叠、移动菜单、返回后的筛选和页码状态"
+      ]
+    },
+    "accessibility": {
+      "components": [
+        "Form",
+        "Button",
+        "Input",
+        "Drawer"
+      ],
+      "applicationResponsibilities": [
+        "名称、标签、Tab顺序、焦点可见及主要操作键盘可达",
+        "实际文字与浮层可读；窄屏无阻断性裁剪，减少动效仍可操作"
+      ]
+    },
+    "theme": {
+      "components": [
+        "ConfigProvider",
+        "Select"
+      ],
+      "applicationResponsibilities": [
+        "明亮、暗黑、清新、科技均实际覆盖组件、浮层与外壳，默认明亮且切换保留业务状态",
+        "刷新恢复、非法偏好和拒绝存储安全回退，实例间隔离"
+      ]
+    },
+    "visual": {
+      "components": [
+        "ConfigProvider",
+        "Flex",
+        "Space"
+      ],
+      "applicationResponsibilities": [
+        "实际风格、间距密度、圆角、边框与阴影符合所选预设，未覆盖框架和客户明确要求"
+      ]
+    },
+    "interaction": {
+      "components": [
+        "Button",
+        "Form",
+        "Alert",
+        "Spin"
+      ],
+      "applicationResponsibilities": [
+        "每个声明业务操作有有效结果；不可用操作说明原因，忙碌时防止重复提交",
+        "操作失败后对象和输入保留，可按规定重试，不用提示文字冒充操作完成"
+      ]
+    },
+    "collection": {
+      "components": [
+        "Table",
+        "List"
+      ],
+      "applicationResponsibilities": [
+        "记录稳定身份、总数、可见行与行操作对象对应，不串记录",
+        "逐项检查列表工具栏和行操作，不以一个按钮代替全部操作"
+      ]
+    },
+    "filter": {
+      "components": [
+        "Form",
+        "Input",
+        "Select",
+        "TreeSelect",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "命中、无结果、重置正确；页码与选择按合同重置"
+      ]
+    },
+    "selection": {
+      "components": [
+        "Table.rowSelection",
+        "Checkbox"
+      ],
+      "applicationResponsibilities": [
+        "当前页单选、全选、半选及不可选记录正确",
+        "筛选、翻页或容量变化按约定清空选择"
+      ]
+    },
+    "pagination": {
+      "components": [
+        "Table.pagination",
+        "Pagination"
+      ],
+      "applicationResponsibilities": [
+        "默认容量覆盖首中末页，总数与实际行一致",
+        "逐一切换固定选项、恢复默认，页码及选择符合约定"
+      ]
+    },
+    "bulk": {
+      "components": [
+        "Button",
+        "Alert",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "无选择不可提交，只影响选中身份；成功范围与失败策略来自本次PRD"
+      ]
+    },
+    "feedback": {
+      "components": [
+        "Spin",
+        "Empty",
+        "Alert",
+        "Result",
+        "message"
+      ],
+      "applicationResponsibilities": [
+        "逐区域触发加载、无数据、筛选无结果、失败和恢复；不存在记录与权限限制有明确状态"
+      ]
+    },
+    "columns": {
+      "components": [
+        "Table",
+        "Checkbox",
+        "Dropdown",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "显示／隐藏、上移／下移、锁定列和恢复默认均生效",
+        "刷新恢复约定列偏好，存储失败仍可本轮操作，宽表可滚动且操作列可达"
+      ]
+    },
+    "deletion": {
+      "components": [
+        "Modal",
+        "Alert",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "核对对象身份、数量、可删除与受阻原因，取消不改变数据",
+        "失败保留选择；记录变化重新核对，结果与本次PRD的整批／部分成功策略一致"
+      ]
+    },
+    "edit": {
+      "components": [
+        "Form",
+        "FormItem",
+        "Input",
+        "Select",
+        "Drawer",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "字段类型、必填、格式、长度、联动和只读状态逐项对应需求",
+        "校验失败定位字段，提交失败保留输入，再试成功更新正确记录"
+      ]
+    },
+    "dirty": {
+      "components": [
+        "Modal",
+        "Drawer",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "关闭、返回、切页和身份变化按约定保留／确认丢弃，不静默丢失输入",
+        "需要草稿恢复时验证恢复与版本；不需要时明确丢弃策略"
+      ]
+    },
+    "dialog": {
+      "components": [
+        "Drawer",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "实际打开与关闭的生命周期完整，抽屉进出中间态存在，未提前卸载",
+        "遮罩、Escape、取消、背景滚动与焦点恢复符合固定呈现参数，嵌套弹层不串状态"
+      ]
+    },
+    "menu": {
+      "components": [
+        "Dropdown",
+        "Menu",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "菜单键盘开关和焦点正确，逐操作核对对象、权限与结果"
+      ]
+    },
+    "detail": {
+      "components": [
+        "Descriptions",
+        "Tabs",
+        "Timeline",
+        "Card"
+      ],
+      "applicationResponsibilities": [
+        "详情对象、分组、状态与列表对应",
+        "采用Tab／历史时切换和返回保留约定上下文，未声明的示例业务不自动移植"
+      ]
+    },
+    "hierarchy": {
+      "components": [
+        "Tree",
+        "TreeSelect",
+        "Table.expandable"
+      ],
+      "applicationResponsibilities": [
+        "逐层展开／收起，路径和节点身份稳定，无数据和不可用节点明确",
+        "父子选择策略、半选、搜索和关联列表按声明类型实测，树表展开不丢行或误选"
+      ]
+    },
+    "wizard": {
+      "components": [
+        "Steps",
+        "Form",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "每步校验，非法输入不能越过；前后切换保留正确数据",
+        "最终复核与提交对象一致，失败保留可重试，关闭和继续符合草稿策略"
+      ]
+    },
+    "canvas": {
+      "components": [
+        "Button",
+        "Tooltip",
+        "Form"
+      ],
+      "applicationResponsibilities": [
+        "节点选择与属性联动，移动和键盘操作作用于同一节点",
+        "缩放、适合画布、滚动正确，拖动坐标随缩放换算",
+        "新增删除节点与连线、连线规则及校验反馈正确",
+        "只读不能编辑，未保存保护与保存结果符合本次业务状态"
+      ]
+    },
+    "authorization": {
+      "components": [
+        "Tree",
+        "Checkbox",
+        "Button",
+        "Alert"
+      ],
+      "applicationResponsibilities": [
+        "菜单、按钮、字段的隐藏／禁用和原因符合实际PRD角色",
+        "切换范围及直达路由按模拟权限合同处理；不把前端演示称为服务端授权"
+      ]
+    },
+    "lifecycle": {
+      "components": [
+        "Tag",
+        "Steps",
+        "Timeline",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "允许操作随业务状态变化，拒绝无效转移；版本冲突和历史展示有依据"
+      ]
+    },
+    "persistence": {
+      "components": [
+        "Alert",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "本次实例、用户、范围和页面的偏好或草稿按约定隔离",
+        "坏缓存与拒存储有恢复，不静默覆盖其他实例"
+      ]
+    },
+    "relation": {
+      "components": [
+        "Modal",
+        "Tree",
+        "Table",
+        "Input"
+      ],
+      "applicationResponsibilities": [
+        "检索、范围过滤、选择、取消和回填对象一致"
+      ]
+    }
+  }
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/src/App.vue

@@ -5,6 +5,8 @@ import zhCN from 'antdv-next/locale/zh_CN'
 import type { PrototypeConfig } from './config'
 import { THEME_IDS, THEME_PRESETS, loadThemePreference, safeThemeStorage, saveThemePreference, themeStorageKey } from './domain/theme'
 import type { ThemeId } from './domain/theme'
+import PrototypeShell from './PrototypeShell.vue'
+import { presentationTokens, resolvePresentation } from './domain/presentation'
 const props = defineProps<{ config: PrototypeConfig }>()
 const storage = safeThemeStorage(() => window.localStorage)
 const key = themeStorageKey(props.config.storageNamespace)
@@ -18,11 +20,14 @@ const motionChanged = (event: MediaQueryListEvent) => { reduced.value = event.ma
 media.addEventListener('change', motionChanged)
 onBeforeUnmount(() => media.removeEventListener('change', motionChanged))
 const preset = computed(() => THEME_PRESETS[selected.value])
+const recipe = computed(() => props.config.presentation ? presentationTokens(resolvePresentation(props.config.presentation)) : undefined)
+const variables = computed(() => ({ '--prototype-bg': preset.value.bg, '--prototype-surface': preset.value.surface, '--prototype-text': preset.value.text, '--prototype-border': preset.value.border, '--prototype-radius': `${recipe.value?.borderRadius ?? 10}px` }))
 const tokens = computed(() => ({
   algorithm: preset.value.mode === 'dark' ? antdTheme.darkAlgorithm : antdTheme.defaultAlgorithm,
   token: { colorPrimary: preset.value.primary, colorBgBase: preset.value.bg, colorBgContainer: preset.value.surface,
     colorBgElevated: preset.value.surface, colorText: preset.value.text, colorTextSecondary: preset.value.muted,
-    colorBorder: preset.value.border, colorTextLightSolid: preset.value.onPrimary, motion: !reduced.value },
+    colorBorder: preset.value.border, colorTextLightSolid: preset.value.onPrimary, motion: !reduced.value,
+    ...(recipe.value ? { borderRadius: recipe.value.borderRadius, controlHeight: recipe.value.controlHeight } : {}) },
 }))
 function choose(value: unknown) {
   if (typeof value !== 'string' || !THEME_IDS.includes(value as ThemeId)) return
@@ -35,8 +40,14 @@ watch(preset, value => {
 }, { immediate: true })
 </script>
 <template>
-  <ConfigProvider :locale="zhCN" :theme="tokens">
-    <div class="prototype-shell" :style="{ background: preset.bg, color: preset.text }">
+  <ConfigProvider :locale="zhCN" :theme="tokens" :component-size="recipe?.componentSize">
+    <div v-if="config.presentation" :style="variables">
+      <PrototypeShell :config="config" :menu-theme="preset.mode">
+        <template #appearance><div class="theme-picker"><label for="prototype-theme">主题</label><Select id="prototype-theme" aria-label="主题" :value="selected" :options="options" @change="choose" /></div></template>
+        <template #default="{ page }"><Alert v-if="warning" type="warning" :title="warning" show-icon /><section :aria-label="page.title"><h2>{{ page.title }}</h2><Alert type="warning" title="业务页面待实现" description="按固定的页面模式、字段、操作与验收合同实现此页。" show-icon /></section></template>
+      </PrototypeShell>
+    </div>
+    <div v-else class="prototype-shell" :style="{ background: preset.bg, color: preset.text }">
       <header><h1>{{ config.title }}</h1><div class="theme-picker"><label for="prototype-theme">主题</label><Select id="prototype-theme" aria-label="主题" :value="selected" :options="options" @change="choose" /></div></header>
       <main :style="{ background: preset.surface, borderColor: preset.border }">
         <Alert v-if="warning" type="warning" :title="warning" show-icon />

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/src/PrototypeShell.vue

@@ -0,0 +1,59 @@
+<script setup lang="ts">
+import { computed, nextTick, onBeforeUnmount, ref, watch } from 'vue'
+import { Button, Drawer, Layout, LayoutContent, LayoutHeader, LayoutSider, Menu, Result } from 'antdv-next'
+import type { MenuProps } from 'antdv-next'
+import type { PrototypeConfig } from './config'
+import { navigationMenus, pageFromHash, presentationTokens, resolvePresentation } from './domain/presentation'
+import type { NavigationItem } from './domain/presentation'
+const props = defineProps<{ config: PrototypeConfig; menuTheme?: 'light' | 'dark' }>()
+const presentation = computed(() => resolvePresentation(props.config.presentation))
+const recipe = computed(() => presentationTokens(presentation.value))
+const active = ref(pageFromHash(location.hash, props.config.pages))
+const current = computed(() => props.config.pages.find(page => page.id === active.value))
+const items = computed(() => props.config.navigation || props.config.pages.map(page => ({ key: page.id, label: page.title })))
+const menus = computed(() => navigationMenus(items.value, presentation.value.layout, active.value))
+const collapsed = ref(false), mobileOpen = ref(false), focusAfterClose = ref(false)
+const opened = ref<string[]>([])
+function ancestors(nodes: NavigationItem[], target: string | undefined, parents: string[] = []): string[] | undefined { for (const node of nodes) { if (node.key === target) return parents; if (node.children) { const found = ancestors(node.children, target, [...parents, node.key]); if (found) return found } } }
+watch(active, value => { opened.value = [...new Set([...opened.value, ...(ancestors(items.value, value) || [])])] }, { immediate: true })
+const media = matchMedia('(max-width: 767px)'), narrow = ref(media.matches)
+const onResize = (event: MediaQueryListEvent) => { narrow.value = event.matches; if (!event.matches) mobileOpen.value = false }
+const onHash = () => { active.value = pageFromHash(location.hash, props.config.pages) }
+media.addEventListener('change', onResize); window.addEventListener('hashchange', onHash); window.addEventListener('popstate', onHash)
+onBeforeUnmount(() => { media.removeEventListener('change', onResize); window.removeEventListener('hashchange', onHash); window.removeEventListener('popstate', onHash) })
+function navigate(event: { key: string | number }) {
+  const id = String(event.key)
+  if (!props.config.pages.some(page => page.id === id)) return
+  history.pushState(null, '', `#/${encodeURIComponent(id)}`); active.value = id
+  if (mobileOpen.value) { focusAfterClose.value = true; mobileOpen.value = false } else nextTick(focusMain)
+}
+function afterMenuChange(open: boolean) { if (!open && focusAfterClose.value) { focusAfterClose.value = false; nextTick(focusMain) } }
+function focusMain() { document.getElementById('prototype-main')?.focus() }
+function nativeItems(nodes: NavigationItem[]): NonNullable<MenuProps['items']> { return nodes.map(node => node.children ? { key: node.key, label: node.label, children: nativeItems(node.children) } : { key: node.key, label: node.label }) }
+const side = computed(() => ['sidebar','mixed'].includes(presentation.value.layout))
+const top = computed(() => ['topbar','mixed'].includes(presentation.value.layout))
+</script>
+<template>
+  <Layout class="generation-shell" :class="[`layout-${presentation.layout}`, `style-${presentation.style}`, `density-${presentation.density}`]" :style="{ '--prototype-spacing': `${recipe.spacing}px` }" :data-layout="presentation.layout" :data-style="presentation.style" :data-density="presentation.density">
+    <a class="skip-link" href="#prototype-main" @click.prevent="focusMain">跳到页面内容</a>
+    <LayoutHeader class="generation-header">
+      <div class="generation-brand"><Button v-if="narrow" aria-label="打开导航" :aria-expanded="mobileOpen" @click="mobileOpen = true">菜单</Button><strong>{{ config.title }}</strong></div>
+      <slot name="appearance" />
+    </LayoutHeader>
+    <nav v-if="top && !narrow" aria-label="顶部导航" class="generation-topnav"><Menu :theme="menuTheme || 'light'" mode="horizontal" :items="nativeItems(menus.top)" :selected-keys="menus.topSelected ? [menus.topSelected] : []" @click="navigate" /></nav>
+    <Layout class="generation-body">
+      <LayoutSider v-if="side && !narrow" class="generation-sidebar" :width="224" :collapsed-width="72" :collapsed="collapsed" :theme="menuTheme || 'light'">
+        <Button block :aria-expanded="!collapsed" :aria-label="collapsed ? '展开侧栏' : '收起侧栏'" @click="collapsed = !collapsed">{{ collapsed ? '展开' : '收起侧栏' }}</Button>
+        <nav aria-label="侧栏导航"><Menu :theme="menuTheme || 'light'" v-model:open-keys="opened" mode="inline" :inline-collapsed="collapsed" :items="nativeItems(menus.side)" :selected-keys="active ? [active] : []" @click="navigate" /></nav>
+      </LayoutSider>
+      <LayoutContent id="prototype-main" class="generation-content" tabindex="-1">
+        <nav v-if="presentation.layout === 'focused' && !narrow && config.pages.length > 1" aria-label="工作区页面"><Menu :theme="menuTheme || 'light'" mode="horizontal" :items="nativeItems(items)" :selected-keys="active ? [active] : []" @click="navigate" /></nav>
+        <slot v-if="current" :page="current" />
+        <Result v-else status="404" title="页面不存在" sub-title="当前地址不在本原型的页面范围内。"><template #extra><Button @click="navigate({ key: config.pages[0].id })">返回首页</Button></template></Result>
+      </LayoutContent>
+    </Layout>
+    <Drawer :open="mobileOpen" title="导航" placement="left" :width="288" :mask="{ enabled: true, blur: true }" destroy-on-hidden @after-open-change="afterMenuChange" @close="mobileOpen = false">
+      <nav aria-label="移动导航"><Menu :theme="menuTheme || 'light'" v-model:open-keys="opened" mode="inline" :items="nativeItems(items)" :selected-keys="active ? [active] : []" @click="navigate" /></nav>
+    </Drawer>
+  </Layout>
+</template>

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/src/config.ts

@@ -1,6 +1,8 @@
 import { resolveThemeConfig } from './domain/theme'
 import type { ThemeBinding } from './domain/theme'
-export interface PrototypeConfig { instanceId: string; storageNamespace: string; mockVersion: string; title?: string; pages: { id: string; title: string }[]; theme?: ThemeBinding }
+import { resolvePresentation } from './domain/presentation'
+import type { NavigationItem, Presentation } from './domain/presentation'
+export interface PrototypeConfig { instanceId: string; storageNamespace: string; mockVersion: string; title?: string; pages: { id: string; title: string }[]; theme?: ThemeBinding; presentation?: Presentation; navigation?: NavigationItem[]; generation?: { pages: unknown[] } }
 export interface PrototypeMeta extends PrototypeConfig { candidateId: string }
 declare global { interface Window { __PROTOTYPE_META__: PrototypeMeta } }
 
@@ -14,5 +16,8 @@ export async function loadConfig(): Promise<PrototypeConfig> {
     if (typeof value[key] !== 'string' || !(value[key] as string).trim()) throw new Error(`原型配置缺少 ${key}。`)
   }
   resolveThemeConfig(value.theme)
+  if (value.presentation !== undefined) resolvePresentation(value.presentation)
+  if (!Array.isArray(value.pages) || !value.pages.length || value.pages.some(page => !page || typeof page.id !== 'string' || !page.id || typeof page.title !== 'string')) throw new Error('原型页面配置无效。')
+  if (new Set(value.pages.map(page => page.id)).size !== value.pages.length) throw new Error('原型页面标识重复。')
   return value as unknown as PrototypeConfig
 }

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/src/domain/presentation.ts

@@ -0,0 +1,29 @@
+export interface Presentation { layout: 'sidebar' | 'topbar' | 'mixed' | 'focused'; style: 'business' | 'minimal' | 'soft'; density: 'compact' | 'standard' | 'comfortable' }
+export interface NavigationItem { key: string; label: string; children?: NavigationItem[] }
+export function navigationMenus(items: NavigationItem[], layout: Presentation['layout'], active?: string) {
+  const first = (item: NavigationItem): string => item.children?.length ? first(item.children[0]) : item.key
+  const contains = (item: NavigationItem): boolean => item.key === active || !!item.children?.some(contains)
+  const groups = items.some(item => item.children) ? items : [{ key: '@pages', label: '业务页面', children: items }]
+  const current = groups.find(contains) || groups[0]
+  return { top: layout === 'mixed' ? groups.map(item => ({ key: first(item), label: item.label })) : items,
+    side: layout === 'mixed' ? current?.children || [current] : items,
+    topSelected: layout === 'mixed' && current ? first(current) : active }
+}
+export function resolvePresentation(value: unknown): Presentation {
+  if (!value || typeof value !== 'object') throw new Error('缺少已固定的页面呈现选择。')
+  const item = value as Record<string, unknown>
+  for (const [key, choices] of Object.entries({ layout: ['sidebar', 'topbar', 'mixed', 'focused'], style: ['business', 'minimal', 'soft'], density: ['compact', 'standard', 'comfortable'] })) {
+    if (!choices.includes(item[key] as string)) throw new Error(`不支持的呈现选择：${key}`)
+  }
+  return item as unknown as Presentation
+}
+export function presentationTokens(value: Presentation) {
+  return { borderRadius: { business: 6, minimal: 4, soft: 10 }[value.style],
+    controlHeight: { compact: 28, standard: 32, comfortable: 40 }[value.density],
+    spacing: { compact: 12, standard: 20, comfortable: 28 }[value.density],
+    componentSize: { compact: 'small', standard: 'middle', comfortable: 'large' }[value.density] as 'small' | 'middle' | 'large' }
+}
+export function pageFromHash(hash: string, pages: { id: string }[]): string | undefined {
+  if (!hash || hash === '#/' || hash === '#') return pages[0]?.id
+  try { const id = decodeURIComponent(hash.replace(/^#\/?/, '')); return pages.some(page => page.id === id) ? id : undefined } catch { return undefined }
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/src/style.css

@@ -11,3 +11,16 @@ section { min-height: 240px; }
 :focus-visible { outline: 3px solid currentColor; outline-offset: 3px; }
 @media (max-width: 600px) { .prototype-shell { padding: 12px; } main { padding: 12px; } h1 { font-size: 20px; } }
 @media (prefers-reduced-motion: reduce) { *, *::before, *::after { scroll-behavior: auto !important; animation-duration: .01ms !important; transition-duration: .01ms !important; } }
+.generation-shell { min-height: 100dvh; background: var(--prototype-bg); color: var(--prototype-text); }
+.generation-header { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 16px; width: 100%; max-width: none; min-height: 64px; height: auto; margin: 0; padding: 12px 24px; line-height: 1.5; background: var(--prototype-surface); color: inherit; border-bottom: 1px solid var(--prototype-border); }
+.generation-brand { display: flex; align-items: center; gap: 12px; font-size: 18px; }
+.generation-body { min-width: 0; background: var(--prototype-bg); }
+.generation-sidebar { padding: 12px 8px; background: var(--prototype-surface) !important; border-right: 1px solid var(--prototype-border); }
+.generation-topnav { background: var(--prototype-surface); }
+.generation-content { min-width: 0; max-width: none; margin: var(--prototype-spacing); padding: var(--prototype-spacing); border: 1px solid var(--prototype-border); border-radius: var(--prototype-radius); background: var(--prototype-surface); color: inherit; }
+.layout-focused .generation-content { width: calc(100% - 2 * var(--prototype-spacing)); max-width: 1200px; margin: var(--prototype-spacing) auto; }
+.style-minimal .generation-content { border-color: transparent; }
+.style-soft .generation-content { box-shadow: 0 4px 20px rgb(0 0 0 / 6%); }
+.skip-link { position: fixed; top: 8px; left: 8px; z-index: 2000; padding: 8px 12px; background: var(--prototype-surface); color: var(--prototype-text); transform: translateY(-200%); }
+.skip-link:focus { transform: none; }
+@media (max-width: 767px) { .generation-header { padding: 12px; } .generation-content { margin: 8px; padding: 12px; } }

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/starter/tests/presentation.test.ts

@@ -0,0 +1,23 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { resolvePresentation, presentationTokens, pageFromHash, navigationMenus } from '../src/domain/presentation.ts'
+test('every supported presentation combination has a usable native token recipe', () => {
+  for (const layout of ['sidebar','topbar','mixed','focused']) for (const style of ['business','minimal','soft']) for (const density of ['compact','standard','comfortable']) {
+    const value = resolvePresentation({ layout, style, density }), tokens = presentationTokens(value)
+    assert.ok(tokens.controlHeight > 0 && tokens.spacing > 0 && tokens.borderRadius >= 0)
+  }
+  assert.throws(() => resolvePresentation({ layout: 'lost', style: 'minimal', density: 'compact' }), /不支持/)
+})
+test('deep links retain declared page identity and reject unknown or malformed locations', () => {
+  const pages = [{ id: 'assets' }, { id: 'details' }]
+  assert.equal(pageFromHash('#/details', pages), 'details')
+  assert.equal(pageFromHash('', pages), 'assets')
+  assert.equal(pageFromHash('#/missing', pages), undefined)
+  assert.equal(pageFromHash('#/%broken', pages), undefined)
+})
+test('mixed navigation separates group entries from the selected group pages', () => {
+  const value = navigationMenus([{ key: '@assets', label: '资产', children: [{ key: 'list', label: '台账' }, { key: 'detail', label: '详情' }] }, { key: '@work', label: '作业', children: [{ key: 'jobs', label: '任务' }] }], 'mixed', 'detail')
+  assert.deepEqual(value.top.map(item => item.key), ['list','jobs'])
+  assert.deepEqual(value.side.map(item => item.key), ['list','detail'])
+  assert.equal(value.topSelected, 'list')
+})

package/skills/i3-ui-prototype/assets/hosts/codebuddy/profile.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 2,
+  "id": "buddy-command-auto-v2",
+  "nativeValidation": "pending-user",
+  "platforms": ["darwin", "linux"],
+  "hosts": ["codebuddy", "workbuddy"],
+  "events": ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "Stop"],
+  "transcriptFormat": ["assistant-user-tool-use-jsonl-v1", "flat-message-function-call-jsonl", "codebuddy-ide-index-v1"],
+  "products": {
+    "ide": {"settings": "settings.json", "configuration": "codebuddy-project-overrides-global; workbuddy-merged", "transcriptRoot": "native-hook-transcript-path", "nativeReview": "reload-and-verify"},
+    "cli": {"settings": "settings.json", "configuration": "merged-project-first-binding", "transcriptRoot": "native-hook-transcript-path", "nativeReview": "/hooks"}
+  },
+  "identification": "Explicit native client, or a callback log in a configured native host projects directory; unknown/conflicting identity remains unverified.",
+  "recovery": {"perMissing": 2, "total": 6, "doesNotForceNextTool": true},
+  "sources": ["https://www.codebuddy.cn/docs/ide/Features/Hooks", "https://www.codebuddy.cn/docs/cli/hooks", "https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Plug-In"],
+  "localSourceInspection": {"workbuddy": "5.8.3 bundled CLI: shared command Hook protocol, config/projects/session JSONL, providerData.isMeta; native runtime acceptance pending"}
+}

package/skills/i3-ui-prototype/assets/optional-skills/host-targets.json

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

package/skills/i3-ui-prototype/assets/templates/catalog.json

@@ -27,7 +27,8 @@
         "业务字段",
         "按需求适配的流程"
       ],
-      "manifest": "enterprise-admin/manifest.json"
+      "manifest": "enterprise-admin/manifest.json",
+      "contentRoot": "enterprise-admin"
     },
     {
       "id": "ai-workbench",