前言¶
周五下午要交周报，手头往往不止一个仓库：主项目、脚本库、文档仓各自有提交，人工翻 git log 再归类成「本周完成 / 进行中 / 风险」既慢又容易漏。常见做法是固定模板 + 自己复制粘贴，或写一次性脚本只覆盖某一个目录。
下面介绍 SkillHub 上的 weekly-report（坐标 @user_1f530050/weekly-report-new）：在 Agent 里用自然语言触发后，扫描指定目录下各项目的 Git 提交记录，整理成格式化周报并写入指定路径。标签标明 requires_api_key=false，不依赖外部 API Key。
这是什么¶
weekly-report 是社区来源（community）的办公效率类 Skill，当前版本 1.0.0，由发布者 user_1f530050 维护，分类为 office-efficiency。
一句话定位：当用户表达「编写周报」「生成周报」「写周报」或类似意图时自动触发，拉取指定目录内所有项目的 Git 提交，分析后生成周报文档并保存到指定目录。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_1f530050/weekly-report-new
- API 坐标页：https://api.skillhub.cn/user_1f530050/weekly-report-new
核心功能¶
以下能力均来自官方简介，未在页面单独展开的配置项不臆造：
- 意图触发：识别「写周报 / 生成周报 / 编写周报」等表述，由 Agent 加载本 Skill 后执行流程。
- 多项目 Git 汇总：在用户指定的目录下，遍历其中的项目并获取 Git 提交记录（具体分支、时间范围以对话中与 Skill 的约定为准；页面未给出固定配置文件字段）。
- 分析与成稿：对提交记录做归纳，输出格式化的周报正文。
- 落盘：将生成的周报保存到用户指定的目录。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方一键脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 weekly-report¶
官方页面要求按 SkillHub 安装说明 安装，坐标为 @user_1f530050/weekly-report-new。安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @user_1f530050/weekly-report-new --dir <skills 目录>
各客户端常用 skills 路径（摘自 SkillHub 安装文档，按你当前环境选用其一）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装后若 Agent 未立即加载新 Skill，按所用客户端说明重启或刷新 skills 缓存。
Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录路径 与是否需重启会话；安装命令本身均为 skillhub install … --dir <路径>，页面未提供各客户端不同的第二条安装命令。
典型用法¶
官方未给出独立 README 式的逐步截图，可复现的用法如下：
- 完成上一节安装，并确认 Agent 已能发现
weekly-report。 - 在对话中说明扫描哪些项目（父目录路径）以及周报输出目录；若需限定时间范围，在请求里写清楚（例如「本周」「过去 7 天」），避免 Skill 自行猜测区间。
- 使用触发语发起任务，例如：
帮我生成周报：扫描
~/work/repos下所有 git 仓库，把本周提交整理成周报，保存到~/work/reports/。
- 在输出目录检查生成的周报文件，按需微调措辞后提交。
前提：目标目录下的子项目需为 Git 仓库且本机可正常执行 git 读取历史；无提交或无仓库的目录不会产生有效内容。
适用场景与注意¶
适合谁
- 本地或 monorepo 父目录下挂多个 Git 项目，周报需要汇总「做了什么」而非单仓 changelog。
- 已在使用 Cursor、Claude Code、Codex 等支持 Agent Skills 的客户端，希望用自然语言代替手写模板。
限制与注意
- 页面未声明对非 Git 目录、子模块、浅克隆等边界的处理；复杂拓扑建议先在少量仓库上试跑。
- 「分析」质量取决于提交信息是否规范；空 message 或含糊描述会影响周报可读性。
- 无需 API Key，但依赖本机 Git 与文件系统权限；扫描路径勿包含无权限目录。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载约 810 次，安装约 3 次；社区 Skill，升级与问题反馈以 SkillHub 页面与发布者为准。
结尾¶
weekly-report 把「多仓库 git log → 格式化周报文件」收成一条 Agent 工作流，适合每周固定从指定目录拉提交、写出稿再保存的场景。安装与坐标以官方为准：
https://www.skillhub.cn/skills/user_1f530050/weekly-report-new
