mcpField
W
weekly-review

weekly-review

github.com/alirezarezvani生产力29.0k50 次安装今天更新
代码仓库

关于 weekly-review

weekly-review 是用于个人 GTD 回顾的技能，引导用户完成清理、更新和展望三个阶段。脚本扫描工作区证据并执行完成门槛，不调用外部 API，脚本也不调用 LLM。

主要功能

  1. 01扫描未勾选事项及 TODO 标记
  2. 02引导完成三阶段十步回顾
  3. 03跳过步骤时要求说明理由
  4. 04报告完成状态和未完成步骤
  5. 05审查停滞或缺少行动的承诺

适用场景

  1. 01查找笔记目录中的未完成事项
  2. 02回顾日历、行动清单和项目
  3. 03客观检查每周回顾是否完成
  4. 04识别停滞承诺并确定下一步行动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill weekly-review

安装后在 Claude Code 中输入/weekly-review确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
example_weekly_review.md
weekly_review_checklist.md
references/
gtd_weekly_review_canon.md
open_loop_psychology.md
review_cadence_design.md
scripts/
commitment_auditor.py
open_loop_scanner.py
weekly_review_gate.py

详细介绍

每周回顾 — GTD 循环 → 可信赖的系统

**可移植性：**以推理为主的技能，包含 3 个 Python 标准库脚本。脚本不调用外部 API，也不调用大模型。 适用于 Claude Code CLI 和 Claude.ai 网页版。脚本负责清点和把关；Claude 和用户负责思考。

功能介绍

只有经过回顾，个人系统才值得信赖——David Allen 称每周回顾是整个方法的关键成功因素。此技能按顺序引导你完成三个阶段，并且只要五个必需的 GET CURRENT 步骤中有任何一个尚未处理，就不会将回顾判定为 COMPLETE。先看证据：先扫描工作区中的未完成事项，再请用户回忆，因为这个方法明确指出，恰恰不该信任他们的记忆。

阶段 1 — GET CLEAR（步骤 1-3）

收集零散输入，将所有收件箱处理至清空（厘清，不要执行——超过两分钟的事项都转为下一步行动），然后进行头脑清空。先从证据开始：

# Inventory open loops: unchecked checkboxes, TODO/FIXME markers, stale files
python scripts/open_loop_scanner.py --dir ~/notes --stale-days 14

将发现的每个未完成事项归入一个清单——下一步行动、等待事项、将来/也许，或丢弃。

阶段 2 — GET CURRENT（步骤 4-8，全部必做）

回顾下一步行动清单（标记已完成，清理无效事项）、上一周的日历（将错过的承诺转为行动）、即将到来的日历（做好准备，而不是临时应对）、等待事项清单（跟进或放弃），并为每个项目确定且仅确定一个下一步行动。然后如实把关：

python scripts/weekly_review_gate.py --list   # show the numbered ten-step checklist
python scripts/weekly_review_gate.py --done "1,2,3,4,5,6,7,8" --skip "9:no someday list yet"

把关程序会计算完成百分比，列出所有缺失步骤，并以退出码 0（COMPLETE）或 2（INCOMPLETE）结束。任何未标记为跳过的 GET CURRENT 缺失步骤都会导致 INCOMPLETE。

阶段 3 — GET CREATIVE（步骤 9-10）

回顾将来/也许清单（启用、保留或删除），趁头脑清晰时记录新想法，然后审查整个承诺组合：

python scripts/commitment_auditor.py --input commitments.json

标记 STALLED / NO-NEXT-ACTION / SOMEDAY-CANDIDATE，打印附带分数的健康度公式，并给出 HEALTHY / DRIFTING / OVERCOMMITTED 结论。以一项明确命名的下一步行动结束回顾。

脚本

脚本作用
scripts/open_loop_scanner.py清点目录中的未勾选复选框、TODO/FIXME 标记和过期文件；按类别统计并列出各文件位置；支持 --json。
scripts/weekly_review_gate.py涵盖三个阶段的十步清单；支持 --done/--skip/--list；输出完成百分比和明确列出的缺漏 → COMPLETE（退出码 0）/ INCOMPLETE（退出码 2）。
scripts/commitment_auditor.py标记停滞和缺少行动的承诺，根据所示公式计算 0-100 的健康度分数 → HEALTHY / DRIFTING / OVERCOMMITTED。

参考资料

资源文件

规则

  • 五个 GET CURRENT 步骤全部必做；只有说明理由后才能跳过，而且把关程序仍会列出该步骤。
  • 绝不自行认证——由把关程序给出判定；如实转达其退出码，不要弱化结论。
  • 处理，不执行：回顾期间，任何超过两分钟的事项都应转为下一步行动，而不是临时插入的任务。
  • 将时间控制在 60-90 分钟；超过两小时后，如实把关已完成部分，并为剩余部分安排时间。
  • 中断的习惯可以从较短的一轮重新开始，不必自责——回顾是维护，不是评判。

区别（别误用相近工具）

  • productivity/reflect — 对一次对话或一项工作进行一次反思。周回顾则是覆盖整个系统的定期惯例。
  • productivity/capture — 输入渠道（脑力倾泻 → 行动）。Capture 为系统提供输入；此回顾则让系统保持可信。
  • project-management 冲刺回顾 — 围绕共同迭代开展的团队仪式。这是对个人可信系统的审计。

版本： 1.0.0 · 构建模式： Path-B 仪式技能 — 保留 GTD 周回顾循环，并添加确定性门控／扫描器／审计器脚本。

评论

支持 Markdown