Cate 主题创作工具
为 Cate IDE 创建、编辑和验证一体化主题——覆盖应用界面、终端和代码编辑器。
证据:技能没有恶意操作,主要涉及编辑配置文件和导入主题,均需用户确认或明确要求。直接编辑 config.json 的方法有明确的限制(绝不重新排序、覆盖现有主题、触碰无关键),并提供回滚路径(应用会在下次启动时重新读取)。但未说明权限最小化细节,如读取和写入配置文件时是否需要用户确认,也没有处理敏感数据(如配置中的凭证)的说明。扣分原因:权限和确认机制不完整,缺少对写入操作的显式确认要求。
证据:自述文档一致,示例文件完整,schema 文件存在且定义明确。但未能实际执行验证,且依赖外部工具 ajv 和外部服务(Cate 应用、npm)可能不可用。错误处理方面,仅提示如果 config.json 无法解析则停止,但缺乏对其他失败情况的诊断信息。扣分原因:静态审核无法验证功能,对依赖项和错误处理的覆盖不足。
证据:技能有明确的描述和触发条件,适用于创建、编辑、定制 Cate 主题,场景清晰。提供了亮色和暗色示例,以及具体的颜色指导(WCAG AA 对比度)。非适用边界未明确说明,例如不支持除 Cate 以外的 IDE。环境适配方面,文档为英文,未提供中文支持,且 Cate 应用本身可能需要从 GitHub 下载,在中国大陆访问可能受限。扣分原因:非适用范围不够明确,本地化支持不足,潜在的网络可达性问题。
证据:文档结构清晰,有示例和 schema 验证说明,提供了故障排除和已知限制(如部分键继承)。但缺少版本控制和变更日志,未明确维护责任和更新路径。许可证在仓库级别,但未在技能中明确标注。扣分原因:缺少版本记录和维护信息,技能自身的许可证和变更历史不明确。
证据:技能能够完成创建主题的核心任务,提供完整示例和验证步骤,输出格式明确(JSON 文件或直接修改配置)。但边际价值未与手动操作或其他工具对比,且输出需要用户进一步导入或应用,无法自动生效。扣分原因:静态审核无法验证实际效果,输出需要额外步骤,比较优势不足。
证据:提供了示例主题文件和 schema 文件,但这些是技能自身的材料,没有第三方的执行验证。CI 工作流和测试覆盖了仓库的其他部分,但没有专门针对技能功能的测试。扣分原因:缺少独立验证,无法从静态审核中确认技能实际工作。
- 技能直接编辑配置文件时,应确保用户明确同意,并提醒备份。
- 文档仅有英文,需考虑中文用户的支持。
- Cate 应用及依赖可能从海外服务下载,在中国大陆访问可能受限。
- 技能依赖 ajv 验证,若用户环境无此工具,需手动检查。
这个 Skill 能做什么,适合哪些场景?
该技能指导你为 Cate IDE 制作主题,Cate 是一款基于无限画布的桌面 IDE。一个主题就是一个 JSON 对象,同时定义应用外观、终端 ANSI 调色板和 Monaco 编辑器语法高亮。技能提供了完整的 JSON Schema 和详细的颜色键说明,并强调可访问性,要求对比度符合 WCAG AA 标准。它支持通过设置界面导入主题,也可直接写入配置文件。技能还包含校验步骤(使用 ajv 或手动检查)以及应用主题的两种方式。
读取并解析 Cate 的配置文件(config.json)中的 customThemes 数组和 activeThemeId。生成或编辑符合 theme.schema.json 的 JSON 主题对象。提供颜色对比度检查指南,确保文本与 ANSI 颜色可读。可选地运行 ajv 命令验证主题。支持通过文件导入或直接修改配置文件两种方式应用主题。
- 用户希望将 Cate 界面改为类似 Dracula 或 Nord 的配色方案
- 用户需要创建全新深色或浅色主题,并确保文本可读性
- 用户想要调整终端配色,使其在深色背景下清晰可见
- 用户需要在不同机器上同步自定义主题
这个 Skill 有哪些优点和局限?
- 一个 JSON 文件同时覆盖界面、终端和编辑器,统一管理
- 提供明确的可访问性指导,帮助避免常见对比度问题
- 提供 JSON Schema 和校验命令,减少错误
- 支持两种应用方式,灵活便捷
- 仅适用于 Cate IDE,对其他编辑器不生效
- 需要手动编辑配置文件或通过 UI 导入,不够自动化
- 未包含测试用例或示例以外的验证,依赖用户自行检查
- 应用方式需要用户对 Cate 设置有一定了解
如何安装这个 Skill?
该技能位于仓库 0-AI-UG/cate 的 skills/cate-theme/SKILL.md。按照 Agent Skills 标准,将整个仓库克隆或下载后,将 skills/cate-theme 目录复制到你的技能目录中。
如何使用这个 Skill?
向助手描述你想要的配色方案,例如“为 Cate 创建一个类似 Dracula 的深色主题”。助手会生成符合 schema 的 JSON 文件,你可以保存为 .cate-theme.json 文件,然后在 Cate 中通过“设置 → 外观 → 导入”导入。