SuperAPI AI 工具集

visual-plan

办公与效率

查看项目

更新于 10-15 20:08

技能介绍

用途:把非平凡工作的计划(功能、设计、重构、迁移、产品发布、研究议程、事故响应等)渲染为可视化 MDX 页面,替代大段文字,让读者通过扫描图表、阶段和表格理解方案。

主要能力:使用 vplan CLI 编写 .mdx 计划文件,以单个 # 标题开头,无需 frontmatter 和 import。组件包括 Phase(编号时间线)、mermaid 图(架构、时序、依赖、状态、类、ER、xychart-beta)、Svg(内联本地 .svg)、math(LaTeX 公式)、Callout(note/tip/risk/decision/warn)、FileTree(文件变更映射)、Chart(bar/line/area/scatter/radar/gauge/funnel/treemap/pie)、Compare(优缺点对比)、Matrix(评分网格)、Questions(开放问题,可选项)、Checklist(验收标准)、Stat(关键指标卡片)。代码块支持语法高亮与行标记(mark/ins/del)。

使用方式:若未安装,先执行 npm i -g vplan@latest。写好后用 vplan check <file>.mdx 校验并修复所有 file:line:col 问题;再用 vplan <file>.mdx 呈现。评审是默认交付方式,打开反馈层,用户可评论、回答 Questions、点击 Approve/Deny/Iterate,退出码分别为 0/1/2/3(超时 3,--timeout 默认 4h,需带单位如 30s、45m、4h)。它是长时前台服务器,应后台运行。Iterate 时原地修改同一 .mdx 并重跑,会自动标记变更并递增轮次;可用 --diff 或 --no-diff 控制。静态页面、实时预览或 PDF/JPG 导出见 references/static-exports.md。

适用场景:任何需要清晰呈现结构、权衡、风险与验收标准的计划评审。

限制:不要对用户可见计划使用 --no-open;不支持图片或外部资源,check 会拒绝 markdown 图片;原始内联 HTML 标签会失败;<、{、} 在正文中需用反引号包裹;Chart 不显示精确数值标签,Matrix 单元格不换行;gantt 和 pie 图不受支持。