设计与前端 ui-patternsdesign-systemsettings-uireact-componentscontainer-querieslocalizationsearch-registryopenchamber

OpenChamber 设置界面模式指南

在修改 OpenChamber 设置页面、对话框和搜索行为时,强制代理使用共享原语与本地化、搜索注册约定,避免各页面各自造轮子。

FollowSkills 评估 · FSRS-2.0
谨慎使用
54/ 100 五分制 2.7 / 5
1 2 3 4 5 6
1信任安全17 / 25 · 3.4/5

该技能是纯文档型 UI 规范,无脚本、无网络调用、无敏感数据操作,最少权限原则天然满足;要求加载的伴随技能(theme-system、locale-ui-patterns、ui-api-decoupling)超出本次评估范围,其内容与安全性无法核实,数据流与回滚等维度不适用。扣分点:伴随技能与被引用源文件(SettingsSection.tsx、search.ts 等)未随附,无法完全核实指令与代码现状一致。

2可靠稳定10 / 20 · 2.5/5

指令内部自洽:冲突时以共享契约优先并有明确的停止规则;路径引用具体且仓库结构可佐证(package. 的 settings-registry:generate、icons:generate 脚本存在)。但属静态评审,未执行;引用的具体文件内容未提供,main SKILL.md 写 h-9 而 controls.md 写 h-8,存在内部不一致迹象,扣分至锚点 10。

3适用触发8 / 15 · 2.7/5

description 明确触发场景(创建/修改 OpenChamber Settings 页面、对话框、搜索),仅适用于本仓库代码库,边界清晰;但缺少非适用范围声明,且无中文环境问题——不依赖外部可达服务,不因此扣分。扣分点:触发精度依赖仓库内上下文,边界与不适用情形部分依赖推断。

4规范维护9 / 15 · 3.0/5

MIT 许可清晰,分层结构良好(主文件 + layout/controls/search 三份参考,按任务加载,渐进披露规范);有完成标准清单。扣分点:技能本身无版本号或变更记录,维护责任与更新路径未在技能文件中声明;发布者未经注册表验证(按规则不额外扣分但也不加分)。

5有效结果6 / 15 · 2.0/5

对在本仓库内开发 Settings UI 的代理有明确边际价值:统一的组件选型表、搜索注册契约、完成标准可直接使用。但价值主张依赖未提供的源文件正确性,且受众极窄(仅 OpenChamber 维护者/代理),静态评审下无法验证代表性输出,按上限 7 内取 6。

6证据核验4 / 10 · 2.0/5

引用的仓库级证据(CI 工作流、测试脚本、registry 快照脚本)可佐证部分主张,且有带 last_result 的手工检查清单存在;但技能关键路径引用的具体文件未随附,无法独立复现,静态上限 5 内取 4。

证据充分度: 评估于 2026年9月9日 审查版本 f8b929edf989
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 该技能仅适用于 OpenChamber 仓库内部开发,不适合作为通用 Settings UI 模式参考使用。
  • SKILL.md(h-9)与 references/controls.md(h-8)对标准控件高度表述不一致,使用前需与实际源码核对。
  • 技能依赖三个伴随技能及多处未随附源文件,单独加载时信息不完整。
  • 技能文件本身缺少版本号与变更记录,更新追踪需依赖仓库提交历史。
  • 本次为静态源码评审,未执行任何验证,实际可用性需在仓库内复现确认。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是 OpenChamber 仓库(openchamber/openchamber,一个 OpenCode 的桌面与网页界面)18 个内置技能中的一个,位于 .agents/skills/settings-ui-patterns/。它不是可执行工具,而是一份供 AI 代理加载的模式规范:规定设置页面必须由 SettingsSection、SettingsPageLayout 等共享原语构建,描述文案默认藏在 info 提示图标后,响应式布局用容器查询而非视口断点,且每次增改控件必须同步更新设置搜索注册表。技能还强制加载 theme-system、locale-ui-patterns 等伴生技能,并按任务指向 references/ 下的布局、控件、搜索三份细则。它只对在 OpenChamber 代码库内工作的人有直接价值。

它是一份指令型文档(SKILL.md 加 references/ 参考文件),代理按任务加载对应参考:改页面骨架时读 layout.md,改控件时读 controls.md,增删或移动控件时读 search.md。它规定:页面与字段行必须使用 packages/ui/src/components/sections/shared/ 下的共享组件而非手写 div;控件统一 h-9 高度并限制宽度;辅助说明默认通过 info 属性藏进提示图标,但安全警告、必填语法、校验错误等必须保持可见;保存状态通过 SettingsPageLayout 的共享指示器或 reportSettingsSaveState 上报,禁止每页自建保存提示;每个稳定控件的增改需同步注册搜索项、data-settings-item 锚点、本地化键与可用性条件;新增图标需引用 Remix 图标名后运行 bun run icons:generate。

  1. OpenChamber 贡献者用 AI 代理新增一个设置页面,希望它自动套用仓库的布局、间距与信息提示约定
  2. 维护者向设置页添加或移动控件,需要代理同时更新搜索注册表、锚点和本地化键,避免遗漏
  3. 团队要求所有设置相关改动遵循统一的信息文案策略(警告可见、解释藏入 info 提示)
  4. 接手他人代码的开发者希望代理在修改设置界面时保持扁平层级、容器查询响应式等既有风格,而非引入卡片和全宽输入

