SuperAPI AI 工具集

roadmap-timeline

办公与效率

查看项目

更新于 10-16 15:12

技能介绍

Roadmap Timeline 是一个将项目数据转化为自包含 HTML 路线图或里程碑时间线的技能。

用途 该技能用于把项目数据可视化为一页完整的 HTML 时间线。它可以接收 SharePoint 列表、聊天中粘贴的 CSV 或表格,或用户的口头描述,最终输出一份无需外部依赖即可打开的 HTML 文件。

工作流程 技能分三步执行:首先确定数据来源,若用户已提供 SharePoint 列表则调用 list_items 读取所需列,若已粘贴表格则直接解析所有行,不重复索要已有数据;若仅有口头描述则进入采访环节。第二步为采访用户,在数据或意图不清晰时,以单条消息一次性提出以下问题:主题、日期范围、泳道或轨道、条目(含日期、负责人、状态)、配色、页脚文本,并在构建 JSON 前确认理解。第三步选择合适的渲染模式,构建并校验 JSON 文档,最后读取 assets/roadmap-timeline-template.html 渲染 HTML。

主要能力

  • 两种渲染模式:路线图模式适用于具有起止日期区间的条目,支持多条并行泳道;里程碑模式适用于单点事件。当数据混合时,采用路线图模式并将单点条目标记为 milestone: true。
  • 四种配色方案:warm-paper(奶油/赤陶)、deep-ink(深色/金色)、clean-white(白色/绿色)、slate(灰色/蓝色)。路线图默认 slate,里程碑列表默认 warm-paper。
  • 完整 JSON 架构:report 对象包含 title、subtitle、date_range_start、date_range_end、palette、footer;mode 为 "roadmap" 或 "milestones";roadmap 模式另有 swimlanes 数组,每条目含 id、title、swimlane_id、start、end、status、milestone、owner、description、dependencies。
  • 日期到百分比计算:所有布局位置以百分比预计算并以内联样式嵌入 HTML,无需 JavaScript 定位。计算涵盖总天数、条目左偏移百分比、条目宽度百分比和今日线位置,并规定了钳制到 0.00–100.00、保留两位小数、最小渲染宽度 1.50% 等规则。
  • 渲染说明:路线图模式生成月份标记尺,每个泳道一行,阶段块为带内联 left/width 的 .phase-block,里程碑为 .milestone-diamond,今日线为 .today-line;里程碑模式按阶段分组渲染 .milestone-card,包含日期徽章、状态点、标题、负责人和描述。

适用场景 适用于需要将项目计划、季度发布计划、云迁移阶段、新员工入职流程等以可视化时间线呈现的场景,尤其是需要生成独立 HTML 文件、且页面在禁用 JavaScript 时仍须完全正确的情况。

限制 输出 HTML 中不得包含任何外部 URL、CDN 链接或网络字体;不得使用 <script src> 标签,所有 JavaScript 必须内联;所有数据值必须预渲染进 HTML,JS 仅添加工具提示和动画,绝不能作为正确性的必要条件;不得生成 Python、PowerShell 或其他脚本,输出始终为 HTML 文件;在校验清单通过前不得渲染;owner 字段必须为纯文本,不支持 Person 列类型。该技能的具体收费、价格、平台及效果等事实暂未提供。