SuperAPI AI 工具集

freshworks-app-dev-skill

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:作为 Freshworks Platform 3.0 的资深解决方案架构与规则执行层,用于构建、调试、审查和迁移 Freshworks 市场应用。

主要能力:强制仅使用 Platform 3.0 模式,零容忍 2.x 写法;校验清单正确性,要求每个应用通过 fdk validate;对错误分类并给出精确修复;偏向生产级架构。若确定性不足 100%,回应“Insufficient platform certainty.”。

关键规则:platform-version 必须为 3.0;使用 modules 而非 product;弃用 whitelisted-domains,改用请求模板;用 $request.invokeTemplate() 替代 $request.post/get/put/delete;OAuth 必须带 integrations 包装,凭据放在 oauth_config.json 的 oauth_iparams 中。Host 必须为纯 FQDN,不得含路径或编码字符,动态主机用 <%= context.subdomain %>.example.com,路径以 / 开头。前端应用必须创建 app/styles/images/icon.svg。请求模板用 <%= context.variable %>、<%= iparam.name %>、<%= access_token %>,不用 {{variable}}。async 函数必须含 await,否则报 lint 错误。

使用方式:先判断应用类型(前端、纯服务端或混合),按需加载 assets/templates/ 下的骨架模板;实现顺序为清单、服务端 API、前端、配置、资源。创建文件后自动运行 fdk validate,仅修复致命错误,最多两轮迭代,忽略 lint 错误与警告。OAuth 仅在第三方服务强制要求时使用,否则用 iparams 中的 API key。

适用场景:Freshdesk/Freshservice 等产品的侧边栏、全页应用、后台同步、通知与外部 API 集成开发。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分引用文件(如 references/ 与 .cursor/rules/)内容暂未提供。