dzianissokalau/roadmap-delivery-skill

roadmap-delivery-skill は何をしますか？

AIコーディングエージェントのためのファイルベースのワークフローレイヤー。ロードマップフェーズを一つずつ提供し、永続状態を検証し、進捗前に新たなレビューを要求し、リスクの高いアクションを明示的な人間の承認下に置きます。

概要

このスキルは、AIエージェントがプロジェクトのロードマップを安全かつ段階的に実行するためのメカニズムを提供します。各フェーズの完了後、状態がファイルに保存され、次のフェーズに進むためには人間のレビューが必要です。これにより、エージェントの自動的な進行を防ぎ、プロジェクト全体の制御を維持します。

主な機能

• フェーズベースの進行: ロードマップは複数のフェーズに分割され、各フェーズは一つずつ実行されます。
• 永続状態の検証: 各フェーズの完了時に、状態がファイルに保存され、整合性が検証されます。
• 人間のレビュー: 次のフェーズに進む前に、エージェントは新たな人間のレビューを要求します。
• リスクアクションの承認: ファイルの変更やコマンド実行などのリスクの高いアクションは、明示的な人間の承認を得た後にのみ実行されます。

使用方法

1. ロードマップの定義: プロジェクトのロードマップをフェーズごとに定義します。各フェーズには、目的とタスクが含まれます。
2. フェーズの実行: AIエージェントが現在のフェーズを実行し、完了後に状態をファイルに保存します。
3. レビューと承認: 次のフェーズに進む前に、人間が現在の状態をレビューし、承認します。
4. リスクアクションの承認: リスクの高いアクションが発生した場合、エージェントは人間の承認を待ちます。

サポートされるプラットフォーム

• Claude Code
• Cursor
• Codex
• その他のAIコーディングエージェント

構成

ロードマップはYAMLまたはJSONファイルで定義されます。以下は例です：

phases:
  - name: "フェーズ1: 設計"
    tasks:
      - "要件分析"
      - "アーキテクチャ設計"
  - name: "フェーズ2: 実装"
    tasks:
      - "コア機能の実装"
      - "テスト"

注意事項

• 状態ファイルは .roadmap-state.json などに保存されます。
• エージェントは状態ファイルを読み取り、現在のフェーズを把握します。
• 人間のレビューは必須であり、スキップすることはできません。