Agent 开发 Bundle

用 AI Agent + buildify-bundle-dev skill 开发 Bundle：Agent 安装 skill 后，按规范生成节点代码、表单与 SPI，校验打包并发布到 Buildify，你在画布热更新测试即可。

凡支持 Skill 能力的 Agent 均可使用（Cursor、Claude Code、Windsurf、Codex 等），安装方式相同——把安装指令发给当前 Agent 即可。

安装 skill → 描述需求 → Agent 开发 → 校验打包 → 发布 → 画布验证

---

支持的 Agent

以下 Agent 均支持 Skill，安装路径由 Agent 自动识别（完整列表见 INSTALL.md）：

Agent	Skills 目录（全局）	项目级
Cursor	~/.cursor/skills/	.cursor/skills/
Claude Code	~/.claude/skills/	—
Windsurf	~/.codeium/windsurf/skills/	.windsurf/skills/
Codex	~/.codex/skills/	.agents/skills/
Gemini CLI	~/.gemini/skills/	—
Google Antigravity	~/.gemini/antigravity/skills/	—
QoderWork	~/.qoderwork/skills/	—
WorkBuddy	~/.workbuddy/skills/	—

OpenClaw 及同类 Agent（NanoBot、PicoClaw、CoPaw 等）也支持，skills 目录取决于具体产品，Agent 读取 INSTALL.md 时会自动适配。

通用规则

• 安装目录名必须是 buildify-bundle-dev（与 skill 的 name 一致）
• 全局安装所有项目可用；项目级安装便于团队共享
• 各 Agent 引用 skill 的方式不同（如 Cursor 的 @buildify-bundle-dev），按产品文档操作即可

---

安装 Skill（推荐）

复制下面这句话，发给当前 Agent 即可自动安装：

请阅读 https://buildify.cn/INSTALL.md，安装 buildify-bundle-dev

Agent 会读取官方安装说明，将 skill 克隆到当前 Agent 对应的 skills 目录（如 Cursor 为 ~/.cursor/skills/buildify-bundle-dev），并完成校验。

安装完成后

• 新开一轮 Agent 对话（或重启客户端），skill 才会被识别
• 按所用 Agent 的方式引用 skill（如 Cursor：@buildify-bundle-dev）
• 发布工具（buildify-publish CLI）无需手动安装——开发或发布时 Agent 会按 skill 指引自动查找、安装并使用

更新 Skill

请阅读 https://buildify.cn/INSTALL.md，更新 buildify-bundle-dev

---

用 Agent 开发节点

安装 skill 后，直接描述需求。示例对话以 Cursor 的 @buildify-bundle-dev 为例，其他 Agent 可在提示词中说明「使用 buildify-bundle-dev skill」即可。

新建 Bundle：

@buildify-bundle-dev

帮我新建一个 Bundle：
- 目录：./my-wecom-bot
- groupId：com.example，artifactId：my-wecom-bot
- bundleName：example/my-wecom-bot
- 包名：com.example.wecom
- 节点：WeComBotNode（调用企业微信 webhook 发消息）
- 凭证：WeComBotCredential

完成后校验、打包，并告诉我如何发布。

已有项目加节点：

@buildify-bundle-dev

在 ./bundle-http-client 中新增 HttpDownloadNode，
补全表单、SPI 和 bundle.json，不要重新 scaffold。校验通过后打包。

Agent 会自动推进以下步骤：

步骤	Agent 负责
生成 / 修改代码	FlowNode、凭证、MethodExecutor、SPI
编写配置	bundle.json、properties 表单
校验闭环	运行 validate_bundle.py --strict，修复 ERROR 后重跑
打包	mvn clean package
发布	查找 / 使用 buildify-publish，上传 JAR

你只需确认业务需求、参数含义与画布上的运行结果。

---

发布到 Buildify

开发完成后，让 Agent 发布即可：

@buildify-bundle-dev

