前言¶

周报、月报往往要在一堆聊天记录、临时笔记和任务清单里翻找素材，再按团队模板重排结构。自己写提示词可以凑合，但输入方式、输出格式和续写逻辑每次都要重新交代。下面介绍 SkillHub 上的 Weekly Monthly Reporter Pro（坐标 @user_26bdbd50/weekly-monthly-reporter-pro，当前版本 1.0.1）：社区发布的办公效率类 Skill，把原始工作内容交给 AI，按固定结构生成周报或月报，并支持命令行与 Python API 调用。

这是什么¶

Weekly Monthly Reporter Pro 是一套遵循通用 SKILL.md 规范的 Agent Skill，由社区用户 user_26bdbd50 维护，在 SkillHub 分类为 office-efficiency，来源标记为 community。Skill 包内说明其定位是：将原始工作内容转化为结构化的周报/月报。

在 SkillHub 页面可见标签 requires_api_key=true：使用前需要配置校验用 Token，以及用于生成的 LLM API Key（见下文「API Key 与套餐」）。

核心功能¶

以下能力来自 Skill 包内 SKILL.md 的说明，按输入、输出与生成方式归纳。

触发方式¶

在支持 Skill 的 Agent 中，可用自然语言唤起，例如：

• 「生成周报」「写周报」「生成月报」「工作汇报」「工作总结」
• 英文：report generation、weekly report、monthly report
• 「续写周报」「继续上次写」

输入方式（与套餐档位相关）¶

输出格式¶

报告风格¶

Skill 预置四种风格：简洁版（快速同步）、详细版（含 KPI、改进与成长等章节）、领导版（侧重风险与指标）、自评版（成果与改进方向）。

其他能力¶

1. 续写：通过 --continue-from REPORT_ID 在上次报告基础上追加内容。
2. 历史与状态：CLI 提供 history、status；本地历史目录为 ~/.weekly_reporter/history/。
3. 飞书（Pro/Max）：读取任务需 OAuth（task:task:readonly）；Max 档可将报告以交互卡片发送（需机器人 Token）。
4. 校验与降级：访问校验服务失败时，文档说明会降级为 Free 档且不阻断使用；达生成上限或 Key 无效会返回对应错误。

生成次数与历史保留（官方档位表）¶

安装与启用¶

安装 SkillHub CLI¶

若尚未安装，可先检查版本：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方安装文档执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明见：https://skillhub.cn/install/skillhub.md

安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。本 Skill 的官方安装命令为：

skillhub install weekly-monthly-reporter-pro --namespace user_26bdbd50 --dir <skills 目录>

常见路径示例（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按你所用客户端要求重启或刷新 Agent，使 Skill 生效。

Python 依赖¶

Skill 包内 requirements.txt 要求：

requests>=2.28.0
python-docx>=0.8.11    # Word 输出
reportlab>=4.0.0       # PDF 输出

在 Skill 安装目录下安装依赖后，方可使用包内 scripts 模块。

典型用法¶

以下示例摘自 Skill 包内 SKILL.md，需在 Skill 安装目录下执行（将 YOUR_API_KEY 替换为实际 Token）。

命令行¶

# 生成周报
python -m scripts.main generate --content "今天完成了XX，明天计划做YY" -k YOUR_API_KEY

# 从文件生成
python -m scripts.main generate --file worklog.md -k YOUR_API_KEY

# 详细风格月报
python -m scripts.main generate --type monthly --style detailed -c "本月工作..." -k YOUR_API_KEY

# 续写
python -m scripts.main generate --continue-from REPORT_ID -c "新增工作..." -k YOUR_API_KEY

# 输出 Word
python -m scripts.main generate -c "内容..." -k KEY --format word --output report.docx

python -m scripts.main history -k YOUR_API_KEY
python -m scripts.main status -k YOUR_API_KEY
python -m scripts.main validate -k YOUR_API_KEY

Python API¶

from scripts.report_generator import ReportGenerator
from scripts.templates import ReportType, ReportStyle

generator = ReportGenerator(api_key="your_llm_key")
result = generator.generate_report(
    work_content="今天完成了A项目第一阶段...",
    report_type=ReportType.WEEKLY,
    style=ReportStyle.CONCISE,
    api_key="your_token_key"
)

if result["success"]:
    print(result["report"])

API Key 与本地路径¶

Token 校验 Key（必需）¶

• 在 YK-Global.com 获取，格式为 RPT-WEEKLY-*（如 RPT-WEEKLY-FREE、RPT-WEEKLY-STD 等）。
• 校验地址：https://api.yk-global.com/v1/verify
• Token 缓存：~/.weekly_reporter/token_cache.json

LLM API Key（生成内容）¶

需自行配置，支持 OpenAI 兼容接口（含 OpenAI 与自定义 endpoint）。

其他路径¶

• 上传文件：~/.weekly_reporter/uploads/

适用场景与注意¶

适合谁：需要定期写周报、月报或工作总结的开发者与办公用户；已使用 Cursor、Claude Code 等支持 Skill 的环境，并愿意配置 Token 与 LLM Key。

使用注意：

1. SkillHub 标注 requires_api_key=true，Free 档每月仅 5 次且历史不保留，选型前对照上表。
2. Word/PDF/飞书任务等能力受档位限制，不要假设安装后全部可用。
3. 飞书读写与发卡片涉及 OAuth 或机器人 Token，仅 Pro/Max（发卡片为 Max）适用。
4. SkillHub 统计（截至资料抓取）：评分 100000，下载约 791 次；以 SkillHub 页面实时数据为准。

结尾¶

Weekly Monthly Reporter Pro 把「零散记录 → 结构化周报/月报」做成可复用的 Skill 与 CLI：在 Agent 里用自然语言触发，或在安装目录用 scripts.main 批量生成。安装与坐标以 SkillHub 为准。

• API 条目：https://api.skillhub.cn/user_26bdbd50/weekly-monthly-reporter-pro
• SkillHub 页面：https://www.skillhub.cn/skills/user_26bdbd50/weekly-monthly-reporter-pro