BPMAX Business Skill（BBS）

BPMAX Business Skill（BBS）是面向 BPMAX 业务场景的可安装 Skill 包。它把流程查询、表单填写、审批处理、数据分析、跨页面操作等能力沉淀为标准化说明和命令，让 Agent 可以按稳定规则完成重复业务任务。

BBS 通常由业务人员、实施人员或开发者维护，通过 bpmax-cli 发布到 BPMAX 远端，再由使用端按需同步和懒加载安装。

BBS 是什么

BBS 本质上是一个标准 Skill zip 包，根目录包含 SKILL.md，可选包含 bbs.json、脚本、示例输入和测试文件。

  • SKILL.md 描述这个业务能力的触发场景、操作步骤、命令和注意事项。
  • bbs.json 用于声明 lint 和业务 gate，约束发布质量和关键业务动作。
  • zip 包发布到 BPMAX 后，会形成可版本化管理、可安装、可升级、可卸载的组织级业务能力。

BBS 不替代 BPMAX 的流程、表单和权限体系。它是在这些能力之上，为 Agent 增加一层可复用的业务操作说明。

适用场景

BBS 适合沉淀稳定、可重复、需要上下文判断的 BPMAX 操作：

  • 审批批量处理，例如清单外入库审批、预算审批、合同审批。
  • 流程单创建引导，例如出差申请、报销申请、供应商创建。
  • 业务查询和统计，例如预算使用情况、库存异常、销售数据汇总。
  • 跨页面操作沉淀，例如先查流程、再读详情、再打开页面确认字段。
  • 组织内能力复用，例如总部维护一个业务 Skill，各部门 Agent 按需安装。

不建议把 BBS 用于一次性临时脚本、规则尚不稳定的探索任务，或需要直接修改 BPMAX 平台代码的功能。平台功能改造应通过正常前后端开发完成，BBS 只负责把已有业务能力组织成可执行的 Agent 操作规范。

推荐开发方式

推荐使用 Codex + GPT 模型开发 BBS。BBS 的价值不只是写一份说明，而是把真实页面、接口、字段、权限和异常路径分析清楚，再沉淀为 Agent 可以稳定执行的 Skill。

推荐使用 Codex，是因为 BBS 开发通常需要同时完成代码阅读、CLI 调用、浏览器观察、接口分析、Skill 编写和回归验证。Codex 可以在同一个上下文中连接本地仓库、运行 bpmax-cli、查看页面行为，并把发现的问题直接沉淀到 SKILL.md 和 bbs.json 中，减少“只写说明但没有验证真实业务链路”的风险。

开发前，先在 Codex 中初始化 bpmax-cli 并连接目标环境：

帮我安装并初始化 bpmax-cli, 具体内容参考文档： https://doc.bpmax.cn/develop/bpmax-cli/agent-quickstart.html

连接完成后，让 Codex 结合浏览器能力分析 BPMAX 页面：

  • 打开目标业务页面，确认入口、列表、详情、创建页和审批页。
  • 观察页面请求，识别真实接口、请求参数、返回字段和错误信息。
  • 使用 Chrome DevTools MCP 或 Playwright 调试自动化产生的问题，例如表单预填失败、关联字段未选中、金额或日期数值错误、提交后校验不通过。
  • 对照 bpmax-cli 能力，优先使用 CLI 已封装命令；缺失能力再补 CLI 或通过页面交接。
  • 明确哪些字段可以自动填写，哪些字段必须让用户确认或在页面中选择。
  • 把高风险动作写入 guardrail，例如审批前必须展示上下文、批量处理必须确认范围。

开发流程

  1. 连接环境：在 Codex 中完成 bpmax-cli init，确认 auth status 正常。
  2. 分析业务：通过浏览器和 CLI 查询流程、项目、表单模板、审批环节和接口数据。
  3. 定义 Skill：编写 SKILL.md，明确触发条件、输入信息、执行步骤、失败处理和用户确认点。
  4. 增加 gate：审批、批量修改、提交类 BBS 建议增加 bbs.json，声明 preflight 和 verify。
  5. 本地检查：运行 bpmax-cli bbs lint --zip ./skill.zip --format json。
  6. 发布升级：使用 bpmax-cli bbs create 或 bpmax-cli bbs upgrade 上传到 BPMAX。
  7. 安装验证：使用 bpmax-cli bbs sync 更新 Catalog，再通过 bpmax-cli bbs ensure 安装并测试真实场景。

发布与使用

发布前先 lint：

bpmax-cli bbs lint --zip ./skill.zip --format json

创建或升级 BBS：

bpmax-cli bbs create \
  --name "预算查询" \
  --scene "预算分析" \
  --zip ./skill.zip \
  --profile demo-default \
  --format json

bpmax-cli bbs upgrade <key-or-id> \
  --zip ./skill.zip \
  --release-note "补充预算执行率统计" \
  --profile demo-default \
  --format json

使用端先同步 Catalog，再按需安装具体 BBS：

bpmax-cli bbs sync --agent codex --profile demo-default --format json
bpmax-cli bbs ensure <key-or-id> --agent codex --profile demo-default --format json

需要业务 gate 的场景，在关键动作前后执行：

bpmax-cli bbs gate <skill-key> --stage preflight --input @input.json --profile demo-default --format json
bpmax-cli bbs gate <skill-key> --stage verify --input @result.json --profile demo-default --format json

更多 CLI 命令和管理页面说明见 BPMAX CLI 使用说明。