这个 Skill 有哪些优点和局限?

优点
  • 约定具体可执行:原语选择表、控件尺寸、文案策略和搜索契约都有明确规则,减少代理发挥空间
  • 强制伴生技能(主题、本地化、UI-API 解耦)和参考文件按需加载,控制上下文消耗
  • 包含明确的完成标准清单,便于验收生成结果
  • 采用共享原语加容器查询的做法,与仓库真实代码结构对齐
局限
  • 适用范围极窄:仅在 OpenChamber 仓库内开发设置界面时有价值,对其他项目不可迁移
  • 技能本身不包含可执行脚本或自动化测试,合规与否完全依赖模型执行
  • 部分细节依赖 references/ 文件,源材料未提供其内容,无法验证其完整性
  • 仓库声明为独立项目、与 OpenCode 团队无关,维护持续性无长期承诺背书

如何安装这个 Skill?

此技能随 OpenChamber 仓库整体分发,位于仓库内 .agents/skills/settings-ui-patterns/。若在 OpenChamber 代码库中使用支持 Agent Skills 的代理,代理可按 SKILL.md 的 description 触发加载。README 未提供单独安装该技能的命令;仓库整体可通过 GitHub Releases 下载桌面版,或用 curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash 安装 CLI(需 Node.js 22+),但安装应用本身并非使用此技能的前提——在克隆的仓库内开发即可。

如何使用这个 Skill?

在 OpenChamber 仓库内进行设置相关改动时,让代理加载此技能,例如提示:"使用 settings-ui-patterns 技能,在 Settings 中新增一个复选框控件并接入搜索"。代理应按技能要求先加载 theme-system 和 locale-ui-patterns 伴生技能,再按任务读取 references/layout.md、controls.md 或 search.md。注意:技能本身不运行脚本,其效果依赖代理确实加载了参考文件并遵守约定;在 OpenChamber 仓库之外使用没有意义,因为它引用的共享原语不存在。

同仓库的其他 Skills

均来自 openchamber/openchamber

开发与工程

Locale UI Patterns —— OpenChamber 界面文案国际化规范

为 OpenChamber 项目编写或修改任何用户可见文案时,确保每个语言的字典都拿到真正的翻译,而不是英文占位符。

设计与前端

OpenChamber 主题系统技能

在修改 OpenChamber UI 时,强制使用语义化主题令牌、共享按钮/图标契约与键盘导航规范,避免硬编码颜色和重复实现。

设计与前端

OpenChamber 拖拽排序技能(drag-to-reorder)

一份沉淀自真实项目的 @dnd-kit 拖拽排序实践指南,专门解决变宽条目、换行布局和移动端触摸交互中最容易踩的坑。

开发与工程

OpenChamber UI/API 分层规范

为 OpenChamber 共享界面代码划定数据访问边界:官方走 SDK、自有能力走 RuntimeAPIs,避免硬编码 URL、令牌与传输假设。

开发与工程

OpenChamber 性能工程技能

在优化单条操作之前先消除结构性浪费:为交互、渲染、轮询、缓存与大规模数据路径提供以测量为准的性能优化方法论。

开发与工程

Clack CLI 模式规范

为 OpenChamber 终端命令定义统一的交互提示、--quiet 与 -- 输出契约,确保任何运行模式下策略校验先行、行为确定一致。

开发与工程

OpenChamber 中继传输技能

为 OpenChamber 的端到端加密中继隧道正确编写 WebSocket、SSE 与流式端点,避免只在桌面直连下能通过的隐性中继缺陷。

开发与工程

OpenChamber 桌面外壳技能

在修改 OpenChamber 的 Electron 主进程、preload、IPC 或打包逻辑时,为 AI 代理提供正确的架构边界与安全规则。

开发与工程

OpenChamber 变更纪律

在修改 OpenChamber 代码库时,强制执行“最小完整变更 + 最窄级别验证”的工程纪律,防止局部修复演变成投机性重写。

开发与工程

serve-sim — 终端里的 iOS 模拟器遥控器

无需打开 Xcode,就能在终端中启动、安装、串流并操控 Apple 模拟器里的 Capacitor iOS 应用。

开发与工程

OpenChamber 同步状态不变量守则

在改动会话同步、事件归约器、轮询与缓存逻辑时,一套强制执行的状态所有权与失败语义规范,防止数据误删与状态错乱。

相关 Skills