Claude Code×TodoWriteで週次タスクを自動化する実践ワークフロー¶
この記事の対象者
- Claude Codeでの自律タスク実行は慣れているが、週次チェックを仕組み化できていない人
- TodoWriteのテンプレは使っているが、チェック項目を自動で回すフローをまだ整備していない人
- Search Consoleで拾えた新着クエリを迅速にコンテンツ改善へ繋げたい人
この記事のポイント¶
claude code todowriteなど今週伸びたクエリを起点にしたタスクリスト構築方法を理解できる- Claude CodeコマンドでTodoWriteテンプレを呼び出し、チェック項目を自動実行する手順が分かる
- 週次レポートの差分確認から振り返りまでを1つのフローとして再現できる
導入¶
既存ドキュメントにはTodoWriteの概要はあっても、週次レビューをClaude Codeで回す実践例はありません。本記事ではそのニーズに応え、TodoWriteテンプレとClaude Codeを組み合わせた「週次タスク自動化」の手順を紹介します。
ワークフロー全体像¶
| フェーズ | ゴール | Claude Codeアクション | TodoWriteで管理する粒度 |
|---|---|---|---|
| 1. シグナル収集 | 新着クエリ・減速ページの把握 | codex run で集計スクリプトを呼び出す | 週次レビューToDoを一括生成 |
| 2. 対応タスク実行 | 記事更新・ドラフト作成 | apply_patch や python コマンドで改善作業 | 各改善タスクを個別にin_progressへ |
| 3. レポート整理 | 振り返りと次週の仕込み | mkdocs_partial_build.py / cleanup を定期実行 | 完了タスクの結果とメモを残す |
ステップ1: 検索シグナルをTodoWriteに取り込む¶
1-1. データの抽出と整理¶
- 週次GSC分析レポート（Markdown形式）をClaude Codeで開き、伸長クエリ／ページをコピー
- 新規クエリ（例:
claude code todowrite,todowriteツール）をTodoWriteの「調査メモ」項目に追記
伸長クエリの拾い方
- 今週クリック≥5かつ先週比+4以上を優先
- CTRが20%超の場合は、現状の導線を維持しつつ関連記事を企画
1-2. TodoWriteテンプレの生成¶
以下のようなコマンドで、過去の週次レビューテンプレートをコピーして今週分を作成します。
cp todos/weekly-review-template.md \
todos/$(date +%Y-%m-%d)-weekly-review.md
1-3. チェックリストの初期化¶
- テンプレ内のフェーズ1項目を
in_progressに変更して作業を開始 - クエリ別の対処方針（例: ペア記事更新、ドラフト作成）をコメントとして残す
ステップ2: Claude CodeでTodoWriteを回す¶
2-1. 作業キューの順番決め¶
- TodoWriteに登録されているタスクIDを、Claude CodeのPlanステップにそのまま取り込む
- 1タスクずつ
in_progress → completedの順に更新し、Planにも反映する
2-2. コマンド実行例¶
週次レビューでよく使うコマンドをまとめておきます。各ブロックは10行以内で、必要に応じてそのままコピーして利用してください。
# 伸長クエリのデータ確認（GSCエクスポートをJSONで読み込み）
python show_query_diff.py \
--input gsc_queries_$(date +%Y%m%d).json
# 対象記事だけを部分ビルドで検証
mkdocs build --dirty
# 作業後の不要ファイルクリーンアップ
git status --short --untracked && git clean -fd --dry-run
2-3. タスク完了のルール¶
- コマンド実行 → 成果物確認 → TodoWriteで
completedへ変更 - Planツールのステータスも即座に同期
- 未追跡ファイル確認 (
git status --short --untracked) を習慣化
ステップ3: レポート化と振り返り¶
3-1. レポートのまとめ方¶
- 週次メモを専用ディレクトリ配下にMarkdownで保存
- 伸長クエリと改善施策を1対1で紐づけることで、次週の優先順位が明確になります
3-2. 振り返りの進め方¶
- TodoWriteの完了タスクに所感を追記（例: CTR変化、再検証タイミング）
- Slackやノーションなど他ツールへ転記する際は、TodoWriteのJSONを参照
高度な設定（クリックで展開）
- Claude Code Hooksを使うと、TodoWriteが`completed`になったタイミングで自動的にログを追記できます - 完了タスクをログファイルに自動追記する補助スクリプトをHooksに登録すると便利ですよくあるつまずきと対処法¶
| 症状 | 原因 | 対処策 |
|---|---|---|
| TodoWriteのステータスがPlanとずれる | 手動更新を忘れている | タスク着手時にPlanをin_progressへ、完了時に同時更新 |
| 伸長クエリの採用基準がぶれる | 判断基準をメモしていない | 週次レポートのディレクトリに基準メモを残し再利用 |
| 未追跡ファイルが残る | cleanupを後回しにしている | ステップ2-2のスクリプトをテンプレ化し、毎回実行 |
次のステップ¶
- TodoWriteテンプレをチームメンバーと共有し、週次レビューを共通フォーマット化する
claude code todowriteに関連する派生クエリを調査し、必要なコンテンツを追加- 完了タスクをベースに英語版ガイドを作成し、海外ユーザーのニーズにも応える