开发与工程

Cate 扩展开发技能

构建、测试并在 Cate 无限画布上发布扩展面板。

61/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.2k
最近更新
8 天前
License
MIT
extension-developmentcatemanifestwebview
+3api-scopespublishingfrontend

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

本技能指导用户在 Cate 的无限画布上创建扩展:包括纯前端面板,以及带本地服务器的后端扩展。它详细说明了清单(manifest.json)、作用域(cateApi)和 window.cate 宿主 API,并解释了如何将扩展发布到官方目录。它区分了前端的纯静态扩展和需要服务的扩展,并概述了本地开发循环以及提交到目录仓库的流程。

根据用户的请求,创建一个新的 Cate 扩展项目结构,包括 manifest.json、README.md,以及可选的包配置和源代码目录。它指导用户编写清单字段,如 id、version、category、panels、server 和 cateApi 作用域。它解释了 window.cate API 的每一个方法及其对应的作用域,用于访问主题、存储、编辑器、工作区、画布、代理、浏览器、文件拖放和 UI 通知。它提供了在本地运行扩展的说明:侧载文件夹或使用本地目录。最后,它解释了如何将扩展发布到 cate-extensions 目录仓库,包括同步 UI 套件、运行 build.sh 验证以及通过 PR 合并自动发布。

适合
  • Cate 用户想要创建一个小型私有工作区面板,例如 JSON 格式化工具或笔记视图,可以通过就地搭建得到。
  • 希望构建一个面向公众的扩展,并使用共享 UI 套件以及标准发布流程的开发者,会克隆 cate-extensions 仓库并搭建目录。
  • 希望为其内部工具添加文件系统、网络或进程访问权限的开发者,可以选择带服务器的后端扩展,使用 Node 服务器。
  • 希望为现有扩展添加新的面板,或修改清单以请求新作用域的开发者。
  • 希望将扩展提交到官方目录,并需要理解 PR 审查流程和发布机制的开发者。

如何安装这个 Skill?

使用前请注意
  • 该技能的核心功能可能依赖GitHub上的服务(如cate-extensions仓库),在中国大陆网络环境下可能无法访问,需考虑替代方案。
  • 发布者身份未经验证,尽管文档描述了安全机制,但实际执行中的安全性需在真实环境中验证。
  • 静态审查无法验证运行行为,建议在真实环境中测试技能的关键路径。
开始前你需要
Agent 需要具备
  • Shell / 命令行
需要预先安装
  • Node.js
  • npm

该技能本身不需要安装,因为它作为技能仓库提供。要使用它,请确保你的代理可以访问此技能文件(SKILL.md)。要设置 Cate,请从 GitHub 发布页下载最新版本。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/0-AI-UG/cate.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cate-extension" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 为我的项目创建一个 Cate 扩展

启动技能并请求如“为我的项目创建一个 Cate 扩展”之类的操作。然后按照指南操作:决定是纯前端还是带服务器后端,选择是在目录仓库中搭建还是就地搭建。编辑 manifest.json,声明所需的作用域(cateApi),并参照 window.cate API 文档实现前端。在本地通过侧载文件夹测试。最后,按照发布部分提交 PR 到 cate-extensions 仓库。

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

优点
  • 提供清晰的分步指导,涵盖从搭建到发布全过程。
  • 包含完整的 window.cate API 参考,并附有作用域表。
  • 明确了纯前端和带服务器后端扩展的区别。
  • 强调了安全工作(HOST 绑定、作用域限制)。
  • 包含预提交检查清单。
局限
  • 仅适用于 Cate 特定扩展,不适用于其他软件。
  • 外部服务(如目录仓库)不在本技能范围内,但已经有仓库 URL。
  • 未提供实际示例代码,需要参考已发布的扩展。
  • 测试要求未详细说明,仅提到使用 vitest 约定。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Cate 扩展开发技能 本页 61 · 推荐 ★ 2.2k 8 天前 MIT
PinMe Worker 认证 API 集成 59 · 推荐 ★ 3.7k 3 个月前 MIT
RenderCV Typst 包发布助手 51 · 谨慎使用 ★ 18k 6 个月前 MIT
Expo DOM 组件助手 49 · 谨慎使用 ★ 2.7k 6 天前 MIT
cmux Socket 策略规范技能 58 · 推荐 ★ 28k 1 天前 NOASSERTION

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
61/ 100 五分制 3.1 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全22 / 25 · 4.4/5

技能文档明确描述了基于作用域的默认拒绝安全模型、用户同意要求、服务器必须绑定127.0.0.1且验证令牌、发布时进行安全审查等。同时提供了清晰的回滚和恢复路径(如重启、重新发布)。发布者身份未经验证,但文档本身未隐瞒风险。扣分原因:权限最小化、确认和回滚机制虽已描述,但缺乏实际执行证据或具体实现细节,且发布者未验证。

2可靠稳定8 / 20 · 2.0/5

技能文档自洽,提供了清晰的构建、测试和发布流程,以及明确的错误处理方式(如'无法继续'的说明)。但静态审查无法验证实际运行情况,且未提供可复现的测试用例或错误处理示例。扣分原因:愉快路径可行但测试和边界情况处理证据不足。

3适用触发11 / 15 · 3.7/5

技能目标场景明确(创建Cate扩展),提供了清晰的边界(如无终端作用域)和触发条件(使用manifest、cateApi等)。但环境适配性不足:核心功能可能依赖GitHub上的外部服务,在中国大陆访问可能受限。扣分原因:未明确说明非目标范围,且对网络环境需求未做充分披露。

4规范维护10 / 15 · 3.3/5

文档结构清晰,有分层递进的信息(从简介到详细API),包含安装指南、示例和FAQ(通过参考资料),并声明了已知限制。但缺少版本历史、完整的变更日志和维护责任声明。扣分原因:缺少版本控制信息和维护路径说明,发布者身份未验证。

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

技能声称能完成创建、测试、发布扩展的任务,提供了具体的步骤和验证方法(如./build.sh)。但静态审查无法验证实际输出质量,且未提供代表性输出样例。边际价值高于手动操作,但证据有限。扣分原因:核心任务完成可能性高但输出完整性和直接可用性证据不足。

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

文档提供了构建和测试的命令,但静态审查无法复现执行。虽有CI工作流文件(ci.yml)显示在多个平台构建和测试,但未覆盖技能关键路径的独立可复现结果。扣分原因:无执行证据,主要依赖作者描述和静态文件。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年8月7日 审查版本 b0b2d947809e 评估证据[1][2][3][4][5][6][7][8]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

需要什么权限?
扩展必须在其 manifest 的 cateApi 字段中声明所需的作用域。任何未在作用域内调用的 cate.* 方法将返回 'scope-denied' 错误。带服务器的扩展默认获得有限的权限;服务器进程在启动后不受沙箱限制,因此 PR 审查会关注安全方面。
如果我的扩展需要终端访问怎么办?
扩展没有终端作用域:cate.terminal.* 仅限 Cate 自己的 CLI 使用,扩展调用会返回错误。如果需要终端功能,必须通过服务器后端的 Node 进程实现。
如何在不重新发布的情况下测试扩展?
你可以使用“添加本地文件夹”侧载扩展目录,或者使用本地目录,该目录每次打开面板时都会重新配置。
发布到目录会收取费用吗?
该技能未提及任何费用。目录是开源仓库(0-AI-UG/cate-extensions),合并 PR 会自动发布。

同仓库的其他 Skills

均来自 0-AI-UG/cate

相关 Skills