前言¶

週報、月報往往要在一堆聊天記錄、臨時筆記和任務清單裏翻找素材，再按團隊模板重排結構。自己寫提示詞可以湊合，但輸入方式、輸出格式和續寫邏輯每次都要重新交代。下面介紹 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