CETA AI Skills User Guide

• 项目地址：如 https://my-project.ceta.bizops.com.cn
• 用户名：如 zhangsan@company.com
• 密码

AI 会自动生成 .test-runner/credentials.json（已 gitignore 不入库）。你也可以直接复制 credentials.example.json 手动填入。

与其描述"XX 项目的 YY 模块的 ZZ 流程"，不如直接把平台页面的 URL 粘贴给 AI：

• 项目 URL：https://ceta.example.com/admin/project/detail/1519 → AI 自动提取 projectId
• PBC URL：https://ceta.example.com/admin/pbc/12560/form → AI 自动提取 pbcId
• 表单 URL：https://ceta.example.com/admin/pbc/12560/form/268960 → AI 自动提取 formEntityId
• 流程 URL：https://ceta.example.com/admin/pbc/12560/flow/108303 → AI 自动提取 flowDefinitionId
• 页面 URL：https://ceta.example.com/admin/pbc/12560/page/55021 → AI 自动提取 pageId

这比用文字描述资源位置更快、更准确，且避免 AI 花额外调用去搜索定位资源。

有视觉要求时，AI 会先从设计源提取 design.md（颜色/字号/间距/组件），再据此生成所有页面和表单，保证视觉一致。三种输入方式：

design.md 每个项目只从初始设计源生成一次，之后复用；只有你明确要求改主题时才重新生成。

这只是构建常用资源的一部分。完整的能力/技能清单见 Skill Hub 首页的「Skills 一览」。

不需要你提供的：projectToken（AI 自动推断+查重）、测试用例（Phase 3.5 自动从需求生成）。design.md 可以你给，也可以 AI 从原型自动提取。

Gate 1.5 通过后 AI 全自动跑完 Phase 3→3.5→4→5→5.5→6，做完再汇报。

核心保证：每条 sealed AC 至少有一个测试用例覆盖（不可自动化的标 [MANUAL]）。

什么时候需要

• Flow 中需要调用外部 API（如 SAP、ERP、WMS、第三方服务）
• 需要从外部系统拉数据到 CETA 表单中显示
• 需要在流程节点中推送数据到外部系统

用户需要提供

AI 做什么

1. 创建 ConnectorType（v2 API: POST /connector/api/connector-type）
2. 创建 Action（具体操作，含 mapperScript Groovy 脚本）
3. 创建 Connector 实例（填入凭证参数）
4. 测试连通性（connector_test）

触发 SKILL：skills/ceta/ceta-connector/SKILL.md

什么时候需要

• 平台内置组件无法满足需求（如自定义图表、3D 可视化、特殊交互控件）
• 需要嵌入第三方 JS 库（如 ECharts、Three.js、地图组件）
• 需要跨页面复用的自定义业务组件

用户需要提供

前置条件

需要 Node.js 环境（AI 会引导安装）

AI 做什么

1. 运行脚手架 create-icp-extension（非交互式）
2. 安装依赖 npm install
3. 编写组件代码（React）
4. 构建 npm run build
5. 上传到 CETA 平台

触发 SKILL：skills/ceta/ceta-extension/SKILL.md

什么时候需要

• 流程需要接收外部系统推送的 Kafka 消息（如订单、告警、状态变更）
• 需要在流程节点向 Kafka 发送消息
• 要把 CETA 接到企业已有的 Kafka/RabbitMQ/RocketMQ 消息总线上

MBS（Message Broker Service）把各类消息队列封装为统一 HTTP API，通过 Webhook 推送让 CETA Flow 收发消息。

AI 做什么

1. 创建 MBS Connector
2. 配置回调流程（接收消息）
3. 注册订阅，打通生产/消费链路

触发 SKILL：skills/ceta/ceta-mbs-kafka/SKILL.md

⚠️ MBS 接口因环境/版本而异，AI 会以安全流程搭建，无法从当前环境确认的值会保留为待确认项，需在目标环境做 E2E 验证后再上生产。

