Share
Embed
Transcript
18 slides
-
本日の内容 ― CDKにおけるハーネスについて ハーネスエンジニアリング AIが「正しく動き続ける環境」を設計する ― 明日から使えそうな実践知 ― タイトルの問いに対する今の私のアンサー コンテキストエンジニアリング
AIに「いつ何を見せるか」を設計する ※開発ツールはKiro前提 プロンプトエンジニアリング AIに「どう聞くか」を設計する -
自己紹介 • 所属:株式会社HBA • 名前:飯田 壮一 • CDK歴:1年未満の初心者 • 好きなサービス:Amazon
Bedrock AgentCore • 座右の銘(?):登壇駆動学習(為さねば成らぬの精神) -
01 ― Intro:Harness 4 Quadrants ハーネスの構成要素 構成要素 用途 補足 AGENTS.md
プロジェクト全体の指示書 セッションが開始されるたびに必ず読まれる Steering パス別のコーディング規約、守るべきルール Skills 再利用可能なワークフロー(手順書) Agents ドメイン特化の専門エージェント Hooks イベント駆動の自動実行 Memory エージェントの行動履歴 例:PreToolUse/PostToolUse/AgentStop -
01 ― Intro:Harness 4 Quadrants ハーネスを整理する4象限 ハーネスの設計パターンは2軸、4象限で整理できます Guides(知識の事前注入) 能力の事前拡張 方針・規約の事前注入
Agency(能力拡張) Control(制御・検証) 実行時フィードバック Sensor(実行時の検知) 結果の検証・観測 -
02 ― Practice:Harness for AWS CDK 02 実践:CDKにおけるハーネス実装例 CDKにおけるハーネス実装例として、 Kiro
Powers / TDD Guide / Quality Gate / Retrospective を紹介します。 -
02 ― Practice:Harness for AWS CDK ハーネスの全体像 Guides(知識の事前注入) 能力の事前拡張 方針・規約の事前注入
Kiro Powers TDD Guide Agency(能力拡張) Control(制御・検証) 実行時フィードバック 結果の検証・観測 Retrospective Quality Gate Sensor(実行時の検知) すべての象限をバランスよく設計することが大事 -
02 ― Practice:Harness for AWS CDK Kiro Powers / Quality
Gate Agency × Guide Control × Sensors Kiro Powers Quality Gate Build AWS infrastructure with CDK and Cloud Formation Hooksによる確実な検証で水際対策 • 最新ドキュメント、コードサンプル検索 • Format / Lint / 型チェック • ベストプラクティス適用 • cdk-nag によるセキュリティ検証 • テンプレート検証、トラブルシューティング • synth によるテンプレート生成確認 • 内部的にawslabs.aws-iac-mcp-server連携 • 失敗したら自己修復 -
02 ― Practice:Harness for AWS CDK Appendix. cdk-nag v3 cdk-nag
v3がリリースされ、登録方法や抑制の書き方が大きく変わりました。 現状のaws-iac-mcp-serverはv2の書き方を返してくるので、v3を利用する場合はエージェントに教える必要がある。 https://github.com/cdklabs/cdk-nag/blob/main/MIGRATION.md -
02 ― Practice:Harness for AWS CDK TDD Guide Control ×
Sensors TDD Guide TDDでAIの自由度を制約する • テスト駆動とHITL(人間レビュー)で曖昧さを検証可能にする • 「文法は正しいが意図と違う」というCDK特有の問題に直接効く • KiroのSpec駆動との相性が良い -
02 ― Practice:Harness for AWS CDK Retrospective Agency × Sensors
Retrospective 検知した学びを、次の能力へ 過去の SESSION_LOG.md/ ADRを検索 今回のセッションで 発生した問題を分析 再発パターンを検出 steering更新を提案 /ADR・ログに記録 -
03 ― Summary ファイル構成例 <ワークスペース> <グローバル> アーキテクチャ決定レコード格納(WHY, WHY NOT) Kiro
Powers ファイル書き込み後に Format/Lint/型チェック を自動実行 手動トリガーで全品質チェックを実行 セッション終了時に振り返り分析(セッションログ、ADR記録) lib/ 書き込み前にテスト先行を強制 test/ 書き込み前にCDK単体テストスキルのアクティベート test/ 書き込み後にテスト仕様の HITL レビューを要求 セッションログ CDK単体テストスキル スキル本体: 判断フロー・3種テストの使い分けガイドライン メインルール: TDD開発フロー・禁止事項・品質ルール -
03 ― Summary 実行の流れ① テスト失敗(RED)を確認 CDK単体テストスキルをアクティブ化 テスト実装後に Format/Lint/型チェック Kiro Powerをアクティブ化
Kiro Powerを使って設計 ・ドキュメント検索 ・サンプルコード検索 ・ベストプラクティス取得 テスト仕様のレビュー承認依頼 テスト駆動で開始 ①RED: テストを先に実装する ②HITL: テスト仕様の人間レビュー ③GREEN: 実装してテストする