実装ワークフロー (Implementation Workflow)

/spec で作成されたTODOリストに基づき、順番に実装を進めるスキル。

前提条件

• /spec によりSpec.mdが作成済み
• TodoWriteでタスクが登録済み

Step 0: 初期設定（初回のみ）

実装を開始する前に、AskUserQuestion でreviewとcheckの方法を確認する。

質問1: Review方法

header: "Review"
question: "コードレビューはどのように行いますか？"
options:
  - label: "セルフレビュー（デフォルト）"
    description: "DRY、複雑性、仕様準拠、セキュリティの観点でチェック"
  - label: "/review スキルを使用"
    description: "プロジェクトのreviewスキルを呼び出す"
  - label: "スキップ"
    description: "レビューせずに進める"

質問2: Check方法

header: "Check"
question: "コミット前のチェックコマンドを教えてください"
options:
  - label: "自動検出"
    description: "package.json, Makefile等から検出"
  - label: "npm run lint && npm run test"
    description: "標準的なnpmスクリプト"
  - label: "make check"
    description: "Makefileのcheckターゲット"

ユーザーが「Other」を選んだ場合は、具体的なコマンドを入力してもらう。

ワークフロー

各TODOに対して以下のサイクルを実行:

implement → review → check → commit → next

1. Implement（実装）

• TodoWriteの次のpendingタスクをin_progressに変更
• Spec.mdの該当Acceptance Criteriaを参照
• 必要なコードを実装

2. Review（レビュー）

Step 0で選択された方法に従う:

セルフレビュー（デフォルト）

/review スキル使用

/review スキルを呼び出す。

3. Check（検証）

Step 0で指定されたコマンドを実行。

判断基準:

• エラー → 修正して再実行
• 以下は許容（ただしcommitメッセージに明記）:
  • ハリボテ実装による一時的な失敗
  • TDDのRed状態（テスト先行で実装がまだ）
  • 後続タスクで解決予定のエラー

4. Commit（コミット）

/commit スキルを呼び出してコミット。

Checkでエラーを許容した場合のコミットメッセージ例:

feat(auth): ログイン画面の雛形を追加

WIP: テストは後続タスクで実装予定のため一部失敗

5. Next（次へ）

• 完了したタスクをcompletedに更新
• 次のpendingタスクへ進む
• 全タスク完了まで繰り返す

実行例

/impl

中断・再開

• 途中で中断してもTodoWriteの状態は保持される
• 再度 /impl を呼び出すと、in_progressまたは次のpendingから再開
• 再開時はStep 0の設定を再度確認する

Check コマンドの自動検出（参考）

「自動検出」を選んだ場合の検出元: