用途:把 markdown 实施计划转成可视化 HTML 文档,让未看过代码的读者在五分钟内了解改了什么、数据如何流动、各部分归属、已定决策与未决问题。markdown 计划保持不变,仍是唯一事实来源,HTML 只是额外视图。
主要能力:在计划文件同目录生成 <stem>.html(Artifact 片段,用于发布)和 <stem>.standalone.html(可本地打开的完整页面,图表与字体从网络加载)。按计划内容选择章节,可包含流程图、示例、交接、时序图、步骤与分支表、状态图、选项卡片、问题→答案表、schema 卡片与 ER 图、tiles、端点卡片、模式表、工作/受影响代码/回滚表、已接受缺口、已定与未决决策。
使用方式:读取整个计划,页面事实只能来自计划或其引用的代码,缺失内容留空,不编造数字、名称或行为。从 <skill-dir>/assets/base.html 复制并填充占位符,按需读取 <skill-dir>/references/components.md 与 diagrams.md。用 python3 <skill-dir>/scripts/check_plan_page.py <stem>.html 检查直到退出码为 0。若有 Artifact 工具则先加载 artifact-design 再发布;随后运行 python3 <skill-dir>/scripts/build_standalone.py <stem>.html 生成本地副本。
限制:计划变更时需同步编辑 markdown、HTML、已发布链接和本地副本,并清除已删除名称;无 Artifact 工具时跳过发布,本地副本即交付物。资料未提供收费、价格、平台支持等细节。