灵基一动丨灵基Build有多快?让苍穹报表开发从1.5人天到3h

某大型集团ERP升级项目在金蝶苍穹上用灵基Build交付定制报表,把单张报表从1.5人天压缩到3小时。文章拆解其可复制做法:用需求澄清指令把原始需求变成11节标准规格,再一次请求跑完建模、字段重建、插件适配到菜单绑定与验收全链,辅以标准答案库、AC清单、带可信度标签的提示词迭代与避坑沉淀,让AI报表开发从个人发挥变成团队可照抄的工程方法。

时间2026-11-12

浏览量2

灵基一动丨灵基Build有多快?让苍穹报表开发从1.5人天到3h

某大型集团 ERP 升级项目,在苍穹上用灵基 Build 交付了一批定制报表。他们的提速不靠某一次 AI 发挥得好,靠的是一套谁都能照抄的做法。这篇把这套 AI报表开发的做法拆开,给你步骤、提示词和模板。

一、先看结论

灵基 Build 的产出有多好,取决于你给它的输入有多清楚。

口头说一句需求,你会得到一张“能跑”的报表。给它一份结构化的需求规格,你会得到列序、精度、过滤控件、必录提示、菜单归属都对的报表。这个项目把下面四件事做成了固定动作:

你能带走什么:一张六步操作卡(第 10 节),以及可以直接复制的需求澄清指令、11 节规格模板、项目提示词骨架、执行指令模板、避坑记录模板和收工清单。

二、这个项目做了什么

这是一个大型集团 ERP 升级项目,在金蝶苍穹上做定制插件工程。范围从采购、质量检验、库存、销售、结算,一直到报表分析。报表开发是其中的重头。

这些报表并不简单。某库存台账报表横跨 5 个极速报表数据源(Flink 计算引擎)。某多单据统计报表关联三张业务单据,输出 26 列。还有带数据权限(getDataRule)、信用查询(跨业务中心微服务)、运行态类型形态(防 ClassCastException)这些复杂场景。复杂度够高,这套方法才值得参考。

每张报表都走同一条链路:

澄清成文用一次会话。建模到插件用一次请求。人只在两头把关:开头确认口径,结尾在页面上验收。

项目做完,留下了四样可以反复用的东西:

三、人和灵基怎么分工

这个项目最先“工程化”的不是代码,是需求本身。你上手时也一样:先把需求模板定下来,再谈提速。

四、开工前:把本地工程绑定给灵基

开始开发前,先把你的本地工程模块设为灵基的项目路径。这样灵基改的就是你仓库里的代码。

开工前先把本地工程模块设为灵基的项目路径,灵基改的就是仓库里的代码

确认应用归属:会话绑定目标应用并核对 workspace 元数据身份

同时确认应用归属。会话要绑定目标应用(例如供应链报表应用),并确认 workspace 的元数据身份。元数据写不进别的应用,归属对不上时先问清楚再动手。

五、第一步:把原始需求澄清成标准规格

需求没写清就开工,是返工最大的来源。查询逻辑理解错一列,“建模 → 插件 → 验收”整条链就要重来。

这个项目多数报表是旧系统迁移。顾问手里常常只有一份旧系统的 Word 需求样例和几张截图。截图能说明“长什么样”,说不清“数从哪来、怎么算”。

所以每张报表的第一步不是建模,而是开一个单独的新会话做需求澄清。把原始材料作为附件,输入:

/cosmic-requirements-spec 澄清一下需求,不要臆想,要实事求是地理清报表的查询逻辑。

需求的内容以文字说明为主,图片里的旧系统仅作参考。

需求澄清:把原始材料作为附件,输入需求澄清指令,先澄清后成文

技能的顺序是先澄清、后成文。它先逐项检查数据来源、汇总粒度、过滤时机、取数口径,缺什么就问什么。口径对齐后,才输出规格说明书。顾问不用从零写,只要回答问题、确认规格。

这句指令里每个词都有用

11 节规格,每节都为 AI 执行而设计

1. 报表标识与归属      ← bizName、过滤表单编号、所属应用、菜单挂载

2. 业务场景与目标      ← 一段话,给灵基补语境

3. 数据来源声明        ← S1/S2/S3 来源表:是报表还是实体,决定取数通道

4. 输出列清单          ← fieldKey/类型/精度/冻结/来源/取数口径,逐列填

5. 汇总与聚合规则      ← 汇总粒度、SUM/MAX、过滤时机、日期窗口

6. 过滤条件清单        ← 控件类型/compare/默认值/必填/枚举选项

7. 过滤联动规则        ← F7 候选限定、值清空规则

8. 校验与提示文案      ← 提示原文逐字给(AI 不该自己编文案)

9. 排序规则

