Atlas 项目发布演示与可视化叙事
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/atlas-present 到 AI 助手。
技能介绍
解决什么问题
技术团队交付重大功能后,非技术干系人很难从 CHANGELOG.md 或 git log 中快速理解价值。工程师习惯写实现细节,而业务方需要知道「解决什么问题」「带来什么结果」。人工整理演示文稿耗时且容易遗漏关键指标。
核心能力与工作流程
- 信息提取:从用户描述、
.changelog/CHANGELOG.md、git log 或 PR 中自动识别发布标题、时间范围、涉及仓库和默认受众(非技术干系人)。 - 叙事构建:按 8 个固定模块组织内容——Hero、问题背景、功能卡片、简化架构、前后对比、影响数据、后续计划和团队致谢。写作规则强制使用结果导向语言("You can now X"),用具体数字替代形容词。
- 可视化输出:生成单文件 HTML 演示页,使用
scroll-snap-type: y mandatory实现分节吸附,内嵌 Mermaid 图表,支持离线浏览。同时生成配套的 JSON Canvas 文件,以节点和边的形式展示组件关系。 - 本地保存:按
.presentations/{YYYY-MM-DD}-{kebab-title}/目录规范保存,自动调用浏览器打开。
适用边界与注意点
- 仅支持手动触发,避免在常规对话中意外生成演示文稿。
- 没有前后对比数据时会自动省略 Before/After 部分,不会编造指标。
- HTML 依赖 Mermaid CDN,完全离线环境需预先加载图表库。
- CLI 输出限制在 40 行以内,完整报告写入 HTML 文件,终端仅显示摘要和文件路径。
使用场景
- 技术负责人需要把版本更新的人类可读总结汇报给产品团队,而不是直接扔 git log 链接
- 技术团队完成季度史诗功能后,要把多个仓库的改动整理成一份可分享的单页 HTML 给业务方查看
- 产品经理要为重大功能上线准备一份图文并茂的发布说明,附带 Mermaid 架构图和前后对比指标
- 用 Obsidian 管理项目知识库的工程师,需要把功能依赖关系导出为 Canvas 节点图并归档到仓库
适合人员
- 技术团队负责人,需要定期把一个或多个仓库的迭代成果转译成业务方可读的发布摘要
- 产品经理,负责将复杂功能上线整理成图文演示,向市场和运营团队说明新能力和预期收益
- 技术文档工程师,需要为版本发布编写架构图与指标面板,减少人工收集 git log 和 changelog 的时间
- 使用 Obsidian 做知识管理的独立开发者,希望把功能模块关系沉淀为可视化 Canvas 并随代码库一起版本控制