agentleFS
smiling66652smiling66652/workbuddy-skill-toolkits/weekly-review/SKILL.md

weekly-review

Skill1 starsChanged 48 days agoMITView on GitHub

汇总本周做了什么:读取 git 提交记录和每日记忆日志,生成结构化周报(本周完成/未完成/卡点/下周计划)。 触发词:周复盘、本周总结、这周做了什么、周报、weekly review、周报生成、一周回顾

Files
SKILL.md

周复盘(weekly-review)

用途:保研冲刺期时间紧,用一条命令把一周的工作量自动汇总成表格 + 要点的周报,不写长段落,一眼看全进度与卡点。

适用场景

  • 每周日/周一固定复盘,向导师或自己交代进度
  • 保研面试前整理“这学期我做了啥”的素材
  • 配合 git-ship 看本周提交,配合 techdebt 看本周清了多少债

执行步骤

1. 拉取本周 git 提交(按当前作者)

在仓库根目录打开 Git Bash:

git log --since="1 week ago" --pretty=format:"%ad|%s" --date=short \
   --author="$(git config user.name)"

想看改动文件量,加 --stat:

git log --since="1 week ago" --stat --author="$(git config user.name)"

2. 读取每日记忆日志(若存在)

日志目录在 D:\.workbuddy\memory\,优先读本周(周一至今)的文件:

ls -1 /d/.workbuddy/memory/ 2>/dev/null | grep -E "$(date +%Y-%m)-[0-9]{2}" 

把列出的每个日志文件用 Read 工具打开,提取“今天完成 / 卡住 / 明天计划”要点。

若该目录不存在或为空,跳过此步,仅基于 git 记录复盘,并在周报注明“无记忆日志”。

3. 归类

把步骤 1、2 的信息分到四类:本周完成、未完成、卡点、下周计划。git 提交对应“完成”;记忆日志里的“卡住”对应“卡点”;“明天计划 / 待办”对应“下周计划”。

输出格式

输出严格用表格和要点,不要长段落。模板如下:

周复盘 · 2026-09-07 ~ 2026-09-13

一、本周完成

日期事项关联提交/日志
09-09微信小程序登录页联调feat: 登录页 wx.login 联调
09-11作品集 README 重写记忆日志 09-11

二、未完成

  • 后端接口鉴权(预计还需 1 天)
  • 作品集部署到云服务器

三、卡点

  • 小程序 wx.request 真机调试 HTTPS 证书校验失败,待申请域名备案
  • numpy 版本与导师环境不一致,已在记忆日志记录

四、下周计划

  • 完成接口鉴权并补测试
  • 把 3 个作品部署上线,写部署文档
  • 跑一次 techdebt 清作品集旧债

注意事项

  1. 时间范围默认“最近 7 天”;若用户指定了起止日期,改用 --since="YYYY-MM-DD" --until="YYYY-MM-DD"。
  2. 多仓库场景:对每个仓库分别跑步骤 1,再合并到同一张“完成”表。
  3. 卡点要写具体阻碍 + 已尝试的解决,方便下周直接接着干,而不是重复踩坑。
  4. 周报里出现的提交 hash 用反引号包裹,便于跳转。
  5. 不要编造没发生的事;git 没有提交、记忆日志没有记录的,就归入“未完成/下周计划”,不要硬凑“完成”。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.