SuperAPI AI 工具集

worklog

办公与效率

查看项目

更新于 10-16 02:31

技能介绍

Worklog 用于个人工作回顾,把本地 git 统计、GitHub 活动和云效数据整合为结构化 Markdown 报告。触发语包括「工作回顾」「日报」「周报」「worklog」「今天做了什么」「本周总结」。

模式选择:说「日报」「今天做了什么」进入 Daily,日期为今天;说「周报」「本周总结」进入 Weekly,日期从本周一到今天;说「工作回顾」「worklog」则询问用户。流程为确定模式与日期、并行采集数据、整合渲染;若无任何数据,输出“No activity recorded for {period}.”。

依赖工具:git 必需(brew install git 或 git-scm.com);gh、jq、yunxiao skill、yunxiao MCP 可选。gh 需 brew install gh 后执行 gh auth login。资料说明不要在技能加载时主动验证工具,命令因缺工具失败时再逐步引导安装配置。

采集步骤:本地 git 运行 bash scripts/stats.sh --since YYYY-MM-DD --until YYYY-MM-DD,输出 JSON 含 period、repos 与 totals;GitHub 运行 bash scripts/github.sh --since YYYY-MM-DD --until YYYY-MM-DD,输出 prs、issues 与 totals,用户名经 gh api user 自动识别;云效通过子代理调用 yunxiao skill,先用 MCP 获取身份再查 MR、Bug、Task。三种来源可并行,无并行环境则顺序执行。

整合与渲染:合并所有来源,失败来源注明(如“GitHub 数据未获取”“云效数据未获取”)后继续;用 template.md 渲染。周报还需提交分布,按周一至周五统计每日提交数并渲染 ASCII 柱状图,以及从 stats.sh 数据提取最活跃仓库与最大改动亮点。

降级行为:GitHub 或云效单独失败时注明并继续,两者都失败则只输出本地 git 统计。常见问题:stats.sh 仓库为空时检查日期范围与 --author 过滤;github.sh 失败或 401 时执行 gh auth login;云效 MCP 未连接时检查 MCP 服务器配置。所有用户身份在运行时自动识别,具体来源与前置条件见 user-config.md。

适用场景为个人日报、周报与工作回顾;不适用于团队绩效统计或其他非工作日志用途。仓库地址:https://www.skills.sh/niracler/skill/worklog。