AWESOME-COPILOTのドキュメントを読むその１２２（Spec Driven Workflow v1）

本日はAWESOME-COPILOTの技術調査枠です。
AWESOME-COPILOTのドキュメントを読みながら実際に操作を試して記事に残します。
今回はカスタムインストラクションの一つSpec Driven Workflow v1についてです。

Spec Driven Workflow v1は仕様書を起点に、分析・設計・実装・検証・引き継ぎまで進めるルールです。
プロジェクト全体のすべてのファイル・全ての作業が対象です。
コード生成だけでなく、要件定義、設計書、タスク管理、検証ログ、PR説明までCopilotの行動に影響します。

以下のページからGenaiscriptのインストールボタンをクリックして取得します。
github.com

インストールボタンを押してSpec Driven Workflow v1をダウンロードします。
すると.github/instructions配下にインストラクションがインストールされます。

インストールしたインストラクションはCopilotの動作に自動的に適用されます。
このインストラクションを読み込むと、Copilotは仕様駆動で開発プロセス全体を管理する開発リードとして振る舞います。

具体的にはCopilotは以下のような行動をとります。

本インストラクションを入れると、Copilotは最初にコードを書こうとしません。
最初に以下を整備します。

特に要件は EARS記法で整理されます。

例えば以下のような内容です。

WHEN ユーザーがログインボタンを押したとき、
THE SYSTEM SHALL 認証情報を検証してログイン結果を表示する

つまりCopilotは「ログイン機能の要件・例外・完了条件を明文化してから実装」という動きになります。

Copilot は作業を以下の順番で進めようとします。

ANALYZE
↓
DESIGN
↓
IMPLEMENT
↓
VALIDATE
↓
REFLECT
↓
HANDOFF

以下のような開発ワークフロー型のAIになります。

本インストラクションではCopilotが作業前にConfidence Score（0〜100%）を考えます。
つまり以下のように要件の明確さや複雑さに応じて動き方を変えます。

Copilotは「作業ログを残す」ことを強制します。
各作業では以下のような情報を残します。

さらに重要な判断はDecision Recordとして記録します。

Copilotは実装だけでは完了扱いにしません。
必ず以下を行います。

Copilotは技術的負債を見つけたら記録しようとします。
例えば以下を技術的負債として扱います。

Copilotは以下の作業を行うようになります。

最後のHANDOFFフェーズでは、Copilotは作業結果をレビュー可能な形にまとめます。
以下が分かる状態で引き継げます。

MRが楽しい