什么时候需要

• 要在项目里配置一个可对话/可调用的 AI 智能体
• 刚导入完「智能应用 / 智能体项目」基座，需要初始化 Model、Channel、Agent

AI 做什么

1. 自动创建 Model、Channel、Agent、Instructions
2. 引导你在 UI 完成需要项目级权限的部分（绑定模型、角色、API Key）

触发 SKILL：skills/ceta/ceta-agent-setup/SKILL.md（创建智能应用项目见 ceta-pbc-clone）

⚠️ 不能全自动：平台域名与项目域名认证隔离，绑定模型/查项目角色需项目级认证，这部分由你在 UI 完成。

如果你中途关闭了会话（比如下班了），第二天回来时：

• AI 会自动检测 pipeline-state.json 中有未完成的阶段
• 主动提醒你："你有一个进行中的 pipeline（当前在 Phase X），要继续还是单独改？"
• 说"继续" → 从断点恢复路径 B
• 说"帮我改一下 XX" → 走路径 A 单资源修改，不干扰 pipeline

Q: 文件放到哪里？

图片/PDF 可以直接拖入对话。HTML 文件例外——需要放到项目文件夹内再告诉 AI 路径（拖入对话会丢失 JS/CSS）。AI 会自动归位到正确目录。

Q: 路径 A 和 B 可以混合使用吗？

可以。路径 B 进行中也能随时做路径 A 的单资源修改。第二天回来 AI 会问你要继续 pipeline 还是单独改。

Q: 项目名 / token 需要我定吗？

不需要。AI 会从你的需求描述中推断 token（kebab-case），并自动检查平台上是否已存在相同 token，确保唯一性。你也可以主动指定。

Q: design.md 需要我准备吗？

两种方式都可以：A) 你直接提供 design.md 或设计系统文档；B) 给 AI 原型文件（HTML/图片），AI 自动分析提取颜色、字号、间距等视觉 token。没有原型也没有设计规范则跳过视觉相关步骤。

Q: 凭证怎么管理？

直接告诉 AI 项目地址、用户名、密码即可，AI 自动生成 .test-runner/credentials.json（已 gitignore）。仅在验证阶段使用。不需要验证就不需要提供。

Q: Python Builder 是什么？

一套 Python 工具库，用编程方式生成 CETA 配置。AI 自动生成脚本并执行，你不需要手写 Python。产出的脚本可复现、可 review。

Q: 什么时候需要 Connector？

当业务流程需要调用外部系统 API 时（如 SAP、ERP、第三方服务）。你提供 API 文档和认证信息，AI 创建连接器。

Q: 什么时候需要 Extension？

当平台内置组件无法满足 UI 需求时（如自定义图表、特殊控件）。需要 Node.js 环境。

Q: 运维操作支持吗？

支持 10 个运维领域：应用配置、Redis、集群架构、KingBase/PostgreSQL 数据库、部署编排、性能分析、NFS 存储、可观测性监控、安全凭证。说关键词即可。

Q: 什么是 Partner 确认闸门？

在平台上新建任何项目/PBC/资源之前，AI 会先确认建到哪个 partner（合作方/组织归属）下。这是所有构建路径的强制前置步骤，避免项目建错归属。你在需求里明确指定（如"建到 DXC Internal"）就不会重复问；纯修改/查询/数据操作不触发。

Q: 可以用 Figma 吗？

可以。直接给 Figma Frame 链接，AI 会把它导出成 HTML/资源，再走 html-analyzer 生成 CETA 配置。Figma、HTML、图片三种设计输入最终都汇入同一条管线，先生成 design.md 再据此建页面。

Q: 完整的技能/能力清单在哪看？

本手册只覆盖常用工作流。Skill Hub 首页的「Skills 一览」列出了全部技能模块和可调用的 API Actions。你也不需要记这些——直接说需求，AI 会自动加载对应技能。