zhongwei/gh-classmethod-tsumiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b3ad2e3943afa94a47f828d1bee98922112735c7
gh-classmethod-tsumiki/commands/kairo-implement.md
Zhongwei Li b3ad2e3943 Initial commit
2025-11-29 18:09:29 +08:00

12 KiB
Raw Blame History

description
description
分割されたタスクを順番に、またはユーザが指定したタスクを実装します。既存のTDDコマンドを活用して品質の高い実装を行います。

あなたは実装担当者です。残タスクを調べて 指定されたコマンドを駆使して実装をしてください

kairo-implement

目的

分割されたタスクを順番に、またはユーザが指定したタスクを実装する。既存のTDDコマンドを活用して品質の高い実装を行う。

前提条件

  • docs/tasks/{要件名}-tasks.md にタスク一覧が存在する
  • ユーザがタスクの実装を承認している
  • 既存のTDDコマンドが利用可能である
  • 実装用のワークスペースが設定されている
  • task_id は　TASK-{4桁の数字} (例 TASK-0001 ) である

実行内容

【信頼性レベル指示】: 各項目について、元の資料（EARS要件定義書・設計文書含む）との照合状況を以下の信号でコメントしてください：

  • 🔵 青信号: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
  • 🟡 黄信号: EARS要件定義書・設計文書から妥当な推測の場合
  • 🔴 赤信号: EARS要件定義書・設計文書にない推測の場合

  1. 追加ルールの読み込み

    • docs/rule ディレクトリが存在する場合は読み込み
    • docs/rule/kairo ディレクトリが存在する場合は読み込み
    • docs/rule/kairo/implement ディレクトリが存在する場合は読み込み
    • 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用

  2. 技術スタック定義の読み込み

    • docs/tech-stack.md が存在する場合は読み込み
    • 存在しない場合は CLAUDE.md から技術スタックセクションを読み込み
    • どちらも存在しない場合は .claude/commands/tech-stack.md のデフォルト定義を使用

  3. タスクの選択

    • @agent-symbol-searcher で指定されたタスクID(TASK-0000形式)を検索し、見つかったタスクファイルをReadツールで読み込み
    • ユーザが指定したタスクIDを確認
    • 指定がない場合は、依存関係に基づいて次のタスクを自動選択
    • 選択したタスクの詳細を表示
    • 読み込んだ技術スタック定義に基づいて実装方針を決定

  4. 依存関係の確認

    • @agent-symbol-searcher で依存タスクの状態を検索し、見つかったタスクファイルをReadツールで読み込み
    • 依存タスクが完了しているか確認
    • 未完了の依存タスクがある場合は警告

  5. 実装ディレクトリの準備

    • 現在のワークスペースで作業を行う
    • 必要に応じてディレクトリ構造を確認

  6. 実装タイプの判定

    • タスクの性質を分析（コード実装 vs 準備作業）
    • 実装方式を決定（TDD vs 直接作業）

  7. 実装プロセスの実行

    A. TDDプロセス（コード実装タスク用）

    a. 要件定義 - @task general-purpose /tsumiki:tdd-requirements

    Task実行: TDD要件定義フェーズ
目的: タスクの詳細要件を記述し、受け入れ基準を明確化する
コマンド: /tsumiki:tdd-requirements
実行方式: 個別Task実行

    b. テストケース作成 - @task general-purpose /tsumiki:tdd-testcases

    Task実行: TDDテストケース作成フェーズ
目的: 単体テストケースを作成し、エッジケースを考慮する
コマンド: /tsumiki:tdd-testcases
実行方式: 個別Task実行

    c. テスト実装 - @task general-purpose /tsumiki:tdd-red

    Task実行: TDDレッドフェーズ
目的: 失敗するテストを実装し、テストが失敗することを確認する
コマンド: /tsumiki:tdd-red
実行方式: 個別Task実行

    d. 最小実装 - @task general-purpose /tsumiki:tdd-green

    Task実行: TDDグリーンフェーズ
目的: テストが通る最小限の実装を行い、過度な実装を避ける
コマンド: /tsumiki:tdd-green
実行方式: 個別Task実行

    e. リファクタリング - @task general-purpose /tsumiki:tdd-refactor

    Task実行: TDDリファクタリングフェーズ
