- name
- daily-report-assistant
- description
- |
🦞 龙虾教研日报助手
让每位教研老师只需对话，就能完成每日日报记录和月底汇总。
⚙️ 前置要求
使用本技能前，请确保已安装以下依赖：
| 依赖 | 版本 | 说明 |
|---|---|---|
| Node.js | ≥ 18 | 运行 mcporter 工具 |
| npm | ≥ 9 | 安装/运行 mcporter |
| Python 3 | ≥ 3.8 | 辅助数据处理 |
请确保node、npm、python3均已在终端中可用。
🔐 授权与配置
第一步：安装技能
在 WorkBuddy 对我说：
clawhub install daily-report-assistant第二步：获取腾讯文档授权
- 访问授权链接，完成腾讯文档 OAuth 授权：
👉 https://docs.qq.com/scenario/open-claw.html?nlc=1
- 授权完成后，告诉我："授权完成"
- 告诉我你的姓名，完成绑定
Token 说明
- Token 获取：从上方授权链接一次性获取
- 存储位置：存储在本地 mcporter 配置中（
~/.mcporter/），不保存在技能文件夹内 - 撤销方式：在腾讯文档网页端取消授权，或运行
clawhub logout - 安全提示：Token 仅用于读写你授权的腾讯文档数据，不会访问其他内容
🔧 配置文件 ID 说明
本技能涉及两个腾讯文档资源：
| 配置项 | 默认值 | 说明 |
|---|---|---|
FILE_ID | DQ1hFandNaE1jZkto | 教研项目智能表格 |
SHEET_ID（日报） | tMmx23 | 每日进展 |
SHEET_ID（人员） | tFPVpZ | 教研人员 |
SHEET_ID（项目） | ss_w6lavv | 项目信息 |
⚠️ 如需连接其他表格，请修改scripts/setup.sh和scripts/daily-report.sh中的对应变量。
📡 数据流向说明
你的对话
→ WorkBuddy（小爪）
→ scripts/daily-report.sh（处理逻辑）
→ mcporter（调用腾讯文档 API）
→ 腾讯文档在线表格本技能不会：
- 访问你腾讯文档账号中的其他文件
- 将数据发送至第三方服务器
- 在你授权范围外使用数据
🚨 常见问题
Q：提示"找不到 node"怎么办？ A：请先安装 Node.js：https://nodejs.org/
Q：提示"npm 不存在"怎么办？ A：安装 Node.js 后 npm 会一同安装，请确保 node 和 npm 都已配置到系统 PATH。
Q：Token 泄露了怎么办？ A：立即到腾讯文档网页端撤销授权（https://docs.qq.com → 个人设置 → 应用授权），然后重新获取新 Token。
Q：如何彻底移除授权？ A：两步：1）在腾讯文档端撤销授权；2）运行 clawhub logout 清除本地记录。
Q：可以连接我们自己的表格吗？ A：可以，修改脚本中的 FILE_ID 和各 SHEET_ID 即可。人员表和项目信息表需与日报表结构兼容。
📦 技能结构
| 文件 | 作用 |
|---|---|
SKILL.md | 技能说明（本文件） |
scripts/setup.sh | 配置引导脚本 |
scripts/daily-report.sh | 日报读写核心脚本 |
scripts/lib/project-matcher.sh | 项目名自动匹配 |
references/data-schema.md | 数据结构说明 |
*本技能已通过 ClawHub 安全扫描，详见发布页面安全报告。*