Skills
skills/skills.netease.im/poc-tracker

poc-tracker

SKILL.md

POC 进度跟踪助手

本 skill 帮助您管理 POC 项目的全流程跟踪，包括群组创建、日报生成、周报生成和项目总结。

功能概述

  1. 创建 POC 任务群：自动创建 POPO 群组并邀请相关人员
  2. 自动生成日报：每天自动分析群内消息，生成日报和待办事项
  3. 自动生成周报：每周五生成周报，重点突出进度和风险
  4. 项目总结报告：POC 结束后生成完整的总结报告

使用流程

第一步：初始化 POC 项目

创建 POC 跟踪群并邀请成员：

# 创建 POC 群组
python3 scripts/popo_manager.py create \
  --name "智能客服 POC" \
  --members "user1@corp.netease.com,user2@corp.netease.com,user3@corp.netease.com"

记录返回的 group_id，后续所有操作都需要使用。

第二步：配置定时任务

在 HEARTBEAT.md 中添加定时任务：

## 每天 9:00 生成 POC 日报

- 执行日报生成任务
- 命令：cd ~/.openclaw/workspace/skills/poc-tracker && python3 scripts/scheduler.py daily --group-id <GROUP_ID> --poc-name "智能客服 POC" --output-dir ~/.openclaw/workspace/poc-reports/

## 每周五 17:00 生成 POC 周报

- 执行周报生成任务
- 命令：cd ~/.openclaw/workspace/skills/poc-tracker && python3 scripts/scheduler.py weekly --group-id <GROUP_ID> --poc-name "智能客服 POC" --output-dir ~/.openclaw/workspace/poc-reports/ --week-start <周一日期> --week-end <周五日期>

第三步：手动生成报告

生成日报

# 1. 获取群消息
python3 scripts/popo_manager.py messages \
  --group-id <GROUP_ID> \
  --start 2026-03-25 \
  --end 2026-03-25 > messages_2026-03-25.json

# 2. 生成日报
python3 scripts/daily_report.py \
  --messages messages_2026-03-25.json \
  --poc-name "智能客服 POC" \
  --date 2026-03-25 \
  --output daily_report_2026-03-25.md \
  --todos todos_2026-03-25.json

生成周报

# 生成周报（需要本周的每日分析数据）
python3 scripts/weekly_report.py \
  --daily-analyses "analysis_2026-03-25.json,analysis_2026-03-26.json,..." \
  --poc-name "智能客服 POC" \
  --week-start 2026-03-25 \
  --week-end 2026-03-29 \
  --output weekly_report_2026-03-25_2026-03-29.md

生成项目总结报告

# 生成 POC 总结报告
python3 scripts/summary_report.py \
  --analyses "analysis_2026-03-25.json,analysis_2026-03-26.json,..." \
  --poc-name "智能客服 POC" \
  --start-date 2026-03-25 \
  --end-date 2026-04-10 \
  --output poc_summary_report.md

脚本说明

popo_manager.py - POPO 群管理

功能：

  • 创建 POC 群组
  • 邀请成员
  • 获取群消息
  • 发送群消息

命令：

# 创建群组
python3 scripts/popo_manager.py create --name <POC名称> --members <邮箱列表>

# 邀请成员
python3 scripts/popo_manager.py invite --group-id <ID> --members <邮箱列表>

# 获取消息
python3 scripts/popo_manager.py messages --group-id <ID> --start <开始日期> --end <结束日期>

# 发送消息
python3 scripts/popo_manager.py send --group-id <ID> --message <内容>

daily_report.py - 日报生成

功能：

  • 分析群消息
  • 提取进展、问题、风险、决策、待办
  • 生成 Markdown 格式日报
  • 生成待办事项 JSON

命令：

python3 scripts/daily_report.py \
  --messages <消息JSON文件> \
  --poc-name <POC名称> \
  --date <日期> \
  --output <输出文件> \
  --todos <待办输出文件>

