在线交付跟进助手（通用模板）
把在线表格里的交付进度，一键变成看板报告：各项目完成率、逾期项、阻塞项，各负责人工作量。
> ⚠️ 本技能是通用模板，不含任何预置数据。 不绑定任何平台、不读取任何账号、不写死任何表格地址 / 项目名 / 成员名。你接入的是自己的在线表格导出文件，示例数据全部为虚构。
适用场景
- 团队把交付/任务进度记在在线表格（任何支持「导出 CSV」的在线表格都行），每次周会要手工统计进度
- 想快速知道：哪些项目完成率低、哪些已经逾期、谁在扛大部分任务
- 想产出一份可贴进文档 / 群聊的 Markdown 看板，而不想装一套重型项目管理 SaaS
工作流（4 步）
- 导出 CSV：在你的在线表格里点「导出 / 下载为 CSV」，得到一份本地文件，或复制它的「公开 CSV 导出链接」。
- 确认列名：看一眼表头，记下你用哪一列表示项目、负责人、状态、截止日（列名可以是中文、英文、任意写法）。
- 跑分析：用
scripts/delivery_report.py传入 CSV 与列名映射，得到 Markdown 看板。 - 核对使用：把报告贴进周报 / 群聊，或据此开会。脚本只读取、不修改你的任何表格。
想先看效果、手上暂时没数据？直接 --demo 看一份虚构样本的完整输出。
一键分析
# 用内置虚构样本演示（不读取任何外部数据）
python3 scripts/delivery_report.py --demo
# 分析你自己的本地 CSV
python3 scripts/delivery_report.py --csv 你的表.csv \
--project 项目 --owner 负责人 --status 状态 --due 截止日
# 分析在线表格的公开 CSV 导出链接
python3 scripts/delivery_report.py --csv "https://你的表格导出链接.csv" \
--project Project --owner Owner --status Status --due Due
# 列名映射写进 JSON 文件，避免每次敲命令行
python3 scripts/delivery_report.py --csv 你的表.csv --map columns.json
columns.json 长这样（键固定，值是你自己的列名）：
{"project":"项目","owner":"负责人","status":"状态","due":"截止日","name":"任务名"}
状态归一化（认这些写法）
脚本会把各种写法映射到标准状态，你不用改表里的字：
- 完成：完成 / 已完成 / done / closed / 已交付 / 已上线
- 进行中：进行中 / doing / in_progress / 开发中 / 处理中
- 未开始：未开始 / 待开始 / todo / backlog / 排队中 / 计划中
- 阻塞：阻塞 / blocked / 卡住 / 暂停 / 受阻
截止日支持 2026-10-01、2026/10/01、01/10/2026、2026-10-01 18:00:00 等格式；逾期未完成的任务（截止日早于今天且状态非「完成」）会单独标红计数。
输出示例（来自 --demo 虚构样本）
# 交付跟进看板（生成于 2026-10-21）
> 数据源：内置虚构演示样本
## 各项目
| 项目 | 任务数 | 完成 | 完成率 | 阻塞 | 逾期 |
|---|---|---|---|---|---|
| 示例项目Alpha | 3 | 1 | 33% | 1 | 0 |
| 示例项目Beta | 2 | 1 | 50% | 0 | 0 |
| 示例项目Gamma | 2 | 1 | 50% | 0 | 1 |
...
边界与免责
- 本技能不访问任何账号、不调用任何平台 API、不写入任何表格，只读取你明确提供的 CSV 文件或公开导出链接。
- 仅支持「公开可访问的 CSV 导出链接」；需要登录才能看的私有表格请先导出为本地文件再分析。
- 完成率、逾期等计算以表格中的状态列 / 截止日列为准，数据质量取决于你导出的表格本身。
> 列名映射模板与「如何从不同在线表格导出 CSV」的通用步骤，见 references/。
