通用周报 Webhook 自动同步服务
📌 概述
本技能是一个通用的周报自动化整理与推送服务。它能够:
1. 动态读取任何指定的个人每日进度文档(REDoc);
2. 提取、脱水、提炼为极其专业的大厂极简商务风周报;
3. 将格式化周报以 Markdown 图文卡片的形式,通过 群聊 Webhook 强推送到指定的 Hi 团队群聊中,并向用户自己发送私信副本。
⚙️ 动态配置项(去耦合设计)
为了让不同的人或团队都能复用此技能,本技能禁止硬编码个人敏感数据。
Agent 在执行前,必须首先读取当前用户工作区根目录下的 TOOLS.md 中的 ### Weekly Report Sync 章节,动态加载以下配置变量:
- 数据源链接 (REDoc URL):
source_redoc_url—— 用户记录每日进度的工作文档链接 - 群聊推送 Webhook 链接:
target_webhook_url—— 接收推送的群聊 Webhook 密钥链接 - 用户邮箱 (Email):
user_email—— 接收私信副本的用户邮箱账号
🛠️ 标准执行工作流
当触发此技能时,Agent 必须按以下步骤严格执行:
第一步:动态加载配置变量
读取并解析工作区 TOOLS.md。如果 TOOLS.md 中不存在这些变量,向当前用户询问这些参数并引导其在 TOOLS.md 中留底。
第二步:读取原始工作记录
使用 bunx @xhs/hi-workspace-cli@0.2.7 docs:get 抓取配置中 source_redoc_url 对应的文档 Markdown 全文:
bunx @xhs/hi-workspace-cli@0.2.7 docs:get --shortcut-id <source_redoc_url>
第三步:智能脱水与商务风排版
将获取到的每日原生态日志提炼为标准格式。必须严格遵循【大厂极简商务风】格式,且严禁使用 markdown 表格:
# 📋 [用户姓名]周报 | [日期范围] (第X周)
【本周产出】
* **[业务板块/项目名]**:[具体内容,加粗重点数字或核心成果]
...
【心得沉淀】
* **[主题名]**:[方法论总结,加粗核心主旨]
...
【瓶颈与改进】
* **卡点**:[客观描述当前的具体技术/业务阻碍]
* **改进**:[针对卡点提出具体的优化动作]
...
【下周计划】
1. [清晰可量化的下周目标]
...
第四步:群聊 Webhook 强推送
拼装标准的 Webhook Markdown 推送包。向 target_webhook_url 发送 POST 请求实现群投递强通知:
# 将以下 payload 写入临时文件 /tmp/payload.json
{
"msgtype": "markdown",
"markdown": {
"content": "大家下午好!这是 [用户姓名] 本周的工作周报,请查收:\n\n" + [整理后的Markdown周报]
}
}
# 使用 curl 发送 POST 请求到配置好的 Webhook 链接
curl -X POST -H "Content-Type: application/json" -d @/tmp/payload.json "<target_webhook_url>"
第五步:私信副本确认
使用 message 工具(channel=hi)给配置中的 user_email 发送私信确认及周报备份:
{
"action": "send",
"channel": "hi",
"target": "<user_email>",
"message": "Hi,本周的工作周报已成功通过 Webhook 推送到群聊啦!\n\n[此处附带整理后的周报全文]"
}
📅 如何设置定时自动触发 (Cron)
本技能支持极速配置为定时任务。只需在 Cron 任务的 payload 消息中写明:
> "使用 weekly-report-webhook-sync 技能,自动读取我的配置并执行本周周报提炼与推送。"