把 ./my-wecom-bot 发布到 Buildify，版本 1.0.0-SNAPSHOT，附带 CHANGELOG。

Agent 会按 skill 规范：

1. 确认 bundle.json 的 bundleName 与 pom.xml 版本
2. 准备 CHANGELOG.md 作为 releaseNote
3. 调用 buildify-publish bundle upload 上传 JAR

首次发布需在 控制台 创建 Publish API Key，将 keyId.secret 交给 Agent 或自行配置：

printf '%s' 'keyId.secret' | buildify-publish config set-api-key
buildify-publish key test

版本类型	说明
*-SNAPSHOT	可 --overwrite 反复覆盖，适合画布联调
正式版	不可覆盖，联调通过后升版发布

---

在画布上验证

1. 登录 控制台，打开工作流画布
2. 从节点面板拖入刚发布的 Bundle 节点
3. 配置凭证与参数，保存并测试
4. SNAPSHOT 迭代时可让 Agent 重新上传同版本，画布热更新加载

建议：SNAPSHOT 联调 → 升正式版 → 分发到生产工作节点。

---

相关文档

• SDK API 参考 — FlowNode、Context、凭证 API
• 节点表单配置 — properties 表单与 uiComponent
• 快速开始 — 画布编排入门

---

附录：前置环境

工具	版本	说明
支持 Skill 的 Agent	—	Cursor、Claude Code、Windsurf、Codex 等（见上文）
JDK	21+	编译 Bundle
Maven	3.8+	构建 fat JAR
Python	3.8+	skill 校验脚本
Buildify 账号	—	控制台与发布密钥

Agent 会在需要时提示安装缺失工具；也可提前装好 JDK、Maven。

---

附录：手动安装 Skill

若 Agent 无法联网，可手动克隆到对应 skills 目录。以 Cursor 为例：

git clone --depth 1 https://github.com/buildify-bundles/buildify-bundle-dev-skill.git \
  ~/.cursor/skills/buildify-bundle-dev

其他 Agent 将路径中的 ~/.cursor/skills/ 替换为上表对应目录即可，例如 Claude Code 用 ~/.claude/skills/。

目录名

安装目录必须是 buildify-bundle-dev（与 SKILL.md 的 name 一致），不要用仓库名 buildify-bundle-dev-skill。

项目级安装（Cursor 团队共享示例）：

mkdir -p .cursor/skills
git clone --depth 1 https://github.com/buildify-bundles/buildify-bundle-dev-skill.git \
  .cursor/skills/buildify-bundle-dev

完整安装说明见 buildify.cn/INSTALL.md。

---

附录：手动校验、打包与发布

校验：

python3 ~/.cursor/skills/buildify-bundle-dev/scripts/validate_bundle.py ./my-wecom-bot --strict

打包（必须带 clean）：

cd my-wecom-bot && mvn clean package -DskipTests

安装发布 CLI：

pip install buildify-publish-cli

上传：

buildify-publish bundle upload \
  -n 'example/my-wecom-bot' \
  -v '1.0.0-SNAPSHOT' \
  -f ./target/bundle-my-wecom-bot-1.0.0-SNAPSHOT.jar \
  --overwrite \
  --release-notes-file ./CHANGELOG.md

字段	来源
bundleName	src/main/resources/bundle.json
版本号	pom.xml 的 <version>

---

附录：常见问题

Skill 未识别 — 确认 skill 安装在当前 Agent 的 skills 目录下，且文件夹名为 buildify-bundle-dev；新开 Agent 对话后再试。Cursor 用户可用 @buildify-bundle-dev 显式引用。

credentialsType 不一致 — PascalCase 类型须在 @CredentialsDescription(type)、表单 credentialsType、credentials/<Type>.json 三处一致。见 SDK API · 访问凭证。

发布后画布看不到节点 — 检查 bundleName 是否一致，刷新节点面板，或用 buildify-publish bundle info 确认版本已上传。