Bmob cloud function development

Skill bmob/agent-skills/skills/bmob-cloud-function-development

Open-standard Agent Skills for Bmob backend cloud — usable in Cursor, Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, and any agentskills.io-compatible AI tool.

Install

npx -y skills add bmob/agent-skills --skill bmob-cloud-function-development

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Write, upload, and verify Bmob server-side cloud functions using the Bmob MCP server when available. Use when the user asks to 编写云函数, 写云函数, 上传云函数, 部署云函数, 发布云函数, 验证云函数结果, or mentions `function onRequest(request, response, modules)`.

SKILL.md

5.3 KB, as published. Nobody here has run it

Bmob 云函数开发

用于写运行在 Bmob 服务器上的云函数源码，并在已配置 MCP 时走 deploy_cloud_function → invoke_cloud_function 完成上传与验证。

先判断走哪条通道

已配置 Bmob MCP：优先用 bmob-mcp
- 上传源码：deploy_cloud_function
- 单独验证：invoke_cloud_function
未配置 MCP：按云函数文档与 REST /1/functions/<name> / 控制台流程给代码与 curl

语法基线

默认按 Bmob 云函数文档的 Web/Node 风格写：

function onRequest(request, response, modules) {
  response.send("hello");
}

GET 直连参数：request.query.xxx
POST / REST 参数：request.body.xxx
返回结果：response.send(...)
数据库 / 文件 / HTTP / 加密：从 modules 取 oData、oFile、oHttp、oCrypto 等

必须遵守的已知行为

通过 REST API 调用时，参数从 request.body 取，不是 request.query
云函数里很多回调返回的是字符串，需要 JSON.parse(data) 后再当对象用
已知行为：服务端可能把传入 request.body 的值转成字符串；涉及数字、布尔、数组、对象时，在云函数内显式 parseInt / === "true" / JSON.parse

默认工作流

1. 写源码

函数名与用户要调用的名字一致
优先写最小可验证版本，再逐步扩展
如果要查表 / 改表，先确认表名与字段名；用户已配 MCP 时先读 get_project_tables

2. 上传源码

已配 MCP 时，优先调用：

deploy_cloud_function
- funcName: 云函数名
- code: 源码原文
- language: 1=javascript，2=java
- verify: 需要立即验证时传 1
- verify_data: 验证入参 JSON 字符串，默认 {}

3. 验证结果

如果上传工具已设置 verify=1，直接检查返回里的 verify.response
如果需要多次验证，单独调用 invoke_cloud_function
验证失败时，优先把上传结果、执行返回、传入参数三者一起对照

4. 部署成功后：告知用户如何调用

deploy_cloud_function 成功时，响应里会带 invokeGuide。向用户说明调用方式时：

禁止只写裸 URL（如 POST https://api.codenow.cn/1/functions/xxx）——REST 必须带完整 headers 与 body
优先直接使用 invokeGuide.rest.curl（已含 X-Bmob-Application-Id、X-Bmob-REST-API-Key、Content-Type 与示例 body）
按当前项目类型只展示一种最匹配的 SDK 示例（从 invokeGuide.sdk 选取）：
- 读代码库判断：package.json / Vue / React → javascript；app.json / 小程序 → wechat_miniprogram；build.gradle / Android SDK → android；Podfile / ObjC → ios；BmobCloud.run / SwiftPM → swift；pubspec.yaml / bmob_plugin → flutter；无 SDK 或用户要 curl → restful
- 不确定时：REST curl + 说明「你的项目若是 XX 平台可参考 invokeGuide.sdk.XX」
IDE 内试跑：用 MCP invoke_cloud_function，参数见 invokeGuide.mcp
需要更详细的 curl 样板：可再调 generate_code → type=调用云函数

常见模式

返回简单字符串

function onRequest(request, response, modules) {
  response.send("ok");
}

读取 POST 参数

function onRequest(request, response, modules) {
  var name = request.body.name || "guest";
  response.send("hello " + name);
}

查表后返回结果

function onRequest(request, response, modules) {
  var db = modules.oData;
  db.find({"table":"Games"}, function(err, data) {
    if (err) {
      response.send(err);
      return;
    }
    response.send(JSON.parse(data));
  });
}

失败时怎么处理

云函数不存在：确认 funcName 与上传目标一致
验证返回结构不对：检查用的是 request.body 还是 request.query
数字/布尔判断异常：按“值会变字符串”处理
数据库回调类型不对：先 JSON.parse(data)
仍失败：回到最小版本，只保留 response.send("ok") 验证发布链路

何时降级

以下情况不要硬走自动上传：

用户没有配置 MCP
需要大体量源码而工具入参不方便承载时
用户明确只要示例代码，不要真实部署

此时提供源码 + REST 上传说明，并明确未做在线验证。