Files
marqdo/examples/executable-knowledge/README.md
T
cflmyandCursor dcd3d329d4 feat: land S1–S6 executable-knowledge slices (NarrativeRef through CI)
Add comment-line NarrativeRef steps, generation CURRENT snapshots, frontmatter
sources/applicability, digest-guarded artifact.patch, lock change classes, and
an offline CI gate so the documented S0–S6 path has reviewable evidence.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 23:24:18 +08:00

2.2 KiB
Raw Blame History

可执行知识系统示例:订单含税总额

这是 可执行知识系统设计 的目标示例。 它刻意展示 []() 不只包“知识函数”:同一套语法同时命名取元、循环、推导、跨文件调用和正文结论。

文件 图中的职责 关键步骤
corpus/tax-policy-2026.md E:证据 税率原文
schema/order.mq.md C:概念 订单/订单行字段与单位
knowledge/tax-2026.mq.md K:原子知识 [标准税率](0.13) 及来源
capabilities/order-pricing.mq.md D:推导知识 取元、调用、循环、汇总
docs/invoice-answer.mq.md N:叙述知识 用同一个计算给人可读的回答

读法

[]() 的每一次出现都是 Named<T>:

[订单行金额](at(行, "金额"))                 # observe
[本行含税价](订单行金额 * (1 + 税率))          # derive
[逐个订单行](遍历 订单.行 为 行)               # iterate
[含税总价](pricing.订单定价.含税总额(订单))     # reuse / narrate

它们不是四种语法。() 中仍是原有的取元、算术、循环和调用;[] 让每一步同时可读、可查、 可在图中定位。

运行状态(勿与设计态混淆)

子集 状态 证据
纯计算 / BoundCall / 步骤 kind / NarrativeRef 门禁已覆盖 tests/executable_knowledge/
本目录完整订单链(类函数、证据闭环、impact→原文) 设计态 仍作目标示例,不计入发布成功
knowledge/tax-2026.mq.md 的 sources: 编译可关联 corpus;business bind 需 evidence=sourced 见 baseline/12-tax-source

预期闭环

  1. check 从每个 []() 提取观测、推导、遍历和调用依赖;
  2. view 在“含税总额”旁显示所经过的订单行、标准税率和税率原文;
  3. 税率原文变更时,impact 找到原子税率、订单定价、发票回答中的每一个命名步骤;
  4. verify 只重算 pure 步骤,不执行写入或发送等 act 步骤;
  5. agent 通过 catalog 得到“已有订单定价能力”和其证据链,不必从自然语言猜测。