前言¶
團隊習慣在騰訊文檔裏按天寫日報，週報卻要手工從一篇長文檔裏摘五天內容，再貼到彙總表裏對應姓名列。週一上午重複做這件事，既慢也容易漏某天或貼錯列。下面介紹 SkillHub 社區 Skill「每週一自動同步上週日報」（座標 @user_93772aaf/weekly-report-sync）：用 OAuth 調騰訊文檔開放接口讀日報、算上週工作日、按姓名列寫回表格，並可選用企業微信 Webhook 通知完成。
這是什麼¶
一句話定位：面向辦公場景的定時工作流 Skill，通過 HTTP 調用騰訊文檔 API，把「日報文檔」裏上一週的內容同步到「彙總表」中你所在的那一列。
- 出品與維護：社區發佈者
user_93772aaf，來源爲 community，SkillHub 分類office-efficiency，當前商店版本 1.0.2（包內SKILL.md元數據爲 1.0.0，以商店版本爲準）。 - 調度：包內聲明
cron: "10 9 * * 1"，即每週一 09:10 執行。 - 依賴：標籤
requires_api_key=true；運行前需配置騰訊文檔應用的 ClientID、ClientSecret 及文檔/表格 ID。
核心功能¶
以下能力均來自已安裝的 Skill 包內 SKILL.md 步驟定義，未在文檔中出現的邏輯不寫。
-
獲取訪問令牌
向https://docs.qq.com/open/api/oauth2/token以client_credentials換取access_token，scope 爲doc:read sheet:read sheet:write。 -
讀取日報全文
GEThttps://docs.qq.com/open/api/doc/v1/content?doc_id=...，得到日報文檔 A 的完整正文。 -
讀取彙總表表頭
GET 彙總表 B 的第一行表頭（range=A1:Z1），用於按姓名定位列。 -
計算上週日期
用日期表達式算出上週一至上週五的YYYY-MM-DD，供後續按日期截取正文。 -
按日期截取並寫入表格
文檔中以「週一」爲例：在正文中定位上週一、上週二日期之間的片段，寫入彙總表對應姓名列（示例 range 爲姓名列第 2 行）。其餘工作日是否另有步驟，以你本地安裝包內SKILL.md爲準（當前公開包僅展示到週一寫入）。 -
企業微信通知（可選）
若配置了wecom_webhook，向該地址 POST 文本消息，提示同步完成、姓名與上週日期區間。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按官方安裝說明執行（完整安裝或僅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
說明文檔：https://skillhub.cn/install/skillhub.md。
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。
skillhub install weekly-report-sync --namespace user_93772aaf --dir <你的 skills 目錄>
常見客戶端 skills 路徑（摘自 SkillHub 安裝說明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可讓 AI 按商店頁提示安裝：參考 https://skillhub.cn/install/skillhub.md，安裝 @user_93772aaf/weekly-report-sync。
3、配置運行參數¶
Skill 聲明的必填 inputs 如下（名稱與類型以 SKILL.md 爲準）：
| 字段 | 說明 |
|---|---|
client_id |
騰訊文檔 ClientID |
client_secret |
騰訊文檔 ClientSecret |
doc_a_id |
日報文檔 ID（doc） |
sheet_b_id |
彙總表 ID（sheet） |
user_name |
彙總表表頭中你的姓名（用於定位列） |
wecom_webhook |
企業微信通知地址（可選） |
需在騰訊文檔開放平臺創建應用並拿到上述憑證；文檔與表格 ID 需與團隊實際使用的日報、彙總表一致。具體在 SkillHub / OpenClaw 側如何填寫 inputs、如何掛接 cron，以你所用運行環境的 Skill 執行說明爲準。
典型用法¶
- 在 SkillHub 安裝
@user_93772aaf/weekly-report-sync到當前 Agent 的 skills 目錄。 - 在騰訊文檔側準備好：一篇按日期書寫的日報文檔、一張以姓名爲列頭的彙總表，並開通 API 權限。
- 按
SKILL.md填寫client_id、client_secret、doc_a_id、sheet_b_id、user_name；需要提醒時加上wecom_webhook。 - 啓用包內 cron（每週一 09:10）後，到點自動走「取 token → 讀文檔 → 算上週日期 → 截取內容 → 寫入表格 → 可選通知」鏈路。
若需手動驗證，可在支持該 Skill 格式的運行器中觸發一次完整步驟，對照彙總表對應單元格與企業微信消息是否更新。
適用場景與注意¶
適合誰
- 日報集中在騰訊文檔一篇 doc、週報填在同一張 sheet 裏按人分列的團隊。
- 希望週一固定時間自動彙總「上週」片段，減少複製粘貼的人。
限制與注意
- 強依賴騰訊文檔開放 API 與網絡可達；憑證泄露風險需按公司規範保管
client_secret。 - 正文截取依賴日報裏出現的日期字符串與
YYYY-MM-DD規則一致；格式不統一會導致截取爲空或錯位。 - 姓名必須與彙總表第一行表頭完全匹配，否則列定位會失敗。
- 商店統計（截至資料抓取）：評分 100000，下載 961，安裝 2；Skill 能力以包內
SKILL.md爲準，若與商店簡介不一致，以安裝包爲準。
結尾¶
「每週一自動同步上週日報」把週報整理從手工複製變成可配置的 API 工作流，適合騰訊文檔日報 + 彙總表協作方式。安裝與優先源說明見 https://skillhub.cn/install/skillhub.md，Skill 主頁見 https://www.skillhub.cn/skills/user_93772aaf/weekly-report-sync，API 條目地址 https://api.skillhub.cn/user_93772aaf/weekly-report-sync。
