メモと TODO から週報を作成(出典リンクつき)

Weekly report from notes, TODOs and git log

指定した期間の Markdown メモ、TODO ファイル、git のコミットから「完了・進行中・ブロック中・来週」の項目を集め、出典つきの週報にまとめます。

ClaudeHermes AgentCodexCursorMIT(改変・再配布・商用利用可)Python

できること

毎週の振り返りや上司への週報を、自分のメモから作ります。

  • - [x](完了)、- [/](進行中)、- [ ](未完了)、- [>](先送り)、- [-](中止)のチェックボックスを読み取り
  • 日付は、項目の完了日(✅ 2026-11-10 など)、上にある日付入りの見出し(## 2026-11-10、## 11/10)、ファイル名の日付の順で判定
  • #blocked、「待ち」「保留」などの印からブロック中の項目を判定。「来週」見出しの下や、来週が期限の項目は「来週」へ
  • todo.txt 形式にも対応。git リポジトリを指定すると期間内のコミットも完了に加えます(作成者で絞り込み可)
  • すべての項目にファイル名と行番号(コミットはハッシュ)のリンクを付けた下書きと、JSON の一覧を出力

使い方

python scripts/weekly_report.py --notes notes/ --todo TODO.md --git . --since 2026-11-09 --until 2026-11-15 --out-dir weekly/

エージェントが重複をまとめ、メモに書かれた事実だけを使って読みやすい週報に書き直します。書かれていない成果や数字は足しません。

必要な環境

  • Python 3(標準ライブラリのみ)
  • コミットを含める場合のみ git

注意点

  • メモや TODO は読むだけで、チェックを付けたり書き換えたりはしません。
  • 期間より前の日付のメモに残った未完了項目は引き継ぎません。1 つの長いメモで管理している場合は --todo で渡してください。
  • 日付のない完了項目は、今週のものか確認できるよう別の一覧に分けます。
  • 共有前に、私的な項目が含まれていないか確認してください。
English description

Collects done, in-progress, blocked and next-week items from Markdown notes, TODO files and git commits in a date range, and turns them into a weekly report with source links.

What it does

Builds your weekly review or status report from your own notes.

  • Reads checkboxes: - [x] done, - [/] in progress, - [ ] open, - [>] deferred, - [-] cancelled
  • Dates each item by its completion date (such as ✅ 2026-11-10), the nearest dated heading above it (## 2026-11-10, ## 11/10), or a date in the file name
  • Detects blocked items from markers like #blocked and waiting-on phrases (Japanese words for waiting and on hold included); items under a Next week heading or due next week go to Next week
  • Supports todo.txt. With git repositories it adds commits in the range to Done (optionally filtered by author)
  • Writes a draft where every item links to its file and line (or commit hash), plus a JSON list

How to use

python scripts/weekly_report.py --notes notes/ --todo TODO.md --git . --since 2026-11-09 --until 2026-11-15 --out-dir weekly/

The agent merges duplicates and rewrites the items into a readable report using only facts found in your notes. It does not add results or numbers that are not written there.

Requirements

  • Python 3 (standard library only)
  • git, only if you include commits

Caveats

  • Notes and TODO files are only read; nothing is checked off or rewritten.
  • Open items in notes dated before the range are not carried over. If you keep one long log, pass it with --todo.
  • Checked items without a date are listed separately so you can confirm they belong to this week.
  • Review the report for private items before sharing it.

インストール方法

  1. ダウンロードしたZIPを展開します(中に weekly-report-from-notes/ フォルダと SKILL.md があります)。
  2. フォルダごと、使うエージェントのスキル置き場にコピーします。
    • Claude:~/.claude/skills/(プロジェクト単位なら .claude/skills/)
    • Hermes Agent:~/.hermes/skills/
    • Codex:~/.agents/skills//Cursor:~/.cursor/skills/
    • Claude アプリ(claude.ai):「カスタマイズ → スキル」からZIPをアップロード
  3. エージェントを再起動し、スキル一覧に表示されることを確認します。

Windows・Mac 別、エージェント別のインストール手順

出品者

AI Skill Market 公式

出品スキル 44 件

出品者のプロフィールとスキル一覧