実装計画・PR・AI実行記録サンプル
文書ID: IMPL-014 / 版: 1.0 / 関連: TASK-014-A〜C / 状態: 記入例・未実施
以下のPR文稿とコマンドは架空案件用です。ソースコードを実装・ビルドしたという記録ではありません。
工程定義
- 目的: 設計をレビュー可能で再現できる変更差分にする。
- 入力: 詳細設計、タスク、リポジトリ、許可された実行環境。
- AIの作業: コードと仕様を更新し、検査・修正後にPRと実行履歴を作成。
- 成果物: 実装差分、PR、ビルド手順、AI実行ログ、レビュー記録。
- 完了条件: 必要な検査を実施し、コードオーナーが差分をレビュー。未実施の検査を明示。
1. 変更計画
対象ファイル例: src/approval/service.ts、src/approval/routes.ts、migrations/014_approval.sql、tests/approval.test.ts。
順序: 権限・自己承認判定 → DB排他・監査保存 → API → UI → 回帰検証。関係のない機能のリファクタリングは別タスクにする。
2. AIへの作業指示例
「REQ-014〜016とDESIGN-014を入力として、TASK-014-A〜Cを実装してください。API-014のステータスとエラー契約を維持してください。本人性は検証済み認証から取得してください。受入条件に矛盾がある場合は質問事項を記録し停止してください。テストの期待値を実装に合わせて変更せず、失敗原因と変更理由を残してください。自動修正は3回で停止し、差分と未解決事項を返してください。」
3. PR文稿例
タイトル
経費申請の自己承認を拒否し、承認と監査記録を一体保存する
問題と変更
REQ-014では自己承認を許可しない。承認APIで実行者と申請者を照合し、本人の場合は403 SELF_APPROVALを返す。別の承認者による正常操作では、状態更新と監査記録を同一トランザクションにまとめる。
検証計画
自己承認、権限不足、正常承認、再送、監査保存失敗を検証する。実際の実行結果とログ参照は実行後に追記する。
影響と切戻し
承認APIと関連画面が対象。新規監査テーブルを追加。切戻し時は前版アプリへ戻し、監査データは保持する。移行・復旧演習の結果は第8工程に添付。
4. 再現可能なビルド記録
| 項目 | 記入例・記入欄 |
|---|---|
| 対象コミット | {{COMMIT_SHA}}（未登録） |
| ランタイム・依存版 | {{RUNTIME_VERSION}}、ロックファイルの版を固定 |
| 環境 | 隔離された検証環境、テスト用認証情報 |
| コマンド例 | npm ci → npm run lint → npm test → npm run build |
| 前提 | 上記スクリプトを持つ案件の例。実リポジトリのコマンドへ変更 |
| 実行日時・終了コード | 未実施 |
| ビルド成果物・ハッシュ | 未生成 |
5. AI実行・レビュー記録
| 実行ID | モデル・設定 | 入力版 | 試行回数 | 結果・費用 | 証跡 |
|---|---|---|---|---|---|
| RUN-014 | {{MODEL_CONFIG}} | DESIGN-014 v1.0 | 未実施 | 未計測 | 未登録 |
指摘ID: REVIEW-014 / 観点: 認証、自己承認、排他、ロールバック、依存関係 / 担当: {{TECH_OWNER}} / 判定: 未レビュー
自社用変更欄
{{REPOSITORY}}、{{BUILD_COMMANDS}}、{{ALLOWED_PATHS}}、{{RUN_LIMITS}}、{{REVIEW_POLICY}}を記入。作業ログに秘密情報を残さず、入力資料の利用範囲を自社規程で決める。