目的: コードの品質向上と保守性の改善を行う
コマンド: /tsumiki:tdd-refactor
実行方式: 個別Task実行

    f. 品質確認 - @task general-purpose /tsumiki:tdd-verify-complete

    Task実行: TDD品質確認フェーズ
目的: 実装の完成度を確認し、不足があればc-fを繰り返す
コマンド: /tsumiki:tdd-verify-complete
実行方式: 個別Task実行

    B. 直接作業プロセス（準備作業タスク用）

    a. 準備作業の実行 - @task general-purpose /tsumiki:direct-setup

    Task実行: 直接作業実行フェーズ
目的: ディレクトリ作成、設定ファイル作成、依存関係のインストール、環境設定を行う
作業内容:
- ディレクトリ作成
- 設定ファイル作成
- 依存関係のインストール
- 環境設定
実行方式: 個別Task実行

    b. 作業結果の確認 - @task general-purpose /tsumiki:direct-verify

    Task実行: 直接作業確認フェーズ
目的: 作業完了の検証と成果物確認を行う
作業内容:
- 作業完了の検証
- 期待された成果物の確認
- 次のタスクへの準備状況確認
実行方式: 個別Task実行

  8. タスクの完了処理

    • タスクのステータスを更新（タスクファイルのチェックボックスにチェックを入れる）
    • 実装結果をドキュメント化
    • 次のタスクを提案

実行フロー

flowchart TD
    A[タスク選択] --> B{依存関係OK?}
    B -->|No| C[警告表示]
    B -->|Yes| D[実装開始]
    D --> E{タスクタイプ判定}
    E -->|コード実装| F[TDDプロセス]
    E -->|準備作業| G[直接作業プロセス]

    F --> F1[tdd-requirements]
    F1 --> F2[tdd-testcases]
    F2 --> F3[tdd-red]
    F3 --> F4[tdd-green]
    F4 --> F5[tdd-refactor]
    F5 --> F6[tdd-verify-complete]
    F6 --> F7{品質OK?}
    F7 -->|No| F3
    F7 -->|Yes| H[タスク完了]

    G --> G1[準備作業実行]
    G1 --> G2[作業結果確認]
    G2 --> H

    H --> I{他のタスク?}
    I -->|Yes| A
    I -->|No| J[全タスク完了]

コマンド実行例

# 全タスクを順番に実装
$ claude code kairo-implement --all

# 特定のタスクを実装
$ claude code kairo-implement --task {{task_id}}

# 並行実行可能なタスクを一覧表示
$ claude code kairo-implement --list-parallel

# 現在の進捗を表示
$ claude code kairo-implement --status

実装タイプ判定基準

TDDプロセス（コード実装タスク）

以下の条件に当てはまるタスク：

  • 新しいコンポーネント、サービス、フック等の実装
  • 既存コードの機能追加・修正
  • ビジネスロジックの実装
  • API実装

例: TaskService実装、UIコンポーネント作成、状態管理実装

直接作業プロセス（準備作業タスク）

以下の条件に当てはまるタスク：

  • プロジェクト初期化・環境構築
  • ディレクトリ構造作成
  • 設定ファイル作成・更新
  • 依存関係のインストール
  • ツール設定・設定

例: プロジェクト初期化、データベース設定、開発環境設定

個別Task実行アプローチ

Task実行の方針

各実装ステップを個別のTaskとして実行することで、以下のメリットが得られます：

  1. 独立性: 各ステップが独立して実行され、エラー発生時の切り分けが容易
  2. 再実行性: 特定のステップのみ再実行が可能
  3. 並列性: 依存関係のないステップは並列実行可能
  4. 追跡性: 各ステップの実行状況と結果が明確に記録される

Task実行パターン

# TDDプロセスの場合
@task general-purpose /tsumiki:tdd-requirements
@task general-purpose /tsumiki:tdd-testcases
@task general-purpose /tsumiki:tdd-red
@task general-purpose /tsumiki:tdd-green
@task general-purpose /tsumiki:tdd-refactor
@task general-purpose /tsumiki:tdd-verify-complete

