Files
marqdo/doc/design/ai-skill.md
T
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.5 KiB
Executable File
Raw Blame History

Marqdo AI Skill

状态 已提供
日期 2026-08-05(初版)· 2026-08-28(ext/web 完结复核 · ext/quantum Q8)
路径 skills/marqdo/(权威);Cursor 镜像 .cursor/skills/marqdo/

目的

让接入方(Cursor Agent、其它支持 Agent Skills 的模型宿主)在加载本 skill 后即可按 v0.2 语法正确编写 / 修改 .mq.md,并在使用 ext/web 动态站 或 ext/quantum 电路/可视化 时遵循官方作者面(不混中英 API、不写 JSON 袋胶水;量子绘图须引用 kind=/theme= 字符串)。

内容

文件 用途
SKILL.md 必读:硬规则、标记表、ext/web、ext/quantum(Q7/Q8)、工作流、反模式
reference.md 按需:CLI、stdlib/ext 索引、web/quantum API 摘要
examples.md 按需:可复制样例(§13 最小站点 · §14 纠缠实验)

使用

  • 本仓库 Cursor:项目 skill 已在 .cursor/skills/marqdo/;描述含 .mq.md / Marqdo 触发词,可自动选用。
  • 其它 AI:将 skills/marqdo/ 整目录作为 skill 包导入,或把 SKILL.md 贴进系统/项目说明并允许模型按需打开 reference.md / examples.md。
  • 校验:生成后执行 marqdo run <file>.mq.md,按 path:line:col 诊断迭代。

语法真相仍以 markdown-mapping.md 与 keywords.md 为准;skill 是面向模型的压缩操作手册。