10. 数据规模与耗时预期 ← 万级明细/5~10 秒,决定性能策略

11. 验收条件(AC 清单)← 可勾选、可判定

三处设计值得直接抄:

六、第二步:一次请求跑完整条链

规格就位后,开一个开发会话。上传项目提示词和需求规格,发一次请求。灵基按提示词里写好的工作流自己往下走:

1. 报表 Artifact 创建(run 流水线:页面/列/排序/插件/属性一次到位)

2. 字段重建(run 成功后自动衔接):modifyMeta remove+add 重建真实字段类型

3. 配置与插件适配(同轮继续):filterFieldConfig、ShowFilterFields、插件 key 兼容、

必录双层校验、性能取数、窄编译

4. 菜单绑定与终验(同轮收口):addMenu、逐项读回验证、交付卡片

一次请求跑完整条链:报表Artifact创建、字段重建、配置与插件适配、菜单绑定与终验

为什么要“一次跑完”

项目里发现了一个平台机制:报表 Artifact 的 reportFilters[] 是白名单(只有 6 个键),不能声明字段类型。between 会落成日期区间,其余一律是文本框。要让过滤条件变成基础资料 F7、多选、下拉这些真实控件,必须在 run 之后用 modifyMeta 重建字段,再把绑定 key 全链适配一遍。

如果拆成多轮人工指令,用户就得懂 4 个阶段的 CLI 细节。提示词把它写成“run 成功后的固定后续动作,不需要用户再次提示”。用户拿到的是带正确过滤控件的成品,不是还要自己重建字段的半成品。

方法:把多阶段流程写进提示词,让 AI 自己编排。人只在例外点介入。

例外点也要提前写明。例如:需求点名的应用和会话绑定的应用不一致时,停下来问用户。

七、第三步:不猜,先查证

这个项目的提示词里反复出现一个词:实证。“禁止臆想”是写进约定里的,不是口头提醒。几条可以直接搬进你提示词的纪律:

建一个“标准答案库”

项目把 70 张苍穹线上标准报表逐个用 getFormSchema 读回,整理成两张表:24 种字段类型总表,27 个基础资料引用实体速查表。新报表需要什么形态,先去库里查标准答案。

“抄同构标品”是绕开平台隐含假设最省事的路。你可以从自己最常对标的几张标准报表开始建。

一个典型的坑:NumberFormatProvider 的 ClassCastException。精度源 bigint 列传进来是 Long,平台直接强转成 DynamicObject。这种坑文档不写、编译期不报,只能靠实测发现。项目总结的口诀是:

ClassCastException 看“谁强转、强转的输入是谁给的”。顺着栈往下找供给方,修供给侧或解绑消费关系,不要在两层中间加转换层硬扛。

八、第四步:按 AC 清单验收

每张报表都有一份验收报告(如 workitems/<报表名>/acceptance-report.md),按 AC 逐条给出 passed / failed / blocked / not-run 和证据。

先用最小过滤条件跑通全链(查询 → 打包 → 格式化 → 显示 → 导出),再扩大数据量。

验收报告可不可信,看它敢不敢记录失败。

九、第五步:坑当次记下来

每张报表做完,沉淀是一套固定动作:

会话中踩坑

→ workitems/<报表>/report-dev-pitfalls.md(当次记录,单张报表 20~30 条级别)

→ 复盘时精炼进报表开发提示词下一版(修正旧结论、标注可信度)

→ 项目级约定写进项目记忆(memory);平台问题整理进问题清单

只有一条硬规则:避坑知识必须写进提示词或记忆才算沉淀完成。留在会话里等于没沉淀,下次会话灵基看不见。

十、为什么越做越快:提示词的五个阶段

提速的主因,是提示词随每张报表的交付变厚、变准。第 1 张报表要打穿的平台机制,到第 10 张已经是提示词里的一段配方。下面是这个项目的提示词怎么长出来的。你不用一步到位,按这个顺序走就行。

最初几张报表没有提示词,踩的坑会话结束就丢了。补救办法是每张报表落一份避坑文档(单张就记了 28 条)。这时还是流水账,下一次没法直接用。

攻坚复杂报表时,为“一类深坑”单独写专题提示词。同时补齐两块公共资产:标准报表参照库和需求规格模板。

把专题提示词合成一篇,补上流程编排:项目级交付约定、字段重建配方、一次交付自动序列、验证命令清单。从此新报表的输入固定为「提示词全文 + 需求规格」。

合并后 v1 出现了自相矛盾的结论、照抄就编译失败的代码模板、匹配不到内容的 grep 表达式。V2 做了一次系统复审(见下文)。

平台问题整理成清单推动修复;项目硬约定写进记忆;和技能重叠的内容删掉,只留技能没覆盖的部分。同一份知识只在一处维护。