# 直接作業プロセスの場合
@task general-purpose /tsumiki:direct-setup
@task general-purpose /tsumiki:direct-verify

実装時の注意事項

TDDプロセス用

  1. テストファースト

    • 必ずテストを先に書く
    • テストが失敗することを確認してから実装

  2. インクリメンタルな実装

    • 一度に全てを実装しない
    • 小さなステップで進める

  3. 継続的な品質確認

    • 各ステップで品質を確認
    • 技術的負債を作らない

直接作業プロセス用

  1. 作業の段階的実行

    • 依存関係を考慮した順序で実行
    • 各ステップの完了を確認

  2. 設定の検証

    • 作成した設定ファイルの動作確認
    • 環境の正常性チェック

  3. ドキュメントの更新

    • 実装と同時にドキュメントも更新
    • 他の開発者が理解できるように

出力フォーマット

タスク開始時（TDDプロセス）

🚀 タスク {{task_id}}: {{task_name}} の実装を開始します

📋 タスク詳細:
- 要件: REQ-101, REQ-102
- 依存: {{依存タスクID}} ✅
- 推定時間: 4時間
- 実装タイプ: TDDプロセス

🔄 TDDプロセスを開始します...

タスク開始時（直接作業プロセス）

🚀 タスク {{task_id}}: {{task_name}} の実装を開始します

📋 タスク詳細:
- 要件: REQ-402, REQ-006
- 依存: {{依存タスクID}} ✅
- 推定時間: 3時間
- 実装タイプ: 直接作業プロセス

🔧 準備作業を開始します...

各ステップ完了時（TDD）

✅ Task 1/6: @task /tsumiki:tdd-requirements 完了
   ファイル: docs/implements/{要件名}/{{task_id}}/{要件名}-requirements.md
   Task実行結果: 要件定義書作成完了

🏃 Task 2/6: @task /tsumiki:tdd-testcases 実行中...
   Task実行: TDDテストケース作成フェーズを開始

各ステップ完了時（直接作業）

✅ Task 1/2: @task /tsumiki:direct-setup 完了
   作成ファイル: 8個、設定更新: 3個
   Task実行結果: 準備作業実行完了

🏃 Task 2/2: @task /tsumiki:direct-verify 実行中...
   Task実行: 直接作業確認フェーズを開始

タスク完了時（TDD）

🎉 タスク {{task_id}} が完了しました！

✅ タスクファイルのチェックボックスを更新しました
   - [ ] **タスク完了** → [x] **タスク完了**

📊 実装サマリー:
- 実装タイプ: TDDプロセス (個別Task実行)
- 実行Taskステップ: 6個 (全て成功)
- 作成ファイル: 12個
- テストケース: 25個 (全て成功)
- カバレッジ: 95%
- 所要時間: 3時間45分

📝 次の推奨タスク:
- {{次のタスクID}}: {{次のタスク名}}
- {{関連タスクID}}: {{関連タスク名}}（依存関係あり）

続けて実装しますか？ (y/n)

タスク完了時（直接作業）

🎉 タスク {{task_id}} が完了しました！

✅ タスクファイルのチェックボックスを更新しました
   - [ ] **タスク完了** → [x] **タスク完了**

📊 実装サマリー:
- 実装タイプ: 直接作業プロセス (個別Task実行)
- 実行Taskステップ: 2個 (全て成功)
- 作成ファイル: 8個
- 設定更新: 3個
- 環境確認: 正常
- 所要時間: 2時間30分

📝 次の推奨タスク:
- {{次のタスクID}}: {{次のタスク名}}
- {{関連タスクID}}: {{関連タスク名}}（依存関係あり）

続けて実装しますか？ (y/n)

エラーハンドリング

  • 依存タスク未完了: 警告を表示し、確認を求める
  • テスト失敗: 詳細なエラー情報を表示
  • ファイル競合: バックアップを作成してから上書き

実行後の確認

  • 実装したファイルの一覧を表示
  • テスト結果のサマリーを表示
  • 残りのタスクと進捗率を表示
  • 次のタスクの提案を表示
Reference in New Issue View Git Blame Copy Permalink