用途:把 docs/ 下已有的项目文档转换为交互式、自包含的 HTML 演示文稿,包含 6 个标签页(概览、需求、架构/C4、技术规格、路线图、指南),支持 Mermaid 图表,并生成可独立分享的单文件页面。
主要能力:单源不重复(每类信息只出现在一个标签页);6 标签导航,含 SCOPE 标签、localStorage 状态保持与平滑过渡;FR 表格布局(禁用非功能需求);路线图以纵向 Epic 列表呈现,含范围、状态徽章与依赖/成功标准;ADR 按 Strategic/Technical 分组并以内联手风琴展示;Mermaid 图在切换标签时重渲染;响应式设计与可折叠区块,声明符合 WCAG 2.1 AA。
必要输入:docs/project/requirements.md、architecture.md、tech_stack.md 为必需;api_spec.md、database_schema.md、design_guidelines.md、infrastructure.md、runbook.md、docs/reference/adrs/.md、docs/reference/guides/.md、docs/tasks/kanban_board.md 为可选。以 7 阶段流程执行:读取文档、校验来源存在、校验内容质量、创建目录、复制模板、注入内容、构建 HTML。构建命令:cd docs/presentation/assets/ && node build-presentation.js,输出 docs/presentation/presentation_final.html。
适用场景:由 ln-100-documents-pipeline 编排调用,或独立使用;在文档更新后重建演示,也可单独生成用于分享的演示。
限制:缺少必需文件时会报错并停止;可选文件缺失仅警告并减少标签内容;质量校验为只读,不自动修复;presentation_final.html 为生成文件,不应直接编辑,应修改 assets/ 后重建;演示内容为英文。价格、平台与效果等资料未提供。