阶段 1 沉淀的专题提示词

阶段1沉淀的专题提示词示例

阶段 3 的复审怎么做

给每个结论标可信度。这是最值得抄的一点,它解决的是 AI 协作最大的风险:幻觉和真知混在一起。

复审的对照物是 app-build 技能的契约文件(字段类型、校验器、CLI 命令)。提示词和契约冲突时,以契约为准。

阶段3复审:给每个结论标可信度,与app-build技能契约对照

让这套方法跑起来的四条纪律

十一、照抄起步包

六步操作卡

建议的上手节奏

模板 1 · 需求澄清指令

/cosmic-requirements-spec 澄清一下需求,不要臆想,要实事求是地理清报表的查询逻辑。

需求的内容以文字说明为主,图片里的旧系统仅作参考。

模板 2 · 项目提示词骨架

下面是按这个项目提示词的结构整理的空骨架,内容要按你的项目逐步填。第一版不用写满,先把第 0 节和工作流写上。

# 报表开发提示词(项目名)  v0.1

## 0. 项目级交付约定(稳定编号,全文引用用 0.x)

0.1 交付方式:一次请求完成建模到验证,run 成功后自动衔接后续步骤,不需要用户再次提示

0.2 应用归属冲突裁决:需求点名应用与会话绑定应用不一致时,停下来问用户

0.3 项目硬约定:(例:报表取数优先 algo 框架,不用 QueryServiceHelper.query 做多行查询)

## 1. 证据分级说明

【实测】本项目 CLI 读回或插件运行验证

【实证】线上标准报表元数据读回 / 平台 jar 确认

【契约】来自 app-build 技能契约文件

【待复证】说法存疑,使用前必须实测

## 2. 开发前实证

- 数据源判定:queryForms --keyword <编号> 看 modelType 再选取数通道

- 字段存在性:getFormSchema 确认字段存在及位置(单据头 / 分录)

- key 读回:modifyMeta add 后一律 getFormSchema 读回实际 key

## 3. 完整工作流(一次交付自动序列)

1) 报表 Artifact 创建  2) 字段重建  3) 配置与插件适配  4) 菜单绑定与终验

## 4. 字段重建配方

## 5. 插件开发规范

## 6. 验证命令清单 / 交付前自查清单

## 7. 速查表(按需携带):字段类型总表、基础资料引用实体表

## 8. 专题配方(跨报表取数 / 运行态类型形态 / 数据权限 ……)

## 附:给灵基的执行指令模板

模板 3 · 执行指令(每张报表复制改名)

请按附件《报表开发提示词.md》执行,开发报表:<报表名>

需求规格见附件《<报表名>-需求规格.md》。

1. 交付方式:按「完整工作流」同轮完成。run 成功后自动衔接字段重建、配置与插件适配、菜单绑定、读回验证,不需要我再提示。

2. 元数据归属:写入应用 <应用名>。需求点名的应用与会话绑定应用不一致时,先停下来问我。

3. 插件实现:按提示词中的插件开发规范;字段和 key 一律以 getFormSchema 读回值为准,不要猜。

4. 类型红线:跨层传值前先确认消费端期望的形态,禁止按字段名相似推断。

5. 交付产物:交付卡片、每步读回验证结果、按 AC 逐条的验收报告;本次新踩的坑写进 workitems/<报表名>/report-dev-pitfalls.md。

模板 4 · 避坑记录(每张报表一份)

# <报表名> 避坑记录

| # | 现象 / 报错 | 根因 | 怎么修 | 可信度 | 是否进提示词 |

|---|-------------|------|--------|--------|--------------|

| 1 |             |      |        | 【实测】 | 是 / 否      |

模板 5 · 收工前检查

□ 新坑写进避坑文档了吗?

□ 能复用的配方精炼进提示词了吗?存疑的标【待复证】了吗?

□ 项目级约定写进项目记忆了吗?

□ 平台问题整理进问题清单了吗(带重现步骤)?

□ 验收报告按 AC 逐条记了 passed / failed / blocked 吗?

三个使用心法

十二、边界与注意

这套方法也有做不到、需要小心的地方:

最后一句

这个项目的优秀之处,不在灵基有多聪明,而在团队把三样东西做成了仓库里的资产:结构化的需求模板,带可信度标签、按版本迭代的提示词,以及一次请求跑完全链、按 AC 验收的流程。新报表的成本,从“一个开发几天”收敛到“一次澄清会话 + 一次请求 + 一次验收”。提示词每吸收一轮踩坑,下一次就更准。把这套方法沉淀下来,AI报表开发就能从个人发挥,变成谁都能照抄的工程能力。

告别传统ERP,迎接企业管理AI

构建实时感知、精准决策、高效运营的企业智能体

更多相关文章