AIコーディングエージェントに実行できる仕様を与える方法

コーディングエージェントは成功条件が観測可能なときに力を発揮します。Microsoftのspec-driven developmentでは、意図と受け入れ基準を含むliving specificationをコードとテストに合わせて更新します。

1. 結果を書く

まず利用者と見える動作を説明します。

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. 受け入れ基準

通常経路、空の状態、無効入力、権限、失敗時の動作を含めます。

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. 調査してから計画する

route、component、data access、testを探し、計画と不確実性を示すよう依頼します。既存の契約を守るか確認します。

4. 実行可能にする

version-controlledな文書や更新されるissueに置き、各基準をテストまたは手動確認に結び付けます。

5. 人間の確認点を残す

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. 更新する

仕様は使い捨てのpromptではありません。テストや製品の判断が変わったら更新し、各基準の証拠を確認して完了とします。