todo-add

name	todo-add
description	Add a new TODO task via natural language chat. AI structures the input into a task file and places it in inbox/. Asks follow-up questions via AskUserQuestion only when context is insufficient for planning. Use when user says "TODO追加", "タスク追加", "todo-add", "やること追加", "〇〇して", "〇〇追加して", or wants to add a task to the auto-todo system.
argument-hint	<自然言語でやりたいことを伝える>
allowed-tools	Read, Write, Glob, Grep, AskUserQuestion, Bash(mkdir *)

TODO 追加

ユーザーが自然言語で伝えたタスクを構造化し、inbox/ にタスクファイルを作成する。

入力

$ARGUMENTS — ユーザーが自然言語で伝えたタスク内容

処理フロー

Step 1: config.yaml を読み込む

${CLAUDE_PLUGIN_ROOT}/data/config.yaml を Read する。存在しなければ初期化:

version: 1
projects: {}
auto_execute_labels: [docs, lint, format, safe]
notification:
  local: true
  slack_webhook: ""

ディレクトリ ${CLAUDE_PLUGIN_ROOT}/data/{inbox,planned,approved,executing,done,failed,logs} が存在しなければ作成する。

Step 2: ユーザー入力を分析

$ARGUMENTS から以下を抽出・推定する:

• what: やりたいことの1行要約
• where: プロジェクト名（config.projects のキーと照合）。不明なら null
• context: 背景情報・制約・詳細

Step 3: 情報の十分性を判断

以下のいずれかに該当する場合、情報が不十分と判断して AskUserQuestion で深堀りする:

• what が曖昧: 対象モジュール/ファイル/機能が特定できない（例: 「キャッシュ追加して」→ どのサービス？）
• where が不明: プロジェクトが特定できず、推定もできない
• コード変更を伴うが context がない: 実装方針や制約が全くない

以下の場合は深堀り不要:

• what, where, context が十分に具体的
• docs, lint, format などの定型タスク
• ユーザーが十分な情報を1文で伝えている

深堀りは AskUserQuestion を使い、最大 3 問まで。質問例:

• 「どのサービス/モジュールが対象ですか？」
• 「技術的な制約や方針はありますか？」
• 「このプロジェクトのパスを教えてください」（where 不明時）

Step 4: where のプロジェクト名解決

• config.projects にキーが存在する → そのまま使用
• 存在しない → AskUserQuestion でパスを確認し、config.projects に自動登録
• プロジェクトなしのタスク → where: null

Step 5: ID 生成

T-YYYYMMDD-NNN 形式で ID を生成する。NNN は当日の既存タスクの最大値 + 1。 既存の inbox/, planned/, approved/, executing/, done/, failed/ を走査して重複を避ける。

Step 6: labels 自動付与

context と what の内容から以下のラベルを自動付与:

• コード変更 → [backend], [frontend], [api] 等
• ドキュメント → [docs]
• テスト → [testing]
• CI/CD → [ci]
• リファクタリング → [refactor]
• バグ修正 → [bugfix]
• リンター/フォーマッター → [lint], [format]

Step 7: タスクファイル作成

${CLAUDE_PLUGIN_ROOT}/data/inbox/T-YYYYMMDD-NNN.md を作成:

---
id: T-YYYYMMDD-NNN
what: <1行要約>
where: <プロジェクト名 or null>
labels: [<自動付与ラベル>]
created_at: <ISO 8601>
---

<context: 背景情報・制約・詳細>

Step 8: 結果をユーザーに報告

作成したタスクの内容をユーザーに表示する:

inbox/T-20260323-001.md を作成しました:
  what: UserService にキャッシュ層を追加
  where: kondate
  labels: [backend, performance]