用途:该技能面向 Freshworks Platform 3.0 市场应用的开发全流程,覆盖构建、调试、审查路由与迁移,由上层控制器按“构建→审查→发布”顺序调用,每次只执行一个开发步骤并返回 done、blocked 或 escalate。
主要能力:智能前置检查(识别 Platform 2.x 迁移、清单 engines 过期、工具链不匹配、新应用生成);manifest 校验与强制约束;编排 fdk validate 并最多自动修复 6 轮;OAuth 配置、requests.json 与 serverless 校验;React Meta(DEW)与原生 Crayons UI 指导。平台文档问题优先使用 MCP get_developer_docs,不可用时回退到技能内 references/ 与 rules/。
必要用法:任务开始前先运行 node --version 与 fdk version,并读取 manifest.json 的 platform-version、engines.node、engines.fdk。工具链为 FDK 10.x + Node 24.x 且清单为 3.0、engines 匹配时可直接执行任务;若清单为 2.x 或 engines 为 18.x/9.x,应先迁移或上调 engines,不得为迁就旧清单而降级工具链。新应用 engines 建议 React Meta 用 fdk 10.1.0 + node 24.11.0,原生 JS/serverless 用 fdk 10.0.1 + node 24.11.0。应用必须包含 README.md,且 fdk validate 需达到 0 平台错误与 0 lint 错误才算完成。
限制:本技能不安装、升级或修复 FDK 与 Node.js,相关操作属于 fw-setup 技能;若 fdk 缺失或版本不符,应停止执行并引导用户先完成工具链安装。不得调用已废弃的 MCP 构建工具(implement_app、get_implementation_plan、idea_to_app、fix_app_errors)。.meta.json 只能通过 ~/.fw-dev-tools/scripts/ 下的脚本写入,不得手写。降级到 node 18.20.8 + fdk 9.8.2 仅作为用户环境受阻时的一次性最后手段,发布前仍需恢复 10.0.1 + 24.11.0。具体命令与脚本参数以原始资料为准,其余细节暂未提供。