菜单
飞书版工作任务跟踪报告生成器。从飞书多维表格读取数据，自动生成6类管理报告，默认输出到飞书消息，可选导出为DOCX公文。适用于定期汇报、绩效分析、风险预警等场景。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | project-tracker-feishu |
| description | 飞书版工作任务跟踪报告生成器。从飞书多维表格读取数据，自动生成6类管理报告，默认输出到飞书消息，可选导出为DOCX公文。适用于定期汇报、绩效分析、风险预警等场景。 |
| version | 1.0.0 |
| icon | 📊 |
| metadata | {"clawdbot":{"emoji":"📊","requires":{"bins":["python3"],"env":["MINIMAX_API_KEY","FEISHU_APP_ID","FEISHU_APP_SECRET"],"pip":["requests","python-docx"]},"primaryEnv":"MINIMAX_API_KEY"}} |
从飞书多维表格自动生成6类管理报告，发送到飞书群聊或导出为DOCX
本 Skill 是 project-tracker 的飞书适配版本。与 Excel 版的区别：
feishu-toolkit Skill 使用| 报告类型 | 适用场景 | 数据范围 |
|---|---|---|
| 周进度简报 | 每周例会 | 最近2周 |
| 月度管理报告 | 月度总结 | 最近4周 |
| 项目节点报告 | 节点检查 | 最近4周 |
| 团队绩效分析 | 绩效评估 | 最近4周 |
| 风险预警专报 | 风险提示 | 最近4周 |
| 季度汇报材料 | 领导汇报 | 最近6周 |
feishu-toolkit 已部署并运行（默认 http://127.0.0.1:8002）表1：工作任务跟踪表 字段包含：板块、任务分类、具体任务、重要程度、牵头/配合、负责团队、序号、各周进展（上周进展/本周计划/存在问题）
表2：工作任务清单 字段包含：模块、频率、工作任务、里程碑节点计划
app_token（从多维表格 URL 提取：https://xxx.feishu.cn/base/{app_token}）# 读取数据并输出摘要
python3 scripts/parse_bitable.py --app-token <APP_TOKEN>
# 含任务清单（里程碑数据）
python3 scripts/parse_bitable.py --app-token <APP_TOKEN> --tasklist
# 按团队过滤
python3 scripts/parse_bitable.py --app-token <APP_TOKEN> --team 英大长安
# JSON 格式输出
python3 scripts/parse_bitable.py --app-token <APP_TOKEN> --format json
数据表会自动检测——脚本根据字段名关键词（板块、任务分类、具体任务等）识别工作跟踪表和任务清单表。也可手动指定 --tracker-table 和 --tasklist-table。
# 全部6类报告 → 发送到飞书群聊
python3 scripts/batch_generate_feishu.py --app-token <APP_TOKEN> --chat-id <CHAT_ID>
# 全部6类 → 发送到个人
python3 scripts/batch_generate_feishu.py --app-token <APP_TOKEN> --user-id <USER_OPEN_ID>
# 使用卡片格式（更精美）
python3 scripts/batch_generate_feishu.py --app-token <APP_TOKEN> --chat-id <CHAT_ID> --feishu-format card
# 仅生成指定报告
python3 scripts/batch_generate_feishu.py --app-token <APP_TOKEN> --chat-id <CHAT_ID> --reports weekly risk
# 全部6类 → 导出到桌面
python3 scripts/batch_generate_feishu.py --app-token <APP_TOKEN> --docx --output-dir ~/Desktop
# 将已有的 Markdown 报告发送到飞书
python3 scripts/send_feishu.py --input report.md --chat-id <CHAT_ID>
python3 scripts/send_feishu.py --input report.md --chat-id <CHAT_ID> --format card
| 变量 | 必填 | 说明 |
|---|---|---|
MINIMAX_API_KEY | ✅ | MiniMax API 密钥 |
FEISHU_APP_ID | ✅ | 飞书应用 App ID |
FEISHU_APP_SECRET | ✅ | 飞书应用 App Secret |
FEISHU_TOOLKIT_URL | 否 | feishu-toolkit 地址（默认 http://127.0.0.1:8002） |
MINIMAX_BASE_URL | 否 | MiniMax API 地址（默认 https://api.minimaxi.com/v1） |
project-tracker-feishu/
├── SKILL.md # 本文件
├── scripts/
│ ├── parse_bitable.py # 飞书多维表格数据解析
│ ├── send_feishu.py # 飞书消息发送
│ ├── batch_generate_feishu.py # 批量报告生成（主入口）
│ ├── generate_docx.py # DOCX 生成（复用）
│ └── test_e2e.py # （原版遗留，飞书版不使用）
├── references/
│ ├── analysis-rules.md # 分析规则
│ └── report-templates.md # 报告模板
| 对比项 | project-tracker | project-tracker-feishu |
|---|---|---|
| 数据源 | Excel 文件 (.xlsx) | 飞书多维表格 (Bitable) |
| 数据读取 | openpyxl 本地解析 | HTTP API 远程调用 |
| 默认输出 | 终端 + DOCX | 飞书消息（富文本/卡片） |
| DOCX支持 | ✅（默认） | ✅（可选 --docx） |
| 依赖 | openpyxl, python-docx | requests, python-docx, feishu-toolkit |
| 部署要求 | 仅需 Python | 需 feishu-toolkit 服务运行 |
所有报告遵循以下规范：
将复杂写作任务委托给 OpenCode（文件解析/数据建模/图表/格式转换）。当用户需要读取 Excel/CSV/PDF/Word 并输出报告（Markdown/Docx）时使用。关键词：报告、调研、方案、数据分析、建模、图表、Word、PDF、Excel。
飞书附件发送固定流程（docx/pdf/xlsx）。当用户要求“把文件作为附件发到飞书聊天”时必须触发本 skill，并严格走 feishu_media，不得改用 message(filePath) 或 feishu_doc.upload_file。
风控/稽核周报写作（风险矩阵、异常趋势、整改跟踪、下周计划）。支持从表格/纪要/工单导出生成周报与附件。
竞品分析/竞争情报报告写作（竞品画像、SWOT、差距分析、策略建议与路线图）。需要数据/文件/长文输出时委托 OpenCode。
内审报告写作（范围/方法/发现/证据/整改建议/管理层回复）。从稽核底稿、访谈纪要、日志导出生成正式报告。
投标/方案书写作（需求响应、技术方案、实施计划、交付与验收、报价说明、风险与承诺）。需要从 RFP/附件生成完整文档时委托 OpenCode。