weekly_report.py - 周报生成

功能：

  • 汇总一周数据
  • 分析进展趋势
  • 突出风险和问题
  • 生成 Markdown 格式周报

命令：

python3 scripts/weekly_report.py \
  --daily-analyses <每日分析文件列表> \
  --poc-name <POC名称> \
  --week-start <开始日期> \
  --week-end <结束日期> \
  --output <输出文件>

summary_report.py - 总结报告生成

功能：

  • 汇总整个 POC 周期数据
  • 生成项目概览
  • 统计关键指标
  • 生成 Markdown 格式总结报告

命令：

python3 scripts/summary_report.py \
  --analyses <所有分析文件列表> \
  --poc-name <POC名称> \
  --start-date <开始日期> \
  --end-date <结束日期> \
  --output <输出文件>

scheduler.py - 定时任务调度

功能：

  • 自动执行日报任务
  • 自动执行周报任务
  • 自动执行总结任务
  • 自动发送报告摘要到群里

命令：

# 日报任务
python3 scripts/scheduler.py daily --group-id <ID> --poc-name <名称> --output-dir <目录>

# 周报任务
python3 scripts/scheduler.py weekly --group-id <ID> --poc-name <名称> --output-dir <目录> --week-start <日期> --week-end <日期>

# 总结任务
python3 scripts/scheduler.py summary --group-id <ID> --poc-name <名称> --output-dir <目录> --start-date <日期> --end-date <日期>

消息分析规则

系统自动识别以下类型的消息：

类型 关键词
进展更新 进度、完成、搞定、done、finished、已解决
问题 问题、bug、错误、异常、issue、error、失败
风险 风险、延期、延迟、block、阻塞、担心
决策 决定、确定、方案、采用、选择、decision
待办 待办、todo、任务、需要、待处理、action

报告内容

日报包含

  • 今日进展统计
  • 问题与风险列表
  • 决策记录
  • 待办事项
  • 参与者列表

周报包含

  • 本周概览和趋势
  • 未解决问题（重点关注）
  • 风险提醒
  • 已解决问题
  • 重要决策
  • 下周建议

总结报告包含

  • 项目概览
  • 关键数据统计
  • 主要进展汇总
  • 问题与风险汇总
  • 重要决策记录
  • 项目成果和经验总结

目录结构建议

~/.openclaw/workspace/poc-reports/
├── <POC名称>/
│   ├── daily/
│   │   ├── daily_report_2026-03-25.md
│   │   ├── daily_report_2026-03-26.md
│   │   └── ...
│   ├── weekly/
│   │   ├── weekly_report_2026-03-25_2026-03-29.md
│   │   └── ...
│   ├── analysis/
│   │   ├── analysis_2026-03-25.json
│   │   └── ...
│   └── poc_summary_report.md

注意事项

  1. 群组 ID：创建群组后请妥善保存 group_id，后续所有操作都需要
  2. 成员邀请：创建群组时可以直接邀请成员，也可以后续使用 invite 命令添加
  3. 定时任务：建议在 HEARTBEAT.md 中配置定时任务，实现自动化
  4. 数据保留：分析数据（JSON 文件）需要保留，用于生成周报和总结报告
  5. 消息权限：确保机器人有权限读取群消息和发送消息

依赖

  • Python 3.8+
  • requests 库
  • 访问 POPO Open API 的权限

故障排查

无法获取 token

  • 检查 ~/.openclaw/openclaw.json 中的 POPO 配置
  • 确认 appKey 和 appSecret 正确

无法获取群消息

  • 确认群组 ID 正确
  • 确认机器人已在群组中
  • 确认有消息读取权限

报告生成失败

  • 检查消息 JSON 文件格式
  • 确认输出目录存在且有写入权限
Installs
1
Source
skills.netease.…88c25f7b
First Seen
11 days ago