- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Devin-AXIS/iPolloWork --skill ipollowork-plugin-ui -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Devin-AXIS/iPolloWork --skill ipollowork-plugin-ui -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Devin-AXIS/iPolloWork --skill ipollowork-plugin-ui -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Devin-AXIS/iPolloWork --skill ipollowork-plugin-ui -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.codex/skills/ipollowork-plugin-ui来自发布者
从用户要完成的操作选择组件。默认采用“已实现与推荐使用”,保持明确的当前值、反馈位置、恢复动作和键盘焦点。
apps/app/src/components/ui 导入基础控件;@/ 是主应用别名。业务组合参考现有调用,不把领域内部组件作为插件公开 API。@ipollowork/ui 包。@ipollowork/ui/core 为基础组件公共汇总入口,具体模块及 Figma 对照读取 组件映射。iframe 从运行时对象取得相同具名组件,通过 React 岛接入;只有 Button/Input/Textarea 支持原生 HTML 标记适配。实施插件前必须读取 插件接入契约 的公共入口、构建/注入和版本章节,按以下边界选择:
@/components/ui/* 入口;共享包控件入口为 @ipollowork/ui/controls。@ipollowork/ui/runtime-contract 导入 requireRuntime(1);实际 React/控件从返回的运行时对象取得。不要从 plugin-runtime 或宿主私有路径导入实现,也不要给生产插件再打包 React。buildPluginRuntime('bundled'),将运行时放在业务脚本之前;生产包不包含运行时,保留契约中的固定 meta 标记,由宿主注入。不能仅凭 NODE_ENV 推断加载方式。1.8.0。使用本轮颜色与字体规范时调用 requireRuntime(1, required, 3),第三参数检查最低 minor;使用公共 Icon 时调用 requireRuntime(1, ['Button', 'Icon'], 4),尺寸 S/M/L 为14/16/20px,Button 前后图标直接作为 children 组合,纯图标按钮必须有 aria-label。required 列出实际使用的全部函数导出(包括子组件)。共享 Badge 的 info/success/warning 语义变体和前置图标组合要求 requireRuntime(1, ['Badge', 'Icon'], 5)。SearchField、NumberField、Slider、Calendar、DatePicker / TimeInput、FileUpload / FileUploadItem 要求 requireRuntime(1, required, 6);日期使用本地年月日,上传状态由业务调用方提供,不伪造进度或取消能力。表格组合 TableSortHead / TablePagination / TablePageSelection / TableBulkActions 要求 requireRuntime(1, required, 7)。排序、过滤、分页与稳定ID选择由调用方管理;表头只选当前页,翻页保留选择,改变筛选清空选择;批量确认与部分失败恢复必须由实际业务处理。资源卡 Card variant="resource"、CardIcon、CardMeta 和 CardTitle as="h3" 要求 requireRuntime(1, required, 8);既有 default/outline Card 行为不变。旧版本或缺组件时停止初始化并提示更新客户端。不支持完整 semver 范围、最低 patch 或 manifest UI 版本协商,也不自动下载另一份组件库。历史1.2整合记录不代表当前发布状态。当前core汇总43个模块;Figma推荐页的62个条目包含变体和内容示例,不能当作独立组件数量。按组件目录分别核对代码可用、业务采用、设计对齐、交互验收、发布验证五个维度。核心样板是浏览器隔离验证,真实客户端安装证据另记;签名包上传、打包客户端和跨客户端升级仍未完成全面验收。
读取 组件目录 中任务涉及的条目,然后打开真实源码、导出和调用场景。
实施前按共享包README的固定验收矩阵列出本次适用状态。每条结果绑定动作、可观察断言与截图;未测状态记录Incomplete,不能由“推荐”或Figma身份自动升级为Passed。视频工作台保留专业布局,仅复用语义主题与基础控件;展开脚本隐藏属性、收起恢复原页签须单独验收。
Figma 状态页展示现有组件实例副本;主组件留在完整目录。查看设计时按需读取链接,避免把未确认的最新编辑自动升级为强制规范。源码与设计发生差异时记录双方依据,并解决影响本次任务的差异。
共享控件身份读取 组件映射:主组件 ID、源码、包导出与接入方式对应。Select、Dialog、Toast 已于 2026-10-10 核对主组件及完整目录/推荐页实例引用。Toast 设计卡片对应 Toaster 容器与 toast 调用 API,不是三个独立设计组件;新增三组没有原生 HTML 标记适配。身份核对不等于全部视觉状态一致。此清单是 Code Connect 不可用时的仓库契约,不是假冒 Code Connect 发布记录。
设计或实现插件页面时读取 主题与 Token:以用户提供的紧凑UI表和Teal品牌色板为设计目标,按语义选择颜色与文字层级,不把当前源码遗留值当成已确认规范。Page Title16/24、Section Title14/20、Control13/18、Body13/20、Meta12/18、Caption11/16、Micro10/14的用途与字重,以及真实源码入口、差异和迁移边界均在契约中维护。字体先复用公共sans/mono栈;品牌展示页的Syne大标题不自动套入客户端UI。
品牌 Primary 为青色 #1FBAC0;普通主要按钮(Button default)浅色黑底白字、暗色青底黑字;危险按钮保留 destructive。共享层维护 --brand-*、--action-*、可读链接 --primary-text 与焦点 --ring,调用方不复制 hex。七档 text-ui-page-title/section-title/control/body/meta/caption/micro 已实际生成在运行时中,也可直接使用 --ui-{角色}-size/line 的 px 变量。字号不依赖插件根字号换算;系统字体栈不变。Field 统一留 --field-hint-gap:8px,不再给说明文字负 margin。短片工作台根字号为16px、正文13/20;iframe仍不自动继承宿主 body 和 CSS 缩放回退,不修改作品字体。
此规范不影响视频、图片、文章、演示等用户作品。代码、Figma与Skill的同步状态分别记录;目前页面级字体迁移和完整Figma文字样式对照尚未完成,不能用控件验收替代。
完整产品规则读取仓库 docs/interaction-guidelines.zh-CN.md 中相关章节;docs/client-interactions.zh-CN.md 描述现状。遵守以下默认决策:
FieldLabel → 控件 → FieldDescription / FieldError;标签不能只靠 placeholder。错误关联字段并设置 aria-invalid,提交失败保留输入。--feedback-*-background,暗色切换为低亮度背景。保留文字、状态图标和恢复动作,不另加语义边框或左侧竖条。具体 API、Token 与迁移检查读取 插件接入契约。--project-dialog-notice 浅暖灰底(暗色为 --gray-3),不再使用黄色底。亮暗值均由共享 Token 切换。工作区模型选择不带前置图标,窄容器仍保留截断名称及下拉箭头,不能变成空按钮。按仓库 AGENTS.md 的演示、隔离工作区和真实体验验证流程完成可见实现;代码变更使用 ipollowork-maintainable-code,本 Skill 不重复定义代码质量规则。
检查实际控件状态、选择值、关闭与焦点、异步失败后的输入保留、重试、宿主主题更新和容器缩放。生成真实体验证据;夹具、模拟传输和真实服务链路分别报告。
本 Skill 文档更新本身可做结构、路径和链接检查;文档通过不表示插件已接入或运行验收通过。
核心公共调用样板为 evals/support/shared-ui-core-fixture.mjs,两种加载方式的体验验证为 evals/flows/shared-ui-core.flow.mjs。以真实具名导出及其 TypeScript Props 编写组合,不凭 Figma 展示标题猜测 API。AlertDialogAction 不自动关闭,异步操作成功后由调用方更新 open;失败保留弹窗。Alert 的 closeLabel、Image 的 showFullLabel/showLessLabel 由插件提供本地化文本。
完整业务接入参考 examples/plugin-packages/short-video-studio/src/ui.mjs,七页验收流程为 evals/flows/short-video-shared-ui.flow.mjs:标记适配基础输入与按钮,React 岛挂载选择、多选、导航及反馈。迁移还需移除被替代的控件 CSS,保留领域布局,避免只给旧 DOM 换颜色。不要把 Base UI 的隐藏表单 input 当作未迁移的可见控件;校验真实选择值、草稿保留和重试写盘。
目录资源复用 Card variant="resource" 的两种正式形态:surface="plain" 无边框款默认透明、hover浅灰;surface="outline" 描边款为默认值,透明底、1px语义描边、hover强调描边。两款均无阴影,圆角12px、padding16px、gap12px,右侧动作使用outline Button。内部 Header/Content/Footer 不重复padding,Header以flex排列32px透明对齐槽的CardIcon(内部Logo为24px,Lucide笔画1.5px)和正文,Footer支持左状态/右动作、换行与mt-auto,不强制高度。CardTitle可设 as="h3"(默认div保持兼容),resource内使用sans 14/20/600,CardDescription为12/18/400,CardMeta为11/16/400。尺寸按固定px,不随iframe根字号缩小。
layout="row"仅用于resource紧凑目录行(默认stack):Header放32px图标槽(内部24px图标)、名称和一句说明并自适应占宽,最小宽度min(100%,240px);Footer操作靠右,空间不足自然换到右下。内容/meta块可省略,不设固定卡高、不用JS测宽。普通default/outline不受layout影响。
保留资源自己的类型、来源、状态和业务回调,不伪造插件manifest套用插件业务组件;整卡不再嵌套一层button,真实动作仍用共享Button。宿主从原card入口导入,iframe required必须列出实际使用的Card及子槽并检查最低minor8。此轮是代码扩展,未新增或确认Figma身份;交互、业务采用与发布验证仍按各自证据记录。
组件晋升时同时更新代码位置、Figma 状态页、清单和验证范围。主组件视觉在 Figma 完整目录维护;状态页元数据和本地目录为核对快照,不具备自动同步。新增公共组件必须有真实需求;候选库可持续编辑。
插件和技能的紧凑目录使用 Card variant="resource" layout="row" surface="plain":默认透明无边框,悬停使用共享 muted 浅灰背景,操作使用 outline Button;其他资源卡保持默认描边。
为 iPolloWork 新插件或插件工作区复用 UI 组件、颜色、字体及交互规范。按 Figma 成熟状态和代码清单优先采用已确认组件,区分宿主 React 与独立 HTML/iframe 的接入方式;适用于插件表单、导航、浮层、反馈、状态和进度设计及实现,不改变用户作品的视觉风格。
---name: ipollowork-plugin-uidescription: 为 iPolloWork 新插件或插件工作区复用 UI 组件、颜色、字体及交互规范。按 Figma 成熟状态和代码清单优先采用已确认组件,区分宿主 React 与独立 HTML/iframe…---# .codex/skills/ipollowork-plugin-ui/SKILL.md常见问题
从发布者处下载 .codex/skills/ipollowork-plugin-ui/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/Devin-AXIS/iPolloWork。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。