add-task

ドラフトタスクファイルを作成する

役割

ユーザーのリクエストに完全に一致するドラフトタスクファイルを作成します。

目標

以下の内容を含むタスクファイルを .specs/tasks/draft/ に作成します。

• 明確で実行内容がわかるタイトル（動詞＋具体的な説明）
• 適切な種類の分類（feature/bug/refactor/test/docs/chore/ci）
• 必要に応じた適切な依存関係
• ユーザーの意図を保った有用な説明
• 正しいファイル名

入力

• ユーザー入力：ユーザーが指定したタスクの説明／タイトル（引数として渡されます）
• 対象ディレクトリ：デフォルトは .specs/tasks/draft/

手順

1. ディレクトリ構造を準備する

フォルダー作成スクリプトを実行して、タスクディレクトリを作成し、gitignore を設定します。

bash ${CLAUDE_PLUGIN_ROOT}/scripts/create-folders.sh

これにより、以下が作成されます。

• .specs/tasks/draft/ - 分析待ちの新しいタスク
• .specs/tasks/todo/ - 実装準備が整ったタスク
• .specs/tasks/in-progress/ - 現在作業中のタスク
• .specs/tasks/done/ - 完了したタスク
• .specs/scratchpad/ - 一時作業ファイル（gitignore 対象）
• .specs/analysis/ - タスクの分析
• .specs/reports/ - タスクのレポート

フォールバック：スクリプトが見つからない場合、または別の問題が発生した場合は、手動でフォルダー構造を作成し、.specs/scratchpad/ を .gitignore に追加します。

2. 入力を分析する

1. ユーザーのリクエストを解析します：

   • タスクの主な目的を抽出します
   • 暗示されている種類（bug、feature、task）を特定します
   • このタスクが依存するタスクファイルを一覧にします

2. 曖昧な場合は明確にします（本当に不明確な場合のみ）：

   • バグ修正ですか、それとも新機能ですか？
   • 関連するタスクや依存関係はありますか？（指定されていない場合は、ないものとします）

3. タスクを構成する

1. 実行内容がわかるタイトルを作成します：

   • 動詞で始めます：Add、Fix、Update、Implement、Remove、Refactor
   • 具体的かつ簡潔にします
   • 例：
     • "Add validation to login form"
     • "Fix null pointer in user service"
     • "Implement caching for API responses"

2. 種類を決定します：

   種類	使用するケース
   feature	新しい機能や能力
   bug	何かが壊れている、または正しく動作していない
   refactor	動作を変えずにコードを再構成する
   test	テストを追加または更新する
   docs	ドキュメントのみの変更
   chore	保守作業、依存関係の更新
   ci	CI/CD 設定の変更

4. ファイル名を生成する

1. タスクタイトルから短い名前を作成します：

   • タイトルを小文字にします
   • スペースをハイフンに置き換えます
   • 特殊文字を削除します
   • 簡潔にします（最大3～5語）
   • 例："Add validation to login form" → add-validation-login-form

2. ファイル名を作成します：<short-name>.<issue-type>.md

   • 例：
     • add-validation-login-form.feature.md
     • fix-null-pointer-user-service.bug.md
     • restructure-auth-module.refactor.md
     • add-unit-tests-api.test.md
     • update-readme.docs.md
     • upgrade-dependencies.chore.md
     • add-github-actions.ci.md

3. 一意性を確認します：.specs/tasks/draft/、.specs/tasks/todo/、.specs/tasks/in-progress/、.specs/tasks/done/ に同じ名前のファイルが存在するか確認します

5. タスクファイルを作成する

Write ツールを使用して .specs/tasks/todo/<short-name>.<issue-type>.md を作成します。

---
title: <ACTION-ORIENTED TITLE>
depends_on: <list of task files that this task depends on>
---

## Initial User Prompt

{EXACT user input as provided}

## Description

// Will be filled in future stages by business analyst

制約

• plan スキルを呼び出さないでください - このワークフローで後続のフェーズを処理します
• .specs/tasks/draft/ の外にファイルを作成しないでください
• 既存のタスクファイルを変更しないでください
• 説明を書かないでください。タスクファイルで指定されているとおり、// ... のプレースホルダーのみを記述してください
• 依存関係が指定されていない場合、depends_on セクションを書かないでください

期待される出力

オーケストレーターに以下を返します。

1. タスクファイルのパス：作成したファイルの完全なパス（例：.specs/tasks/todo/add-validation-login-form.feature.md）
2. 生成したタイトル：作成した、実行内容がわかるタイトル
3. Issue の種類：task、bug、または feature

形式：

Created task file: .specs/tasks/draft/<name>.<type>.md
Title: <action-oriented title>
Type: <task|bug|feature>
Depends on: <list of task files that this task depends on>

成功基準

• ディレクトリ .specs/tasks/draft/、.specs/tasks/todo/、.specs/tasks/in-progress/、.specs/tasks/done/ が存在する
• .specs/tasks/draft/ に、正しい命名規則（<name>.<type>.md）に従ったタスクファイルが作成されている
• ファイル名がすべてのステータスフォルダーで一意である（既存のファイルを上書きしない）
• 依存関係が指定されている場合、「Depends」セクションが正しい
• タイトルが動作を表す動詞（Add、Fix、Implement、Update、Remove、Refactor）で始まる
• タイプが正しく分類され、ファイル拡張子（.feature.md、.bug.md、.refactor.md、.test.md、.docs.md、.chore.md、.ci.md）に反映されている
• 「Initial User Prompt」セクションにユーザーの元の入力が保持されている
• 説明が空のプレースホルダー // Will be filled in future stages by business analyst になっている

例

テストタスク（.specs/tasks/draft/add-unit-tests-auth.test.md）：

---
title: Add unit tests for auth module
---

## Initial User Prompt

add tests for auth

## Description

// Will be filled in future stages by business analyst

コンテキスト付きのバグ（.specs/tasks/draft/fix-login-timeout.bug.md）：

---
title: Fix login timeout on slow connections
---

## Initial User Prompt

users getting 504 errors on slow wifi

## Description

// Will be filled in future stages by business analyst

機能リクエスト（.specs/tasks/draft/implement-dark-mode.feature.md）：

---
title: Implement dark mode toggle
---

## Initial User Prompt

add dark mode to settings page

## Description

// Will be filled in future stages by business analyst