AGENT SKILL

gantt-chart-builder

根据任务列表和依赖关系生成交互式HTML甘特图,支持关键路径分析(CPM),可视化项目时间线、依赖关系和可延迟的浮动时间。当用户提到甘特图、项目时间线、关键路径、任务排期、项目进度图、依赖关系可视化、工期计算或直接说“帮我排一下项目时间”、“生成一个项目进度图”、“分析一下哪些任务是关键路径”时触发。

License 许可
MIT
所属仓库
tabtin-ai/TabTin
最近更新
2026-10-08
Stars
★ 454
Forks
115

01 前言 Front Matter

name
gantt-chart-builder
license
MIT
metadata
{ "tabtin": { "category": "collab", "displayName": "甘特图与关键路径" }, "version": "0.1.0" }
description
根据任务列表和依赖关系生成交互式HTML甘特图,支持关键路径分析(CPM),可视化项目时间线、依赖关系和可延迟的浮动时间。当用户提到甘特图、项目时间线、关键路径、任务排期、项目进度图、依赖关系可视化、工期计算或直接说“帮我排一下项目时间”、“生成一个项目进度图”、“分析一下哪些任务是关键路径”时触发。

02 资源文件 1

03 SKILL.md 正文

project-timeline -- 交互式甘特图与关键路径分析

根据任务列表及其依赖关系,自动执行关键路径分析(CPM),生成可交互的 HTML 甘特图。支持缩放、关键路径筛选、悬停详情、依赖关系箭头可视化等功能。

Quick Start

最简用法——直接传入 JSON:

python3 scripts/gantt_generator.py --json '{
  "project": "新产品上线",
  "tasks": [
    {"id": "T1", "name": "需求分析", "duration": 5, "dependencies": []},
    {"id": "T2", "name": "UI 设计", "duration": 4, "dependencies": ["T1"]},
    {"id": "T3", "name": "后端开发", "duration": 8, "dependencies": ["T1"]},
    {"id": "T4", "name": "前端开发", "duration": 6, "dependencies": ["T2"]},
    {"id": "T5", "name": "联调测试", "duration": 3, "dependencies": ["T3", "T4"]},
    {"id": "T6", "name": "上线部署", "duration": 2, "dependencies": ["T5"]}
  ]
}' --output gantt.html

从文件读取并指定开始日期:

python3 scripts/gantt_generator.py --file tasks.json --start-date 2026-05-01 --output gantt.html

方法论:关键路径法(CPM)

核心概念

术语 英文 含义
最早开始 ES (Earliest Start) 任务最早可以开始的时间
最早完成 EF (Earliest Finish) 任务最早可以完成的时间(ES + 工期)
最晚开始 LS (Latest Start) 不影响项目总工期的最晚开始时间
最晚完成 LF (Latest Finish) 不影响项目总工期的最晚完成时间
总浮动 Total Float LS - ES,可延迟天数
关键路径 Critical Path 浮动时间为 0 的任务序列,决定项目最短工期

计算步骤

  1. 拓扑排序:按依赖关系对任务排序,同时检测循环依赖
  2. 前推法(Forward Pass):从起始任务开始,计算每个任务的 ES 和 EF
    • ES = max(所有前置任务的 EF)
    • EF = ES + 工期
  3. 后推法(Backward Pass):从最终任务反推,计算 LS 和 LF
    • LF = min(所有后续任务的 LS)
    • LS = LF - 工期
  4. 识别关键路径:浮动时间(LS - ES)为 0 的任务构成关键路径

输入格式

JSON 对象,包含以下字段:

{
  "project": "项目名称",
  "start_date": "2026-05-01",
  "tasks": [
    {
      "id": "T1",
      "name": "任务名称",
      "duration": 5,
      "dependencies": ["T0"]
    }
  ]
}
字段 必填 类型 说明
project 否 string 项目标题,默认"项目甘特图"
start_date 否 string YYYY-MM-DD 格式,可被 CLI --start-date 覆盖
tasks 是 array 任务列表
tasks[].id 是 string 任务唯一标识
tasks[].name 是 string 任务名称
tasks[].duration 是 number 工期(天),必须 > 0
tasks[].dependencies 否 array 前置任务 ID 列表,默认 []

输出功能

生成的 HTML 文件是完全自包含的(无外部依赖),包含以下交互功能:

  • 甘特图可视化:任务条形图,横轴为时间,纵轴为任务
  • 关键路径高亮:红色标记关键任务,蓝色标记非关键任务
  • 依赖关系箭头:SVG 绘制的依赖连线,关键依赖用红色加粗
  • 浮动时间显示:橙色半透明区域展示任务可延迟空间
  • 悬停详情:鼠标悬停显示完整的 CPM 分析数据
  • 任务高亮:点击任务可高亮其直接依赖和后续任务
  • 缩放控制:滑块调整时间轴精度
  • 关键路径筛选:一键切换仅显示关键路径任务
  • 今日标线:绿色竖线标记当前日期
  • JSON 导出:导出带 CPM 标注的完整数据

脚本参数

python3 scripts/gantt_generator.py [参数]

必填参数(二选一):
  --json TEXT          JSON 格式任务数据字符串
  --file PATH          JSON 文件路径

可选参数:
  --start-date DATE    项目开始日期 (YYYY-MM-DD),默认今天
  --output, -o PATH    输出 HTML 路径,默认输出到 stdout
  --title TEXT         覆盖项目标题

完整示例

场景:软件开发项目排期

{
  "project": "CRM系统 v2.0 开发",
  "start_date": "2026-05-05",
  "tasks": [
    {"id": "A", "name": "需求调研", "duration": 5, "dependencies": []},
    {"id": "B", "name": "架构设计", "duration": 3, "dependencies": ["A"]},
    {"id": "C", "name": "UI/UX 设计", "duration": 4, "dependencies": ["A"]},
    {"id": "D", "name": "数据库设计", "duration": 2, "dependencies": ["B"]},
    {"id": "E", "name": "后端 API 开发", "duration": 10, "dependencies": ["D"]},
    {"id": "F", "name": "前端页面开发", "duration": 8, "dependencies": ["C", "D"]},
    {"id": "G", "name": "单元测试", "duration": 3, "dependencies": ["E"]},
    {"id": "H", "name": "集成测试", "duration": 4, "dependencies": ["F", "G"]},
    {"id": "I", "name": "用户验收", "duration": 3, "dependencies": ["H"]},
    {"id": "J", "name": "部署上线", "duration": 2, "dependencies": ["I"]}
  ]
}

分析结果:

  • 总工期:32 天
  • 关键路径:A → B → D → E → G → H → I → J
  • UI/UX 设计(C)有浮动时间,可适当延后而不影响总工期

注意事项

  • 输入中不能存在循环依赖(A 依赖 B,B 又依赖 A),脚本会检测并报错
  • 工期单位为"天",不区分工作日和节假日
  • 所有任务 ID 必须唯一
  • 生成的 HTML 无需网络连接即可打开使用

04 同仓库更多 Skills

tabtin-ai
tabtin-ai/TabTin

tabtracker

管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-project

在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

skill-market

管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-widget

渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。

★ 454
tabtin-ai
tabtin-ai/TabTin

resource-link

插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。

★ 454
tabtin-ai
tabtin-ai/TabTin

mcp-operations

操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。

★ 454