SuperAPI AI 工具集

plannotator-visual-explainer

编程与开发

查看项目

更新于 10-15 17:23

技能介绍

用途:根据内容类型生成自包含 HTML 可视化,并使用 Plannotator 主题。资料给出三条路径:实现计划、设计文档或提案走 Plan 路径;PR 讲解、diff 审查或代码变更走读走 PR 路径;架构图、数据表、幻灯、项目回顾等走通用 Visual explainer 路径,该路径委托给 nicobailon/visual-explainer 并替换为 Plannotator 主题令牌。\n\n主要能力与结构:Plan 路径先读 references/design-system.md 与 references/svg-patterns.md,文档可含头部、摘要统计条、无时间估算的里程碑时间线、内联 SVG 架构/数据流图、HTML/CSS 原型、关键代码块、风险与缓解表、待决问题卡,并按任务调整重点。PR 路径先读 design-system.md 与 pr-components.md,可含头部元信息、TL;DR、动机与前后对比、可折叠文件导览、风险图、重点定位卡、测试计划、发布计划;内联 diff 使用 CDN 上的 Pierre diffs。通用路径需确保 visual-explainer 已安装(可检查 ~/.claude/skills/visual-explainer/SKILL.md 或 ~/.agents/skills/visual-explainer/SKILL.md,缺失时运行 npx skills add nicobailon/visual-explainer -g --yes),再读其 SKILL.md、相关参考与 references/theme-override.md;带缩放 Mermaid 图需读 references/diagram-shell.md,勿手写相关标记。\n\n交付与限制:始终通过 Plannotator 注释 UI 交付,不要用 open 或 xdg-open。使用 Mermaid 的交付物须在明暗两套调色板下用 Mermaid 12 渲染每张图;出现异常、空 SVG、aria-roledescription="error" 或语法错误即视为不可交付,需修复后重渲染。计划/提案使用 plannotator annotate <file> --gate,其他信息性内容使用 plannotator annotate <file>。设计理念包括大量留白、一屏一观点、以展示代替描述、不附时间估算。其他细节资料未提供。