メモと TODO から週報を作成(出典リンクつき)
Weekly report from notes, TODOs and git log
指定した期間の Markdown メモ、TODO ファイル、git のコミットから「完了・進行中・ブロック中・来週」の項目を集め、出典つきの週報にまとめます。
できること
毎週の振り返りや上司への週報を、自分のメモから作ります。
- [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
#blockedand 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.
インストール方法
- ダウンロードしたZIPを展開します(中に
weekly-report-from-notes/フォルダとSKILL.mdがあります)。 - フォルダごと、使うエージェントのスキル置き場にコピーします。
- Claude:
~/.claude/skills/(プロジェクト単位なら.claude/skills/) - Hermes Agent:
~/.hermes/skills/ - Codex:
~/.agents/skills//Cursor:~/.cursor/skills/ - Claude アプリ(claude.ai):「カスタマイズ → スキル」からZIPをアップロード
- Claude:
- エージェントを再起動し、スキル一覧に表示されることを確認します。
出品者
AI Skill Market 公式
出品スキル 44 件