要加的只是“桥”
- 读取业务数据的接口，以及接收 AI 提案的接口
- manifest（系统的自我介绍）
- 员工绑定自己的聊天账号（用系统自己的登录）
- 由业务系统决定收件人的规则
- 状态变化与事件在同一事务中写入
- 审批规则 · 定时报告（只有件数）
三种挂载方式
- Node.js：在现有服务器上挂载 server-kit，把 hooks 接到现有的表和函数
- 已有同等功能的 API：把 /bridge/v1 作为现有路由的别名
- 其他语言：用该语言实现 OpenAPI 3.1，并用一致性测试验证
生来就与 AI 员工一起工作
- 基于 server-kit 开发，“桥”的部分由组件提供
- 你只写业务、hooks、manifest 和画面
- 可以参考示例业务系统的结构与写法
bridge.manifest.yaml # self-description src/auth.mjs # authenticate · isSessionLive src/domain.mjs # business rules · tx + emitEvent src/hooks.mjs # employees · recipientsFor · approvals src/routes.mjs # /api/* · readToolPolicy manual/NN-*.md # one screen = one section test/conformance.test.mjs web/ bff/ # web-kit · gateway
不改代码，把桥放在外面
- 登录可以从外部验证（OIDC / SAML）
- 可以以本人身份调用 API
- 提交后会通知变化（webhook / CDC）
- 有审批与写入的 API
A四项都有 → 全部功能
B有 API 但不能以本人身份调用 → 通知与报告
C只有画面 → 补 API，或重新开发
Checklist
要为业务系统补充的内容（13 项）
即使业务中不用，也要以最小形式保留审批与定时报告（以便一致性测试无跳过项）。
| # | 补充内容 | 类别 |
|---|---|---|
| 1 | 读取业务数据的接口，以及接收 AI 提案的接口 | 必需 |
| 2 | manifest（--strict 无警告） | 必需 |
| 3 | 本人绑定聊天账号的画面（使用系统自己的登录） | 必需 |
| 4 | 由业务系统决定收件人的规则（与 Web 授权同一判断） | 必需 |
| 5 | 状态变化与事件在同一事务中写入 | 必需 |
| 6 | 员工与角色（含启用 / 停用） | 必需 |
| 7 | 审批规则集中在一个函数里 | 必需 |
| 8 | Web 会话的有效性确认 | 必需 |
| 9 | 面向员工的操作手册（一个画面一节） | 推荐 |
| 10 | 基于名册的个人信息检查 | 推荐 |
| 11 | AI 员工人设的编辑 | 推荐 |
| 12 | 定时报告（只有件数） | 必需 |
| 13 | 外部连接 | 可选 |
Seven steps
七个步骤与完成条件
1编写并校验 manifest
2实现 hooks（或为现有 API 起别名）
3在事务中写事件
4一致性测试 52 / 52
5注册到 AI 面的 profile
6业务 Web 的画面与 BFF
7启用自动任务
# 1 manifest bridge-validate manifest bridge.manifest.yaml --strict exit 0 # 2 conformance (TEST environment) node --test conformance/http.test.mjs 52 passed · 0 skipped # 3 your own tests node --test test/*.test.mjs all pass # 5–6 product profile · outbound settings closed node profile/scripts/check.mjs cordis.patch.yml exit 0 # 8 business web tsc --noEmit no errors
🎯
从一项业务开始
先从审批、逾期等一项开始，与现有画面并行验证后再扩大。
📐
先评估工作量
读取 API 与登录是根基，不同系统需要补充的量差别很大。
🧩
与 AI 智能体一起推进
导入 skill 会引导 AI 编程智能体完成 诊断 → 计划 → 实现 → 验证。