前言¶
团队习惯在腾讯文档里按天写日报，周报却要手工从一篇长文档里摘五天内容，再贴到汇总表里对应姓名列。周一上午重复做这件事，既慢也容易漏某天或贴错列。下面介绍 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。
