SuperAPI AI 工具集

feelc-rules

编程与开发

查看项目

更新于 10-21 16:54

技能介绍

用途

feelc-rules 技能帮助用户使用 feelc 语言编写、验证和测试业务规则。feelc 采用 DMN 范式:一个由相互关联的决策组成的图,每个决策是一个决策表或一个表达式,全部使用 FEEL 语言。feelc 将源代码编译为确定性引擎,在运行时不需要 LLM,决策可复现且可审计。用户的角色是编写 DSL;feelc 二进制是确定性的判定器(编译 + 验证 + 评估)。绝不能凭头脑决定规则结果,始终运行 feelc。

何时使用

  • 用户希望将业务策略(资格、评分、定价、规模、折扣、权利/福利等)编码为可执行规则。
  • 用户希望获得经过验证的决策表(无缺口、无冲突),且可重放。
  • 用户提到 DMN、FEEL、规则引擎或 feelc。

前提条件:feelc 二进制

所有命令都通过便携包装脚本 scripts/feelc-skill.mjs 执行,该脚本会定位 feelc(通过 FEELC_BIN 变量、PATH、同级检出或通过 go build 构建)。首先检查:

node scripts/feelc-skill.mjs version

如果失败,包装脚本会打印如何提供 feelc(参见 references/install.md)。如果 feelc 在 PATH 上,也可以直接调用。

流程(红到绿,由判定器驱动)

为每个步骤创建一个待办事项,并按顺序执行。

  1. 访谈(不要猜测):确定输入(Input Data)及其域(in [a..b]、>= 0、in {…})、决策及其依赖关系、每个表的命中策略、边缘情况。参见 references/authoring.md。

  2. 编写 .rules 文件:严格保持在支持的子集内(references/feel.md)——任何超出范围的构造都会导致编译失败,这是有意为之。使用 references/examples.md 中的 4 个模板作为起点。

  3. 编译 + 验证(确定性门禁):

node scripts/feelc-skill.mjs verify --rules model.rules --json

编译错误(类型、引用、语法)→ 使用 --json 时,它们会以结构化对象 {file,line,col,code,message,suggestion} 输出到 stdout:使用 line/col 定位,使用 suggestion 修复,然后重新运行。稳定的代码目录:references/error-schema.md。

验证阻塞项(严重性为 "error":完整性缺口及反例、UNIQUE/ANY 冲突)→ 修复。阅读 references/verify.md。

  1. 在具体案例上测试(包括访谈中的边缘情况):
node scripts/feelc-skill.mjs run --rules model.rules --decision <name> --input '{…}' --json

与预期结果比较。迭代直到匹配。

  1. (可选)语义第二层门禁:验证规则是否真正表达了需求所要求的内容。将规格/需求分解为原子声明 {decision, input, expect}(这是你的 AI 工作),写入 claims.json({"claims":[…]} ),然后让 VM 决定:
node scripts/feelc-skill.mjs check --rules model.rules --claims claims.json --json

supported = 规则确认了声明;contradicted/error = 阻塞(规则没有做到需求所说的,或者你的声明是错误的 → 修复其中一个)。"LLM 提议,VM 决定":绝不要为了通过声明而发明阈值。

迭代直到满足停止标准。

停止标准:"零阻塞,非零发现"

  • 可构建 = verify 不返回阻塞项(严重性为 "error")。警告(shadowed rule…)和信息(useless default…)发现应报告,但不一定修复。
  • 收敛 = run 复现了与用户验证过的参考/边缘案例。

绝不要为了"让它通过"而发明阈值或值:如果需求中的歧义不可消除,请向用户提出问题。

不要做什么

  • ❌ 不要自己计算规则结果——运行 feelc run。
  • ❌ 不要使用子集之外的构造(多参数 FEEL 函数、for/some/every、列表/高阶函数、正则表达式、时间/日期时间/时区、lambda):它不会编译。(if c then a else b、date/duration、单参数 floor/ceiling/round、单位、括号、适用性和 BKM 是支持的——参见 references/feel.md。)
  • ❌ 不要在没有假定默认值的情况下让单命中表(FIRST/UNIQUE/ANY/PRIORITY)不完整:verify 会报告缺口及反例。
  • ❌ 不要把警告/信息伪装成成功,也不要仅仅为了消除诊断而删除规则而不理解原因。

参考资料(渐进式披露)

  • references/authoring.md — 访谈和模型结构。
  • references/feel.md — 支持的 DSL/FEEL 子集(以及不支持的)。
  • references/verify.md — 阅读 feelc verify,阻塞项与备注。
  • references/examples.md — 4 个参考模型作为模板。
  • references/forbidden-patterns.md — 经典陷阱(重叠、缺少默认值…)。
  • references/install.md — 提供 feelc 二进制。
  • references/error-schema.md — 结构化编译错误和稳定代码。