| name | todo-scan |
| description | Manually trigger scan+plan for inbox tasks. Analyzes codebases and generates execution plans, then moves tasks from inbox/ to planned/. Use when user says "スキャン", "scan", "todo-scan", "計画立てて", "タスクを分析", or wants to manually trigger task planning.
|
| allowed-tools | Read, Write, Glob, Grep, Bash(mv *), Bash(git status *), Bash(git log *), Bash(git diff *), Bash(ls *), Agent |
TODO スキャン & 計画生成
inbox/ のタスクを分析し、実行計画を生成して planned/ に移動する。
処理フロー
Step 1: config と inbox/ の読み込み
${CLAUDE_PLUGIN_ROOT}/data/config.yaml を Read${CLAUDE_PLUGIN_ROOT}/data/inbox/ 内の *.md ファイルを一覧
inbox/ が空なら「inbox にタスクがありません」と報告して終了。
Step 2: 各タスクの計画生成
各 inbox タスクについて:
-
frontmatter の where からプロジェクトパスを解決（config.projects）
-
where != null の場合:
a. プロジェクトディレクトリの存在確認
b. 存在しなければスキップ（通知で警告）
c. プロジェクトの構造を分析:
- ディレクトリ構造（Glob）
- 関連ファイルの特定（Grep で what/context のキーワード検索）
- git status / git log で最近の変更状況
d. 以下を判定:
- risk: low / medium / high
- low: docs のみ、設定変更、コメント修正
- medium: 新規ファイル追加、既存ファイル修正
- high: コアロジック変更、削除を伴う、複数モジュールにまたがる
- estimated_complexity: S / M / L
-
where == null の場合:
- CWD を基準に分析
- risk は context から推定
-
タスクファイルに「実行計画」セクションを追記:
## 実行計画
### 変更対象ファイル
| ファイル | 変更内容 |
|---------|---------|
| path/to/file.ts | 修正: 〇〇 |
### 実装方針
1. ...
2. ...
### テスト戦略
- ...
### リスク
- ...
-
frontmatter に追記:
risk: <low|medium|high>planned_at: <ISO 8601>
-
ファイルを inbox/ → planned/ に移動
Step 3: 自動実行判定
各 planned タスクについて:
- labels ∩ config.auto_execute_labels ≠ ∅ AND risk == low
→
planned/ → approved/ に移動（自動承認）
→ ユーザーに通知: "T-XXX は低リスクのため自動承認しました"
Step 4: 結果報告
scan 完了:
計画生成: 2 件
- T-001: UserService にキャッシュ層を追加 → planned/ (承認待ち)
- T-002: README にセットアップ手順を追加 → approved/ (自動承認)
スキップ: 0 件
