OpenChamber 设置界面模式指南
在修改 OpenChamber 设置页面、对话框和搜索行为时,强制代理使用共享原语与本地化、搜索注册约定,避免各页面各自造轮子。
该技能是纯文档型 UI 规范,无脚本、无网络调用、无敏感数据操作,最少权限原则天然满足;要求加载的伴随技能(theme-system、locale-ui-patterns、ui-api-decoupling)超出本次评估范围,其内容与安全性无法核实,数据流与回滚等维度不适用。扣分点:伴随技能与被引用源文件(SettingsSection.tsx、search.ts 等)未随附,无法完全核实指令与代码现状一致。
指令内部自洽:冲突时以共享契约优先并有明确的停止规则;路径引用具体且仓库结构可佐证(package. 的 settings-registry:generate、icons:generate 脚本存在)。但属静态评审,未执行;引用的具体文件内容未提供,main SKILL.md 写 h-9 而 controls.md 写 h-8,存在内部不一致迹象,扣分至锚点 10。
description 明确触发场景(创建/修改 OpenChamber Settings 页面、对话框、搜索),仅适用于本仓库代码库,边界清晰;但缺少非适用范围声明,且无中文环境问题——不依赖外部可达服务,不因此扣分。扣分点:触发精度依赖仓库内上下文,边界与不适用情形部分依赖推断。
MIT 许可清晰,分层结构良好(主文件 + layout/controls/search 三份参考,按任务加载,渐进披露规范);有完成标准清单。扣分点:技能本身无版本号或变更记录,维护责任与更新路径未在技能文件中声明;发布者未经注册表验证(按规则不额外扣分但也不加分)。
对在本仓库内开发 Settings UI 的代理有明确边际价值:统一的组件选型表、搜索注册契约、完成标准可直接使用。但价值主张依赖未提供的源文件正确性,且受众极窄(仅 OpenChamber 维护者/代理),静态评审下无法验证代表性输出,按上限 7 内取 6。
引用的仓库级证据(CI 工作流、测试脚本、registry 快照脚本)可佐证部分主张,且有带 last_result 的手工检查清单存在;但技能关键路径引用的具体文件未随附,无法独立复现,静态上限 5 内取 4。
- 该技能仅适用于 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。
- OpenChamber 贡献者用 AI 代理新增一个设置页面,希望它自动套用仓库的布局、间距与信息提示约定
- 维护者向设置页添加或移动控件,需要代理同时更新搜索注册表、锚点和本地化键,避免遗漏
- 团队要求所有设置相关改动遵循统一的信息文案策略(警告可见、解释藏入 info 提示)
- 接手他人代码的开发者希望代理在修改设置界面时保持扁平层级、容器查询响应式等既有风格,而非引入卡片和全宽输入
这个 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 仓库之外使用没有意义,因为它引用的共享原语不存在。