gantt-chart-builder

Files (3)

• LICENSE
• SKILL.md
• gantt_generator.py · scripts/

SKILL.md (first lines)

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

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

## Quick Start

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

```bash
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
```

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

```bash
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 对象，包含以下字段：

```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         覆盖项目标题
```

## 完整示例

### 场景：软件开发项目排期

```json
{
  "project": "CRM系统 v2.0 开发",
  "start_date": "2026-05-05",

From haomingz/kimi-skills, MIT.

More from haomingz/kimi-skills