让编码代理用图表写清技术文档

是什么 Markdown Graphs 将“何时用图、选哪种图、如何落地”写成供 Cursor、Claude Code、Codex、OpenCode 读取的 Agent Skill。它的价值不止是组件，而是把长篇技术说明转成更易扫描的图文表达。

核心设计 规则按场景选图：复盘用 GraphTimeline + GraphUptime，重构用 GraphFlow + GraphTimeline，PR 用 GraphDiff + GraphSlope，方案权衡用 GraphCompare + GraphRank。可导入 React/MDX 输出 JSX，README、GitHub、评论等纯 Markdown 输出官方 fenced ASCII twin；每节最多两图，图间保留文字，禁止自造 SVG、ASCII 或 API。

关键洞察 SKILL.md 与 recipes.md 把选择逻辑和用法分开，组件则通过 shadcn registry 安装，形成“提示—选型—交付”的代理工作流。截图里 Cursor 通过 /markdown-graphs 生成 postmortem，并安装 timeline/uptime，证明规则能落到真实写作任务。

边界与风险 它不替代数据核验或建模；图选错会放大误读，ASCII twin、registry 路径、Tailwind 兼容和动效仍需逐项目验证。