AgentSkillsCN

apd-execute

当用户提出“启动实施”“启动第三阶段”“执行合约”“implement the code”“実装を開始”“Phase 3 を開始”，或希望根据已批准的合约自主实施代码时，应使用此技能。系统将自动委派给 apd-peer-review 和 apd-checkpoint 代理完成相关工作。

SKILL.md
--- frontmatter
name: apd-execute
description: >
  This skill should be used when the user asks to "start implementation",
  "start Phase 3", "execute the contract", "implement the code",
  "実装を開始", "Phase 3を開始", or wants to autonomously implement
  code based on the approved Contract. Delegates to apd-peer-review
  and apd-checkpoint agents automatically.
tools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash"]

APD Phase 3: Execute — 実装の自律実行

APDフレームワークにおけるリーダーエージェントとして、Phase 3: Executeを管理する。

Phase 3は「AIの時間」である。Contractに基づきAIが自律で実装・テストを行い、AIチェックポイントを経て、Human Checkpoint 3（軽量）で承認を得る。

事前準備

以下のファイルを全て読み込む:

  1. •CLAUDE.md — プロジェクト設定（技術スタック、コーディング規約、テスト戦略）
  2. •contract/ の最新Contractファイル — タスク分解、インターフェース定義、テスト戦略
  3. •specs/*.yaml — 承認済みSpecファイル全て
  4. •decisions/*.yaml — Decision Records全て
  5. •アクティブサイクル — cycles/ の最新ファイル

Step 1: 実装タスクの実行

Contractの実装タスク分解に従い、各タスクを実行する。

各タスクの実行ルール

  1. •対応するSpec IDの受け入れ条件（AC）を確認する
  2. •Contractのインターフェース定義に厳密に従う（勝手に変更しない）
  3. •CLAUDE.mdのコーディング規約に従う
  4. •他コンテキストの実装に直接依存しない（スタブ/モックで独立性を確保）
  5. •テストを書いてから実装する（TDD推奨だが必須ではない）
  6. •受け入れ条件の全項目に対応するテストを作成する
  7. •全テストがパスすることを確認する

進捗管理

TodoWriteツールを使って各タスクの進捗を管理する。

判断のエスカレーション

実装中に判断が必要になった場合:

  1. •CLAUDE.mdに明記されている → それに従う
  2. •CLAUDE.mdに書かれていない → リーダーエージェント（自分自身）が判断する
  3. •自分が判断できない → Human Checkpointにエスカレーション

CLAUDE.mdのエスカレーションポリシーに該当する場合は必ず人間にエスカレーションする。

Step 2: ピアレビュー

各コンテキストの実装が完了したら、apd-peer-review エージェントに委譲してクロスコンテキストレビューを実行する。

委譲時に以下を伝える:

  • •レビュー対象のコンテキスト/タスクID
  • •関連するSpecファイル
  • •Contractのインターフェース定義

ピアレビューの結果:

  • •verdict: approve → 次のタスクまたはStep 3へ
  • •verdict: request_changes → 指摘事項を修正して再レビュー

Step 3: 結合検証

全タスク完了後:

  1. •コンテキスト間のインターフェースが正しく接続されているか検証
  2. •specs/_cross-context-scenarios.yaml の各シナリオを実行（存在する場合）
  3. •統合テスト / E2Eテストを実行
  4. •全テストがパスすることを確認

Step 4: AIチェックポイント

全タスクとピアレビューが完了したら、apd-checkpoint エージェントに委譲して最終品質検証を実行する。

委譲時に以下を伝える:

  • •レビュー対象フェーズ: execute
  • •実装コードのディレクトリ: src/
  • •テストコードのディレクトリ: tests/
  • •Contractファイルパス
  • •Specsディレクトリパス

apd-checkpoint エージェントが以下を検証する:

  • •Contract全要件の実装状況
  • •テスト全パス
  • •テスト品質（AC網羅、実質的アサーション、エラーケース）
  • •コーディング規約準拠
  • •インターフェース定義準拠

チェックポイント結果の処理

apd-checkpoint エージェントの結果を受け取ったら:

  • •verdict: approve → Human Checkpoint 3を提示
  • •verdict: request_changes → 指摘事項を修正して再度チェックポイントを実行

Human Checkpoint 3（軽量）

AIチェックポイントの結果サマリー（human_checkpoint_summary）を提示する。

  • • 全テストがパスしているか
  • • AI Checkpoint レビューの全項目が pass か
  • • escalation_items がある場合、各項目について判断を記入したか
  • • モック/UI記述がある場合、期待通りの見た目か（目視確認）

承認されたら「サイクル完了です」と報告する。 差し戻しの場合は新しいバグ修正サイクル（/apd-cycle）として対応する。