Files
marqdo/lib/lint/narrative.mq.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

1.3 KiB
Executable File

markup, title, description
markup title description
occlusion lib/lint/narrative Narration-ratio skill (≥50%). Canonical checker: marqdo check --narrative-ratio.

Narration ratio skill. Every authored function unit should mix narration with code so narration is more than half the text. This is the first skill-as-tools example called out in the author vision notes: the page is documentation, and its headings are tools. The canonical path checker lives in the host as marqdo check --narrative-ratio so directory dogfood does not need filesystem effects inside a pure call.

For AI agents: run marqdo check --narrative-ratio on edited library files. This is a readability signal; parsing, contracts, executable examples and real behavior tests provide correctness evidence. Headings name actual tools only.

remind

返回 类型 说明
result any rule reminder map

Return a small map stating the narration threshold and the CLI to run. Takes no parameters. Use this when an agent needs a tool-shaped reminder without opening design docs. The threshold is one half. Contract tables count as narration; call lines and bold statements count as code.

out =

threshold cli tables
0.5 marqdo check --narrative-ratio FILE narration

Return out.