taika-izumi

pre-action-review

"不可逆操作や重要な変更の前に、実行内容のサマリーとリスク評価をユーザーに提示する。リスクレベルに応じてログのみ・サマリー表示・承認必須を切り替える。"

taika-izumi 0 Updated 4mo ago
GitHub

Install

npx skillscat add taika-izumi/ai-driven-dev-principles/pre-action-review

Install via the SkillsCat registry.

SKILL.md

pre-action-review

不可逆操作や重要な変更の前に、実行内容のリスクを評価し、適切なレベルの確認をユーザーに提示するスキル。

いつ使うか

以下の操作を実行する前にこのスキルを呼び出す:

  • ファイルの削除
  • 外部サービスへの書き込み
  • デプロイ操作
  • 不可逆な設定変更
  • 大規模なファイル変更(多数のファイルを一度に変更する場合)
  • 設計上の重要な分岐点で判断を行う場合

リスク評価基準

操作を以下の3段階で評価する:

低リスク(Low)

  • 可逆操作(git で元に戻せる変更、ローカルファイルの編集)
  • 定型作業(フォーマット整形、リネーム、コメント修正)
  • 対応: ログのみ。操作を記録するが、ユーザーへの確認は不要

中リスク(Medium)

  • 複数ファイルにまたがる変更
  • 外部サービスへの読み取りアクセス
  • 既存の動作に影響しうる変更
  • 対応: サマリー表示。以下の情報をユーザーに提示する
    • 何をしようとしているか
    • 影響を受けるファイル・サービスの一覧
    • 予想される影響

高リスク(High)

  • データの削除(ファイル削除、データベースのレコード削除)
  • デプロイ操作
  • 外部サービスへの書き込み
  • 不可逆な設定変更(環境変数の変更、クラウドリソースの作成・削除)
  • 対応: 承認必須。以下の情報をユーザーに提示し、明示的な承認を得る
    • 何をしようとしているか
    • 影響範囲の詳細
    • リスクの説明
    • ロールバック可能かどうか

レビュー提示フォーマット

リスク評価をユーザーに提示する際は、以下の構造で伝える:

**操作前レビュー**
- 操作: (実行しようとしている操作の説明)
- リスク: Low / Medium / High
- 影響範囲: (影響を受けるファイル、サービス、データの一覧)
- 理由: (なぜこの操作が必要か)

高リスクの場合は追加で:

- ロールバック: (元に戻す手段があるか)
- 承認してよいですか?

フォールバック

タスクの実行中に以下の状況に陥った場合、無理に続行せず撤退する:

  • 同じエラーが3回以上繰り返される
  • 予期しない副作用が発生した
  • 必要な情報やアクセス権が不足している

撤退する場合は以下の情報をユーザーに報告する:

  • 何をしようとしていたか
  • 何が起きたか
  • どこまで完了しているか
  • 推奨される次のアクション

Categories