mcpField
W
weekly-review

weekly-review

github.com/alirezarezvani生産性29.0k50 回インストール今日更新
リポジトリ

weekly-review について

weekly-reviewは、個人のGTDレビューを3段階で進めるスキルです。スクリプトがワークスペースの証拠を調べて完了判定を行い、外部APIやスクリプト内のLLM呼び出しはありません。

主な機能

  1. 01未チェック項目やTODOのスキャン
  2. 023段階・10ステップのレビュー案内
  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 のループから信頼できるシステムへ

移植性: 推論主導型のスキルで、標準ライブラリを使った Python スクリプトが 3 つあります。外部 API も、スクリプト内での LLM 呼び出しもありません。 Claude Code CLI と Claude.ai ウェブで動作します。スクリプトが棚卸しと判定を行い、考えるのは Claude とユーザーです。

これは何をするものか

個人のシステムは、レビューをしなければ信頼できるものにはなりません。David Allen は、週次レビューを手法全体の重要な成功要因と呼んでいます。このスキルは、3 つのフェーズを順番に進め、必須の GET CURRENT の 5 ステップのうち、未確認のものが 1 つでもあればレビューを COMPLETE とすることを拒みます。まずは証拠を確認します。ユーザーに思い出してもらう前に、ワークスペースをスキャンして未完了のループを探してください。この手法では、記憶はまさに信頼すべきではないものだからです。

フェーズ 1 — GET CLEAR(ステップ 1〜3)

散在している入力を集め、すべての受信箱を空にします(明確化し、実行はしません。2 分を超えるものはすべて次のアクションにします)。その後、頭を空にするためにマインドスイープを行います。証拠の確認から始めます。

# 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、すべて必須)

次のアクションのリストを確認し(完了に印を付け、不要になった項目を削除します)、過去のカレンダーを確認し(守れなかった約束はアクションにします)、今後のカレンダーを確認し(反応するのではなく、準備します)、返答待ちのリストを確認し(催促するか、削除します)、すべてのプロジェクトに次のアクションがちょうど 1 つあるかを確認します。その後、正直に判定します。

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 を判定します。レビューの最後に、名前を付けた次のアクションを 1 つ決めます。

スクリプト

スクリプト役割
scripts/open_loop_scanner.pyディレクトリ内の未チェックのチェックボックス、TODO/FIXME マーカー、古いファイルを棚卸しします。グループ別の件数とファイルごとの場所を表示します。--json。
scripts/weekly_review_gate.py3 つのフェーズにわたる 10 ステップのチェックリストです。--done/--skip/--list。完了率と未完了項目を表示し、COMPLETE(終了コード 0)/INCOMPLETE(終了コード 2)を判定します。
scripts/commitment_auditor.py停滞しているコミットメントと、アクションがないコミットメントにフラグを付け、表示される計算式に基づいて 0〜100 の健全性スコアを算出し、HEALTHY / DRIFTING / OVERCOMMITTED を判定します。

参考資料

  • references/gtd_weekly_review_canon.md — 週次レビューが重要な成功要因である理由、3 フェーズの構成、実施頻度の管理(7 件の情報源)
  • references/open_loop_psychology.md — ツァイガルニク効果、計画立案に関する研究、注意残余:未完了のループが注意力を消耗させる理由(6 件の情報源)
  • references/review_cadence_design.md — フォーカスの階層、習慣の定着、タイムボックス、失敗のパターン、中断後の再開(7 件の情報源)

アセット

ルール

  • GET CURRENT の 5 ステップはすべて必須です。理由を明示した場合に限りスキップできますが、判定ではそのステップも表示されます。
  • 自分で完了を認定しないでください。判定結果を出すのは判定処理です。終了コードを伝え、甘い判定にしないでください。
  • 実行ではなく処理を行います。レビュー中、2 分を超えるものは寄り道せず、次のアクションにします。
  • 60〜90 分を目安に時間を区切ります。2 時間を超えたら、完了した分を正直に判定し、残りは予定に入れます。
  • 習慣が途切れた場合は、短縮版で罪悪感なく再開します。レビューはメンテナンスであり、評価ではありません。

明確な違い(間違った類似項目を選ばないでください)

  • productivity/reflect — 1つの会話または作業を1回振り返ります。週次レビューは、システム全体を定期的に見直すサイクルです。
  • productivity/capture — 取り込みの入り口(ブレインダンプ → アクション)です。Capture はシステムに情報を取り込み、このレビューはシステムへの信頼を保ちます。
  • project-management のスプリントレトロスペクティブ — 共有するイテレーションについてのチームの儀式です。これは、個人の信頼できるシステムを監査するものです。

バージョン: 1.0.0 · ビルドパターン: Path-B の儀式スキル — GTD の週次レビューサイクルを維持し、決定論的なゲート/スキャナー/監査スクリプトを追加します。

コメント