Communitygithub.com

AY修正

AIコーディングエージェント向けの、人間が承認した小規模なワークフロー。

AY修正 とは?

AY修正(AY Fix)は、AIコーディングエージェント(Claude Code、Cursor、Codexなど)が人間の開発者と共にバグ修正や変更を行う際の、厳格かつ効率的なワークフローを定義します。このスキルは、まず問題の原因を証拠に基づいて特定すること(診断)、その上で最も狭い範囲で承認を得た修正のみを実施することを徹底します。主な特徴は「承認契約」にあり、エージェントはユーザーの明示的な許可なしにファイル変更や外部アクションを行わず、調査と提案に留まります。修正範囲が一意で可逆的な場合を除き、エージェントは修正提案をユーザーに提示し承認を待ちます。ワークフローは「診断→修正範囲の決定→修正と証明」の3段階で構成され、修正後は再現テストと回帰チェックを実施し、原因と証拠を報告します。これにより、AIエージェントによる推測や過剰な編集を防ぎ、信頼性の高い修正を実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add ALVIN-YANG/ay-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AY修正 は何をしますか?

原因を証明し、再発を防ぐ最小限の承認された修正を行います。

承認契約

  • 完全なリクエストを読み、ユーザーに質問する前に発見可能な事実を調査してください。
  • レビュー、診断、説明、計画は、ユーザーが変更を要求しない限り読み取り専用として扱ってください。
  • 対象、観察可能な結果、受け入れ境界が明確な場合、正確な指示を承認として扱います。
  • 広範な成果は調査を許可しますが、エージェントが発明しなければならない選択に基づくファイルや成果物の変更は許可しません。
  • 実質的に不十分に指定された変更については、推奨する提案を1つ提示し、承認を待ちます。
  • 承認後は、承認された境界内で自律的に実行し、通常の実装の詳細について質問しないでください。
  • 新しい証拠が動作、アーキテクチャ、データ契約、依存関係、スコープ、リスク、コスト、ロールバック、または外部アクションを変更する場合にのみ、承認を再開してください。
  • 外部アクションは、リクエストまたは承認された提案に含まれている場合にのみ実行してください。不可逆的なアクションの前に正確な対象を確認してください。
  • 無関係な作業やユーザー作成の作業を保持してください。完了を主張する前に、実際に要求された成果を確認してください。

診断

  1. 正確な症状、期待される動作、環境、および障害レイヤーを取得します。
  2. 利用可能な最も近いパスで再現するか、欠落している再現条件に名前を付けます。
  3. 悪い出力から最も初期の誤った状態まで逆方向にトレースします。関連する場合、最近の変更と動作例を読んでください。
  4. 競合する仮説を立て、最小の識別チェックを実行します。観測が欠落している場合は境界を計測してください。
  5. 原因を確認します。もっともらしい兆候、相関関係、または消失した症状は証拠ではありません。

仮説が失敗した後は、別の仮説を試す前に新しい証拠を収集してください。診断の代わりに繰り返し編集しないでください。

修正範囲の決定

ユーザーが診断のみを要求した場合は、確認された原因または次の識別チェックで停止します。

ユーザーが修正を要求した場合、根本原因の修正が一意で、局所的で、可逆的で、意図された動作を保持する場合にのみ、別のチェックポイントなしで進めてください。代替案が製品の動作、アーキテクチャ、データ契約、依存関係、スコープ、外部状態、または重要なリスクを変更する場合は、まず修正提案を提示してください。

修正と証明

下流の症状ではなく、最も狭い責任範囲で原因を修正します。安定した動作の継ぎ目が存在する場合は回帰チェックを追加します。テスト不可能な表面のために中身のないテストを発明しないでください。

元の再現、回帰チェック、および関連する近傍を再実行します。環境、ハーネス、ソース、ビルド、パッケージ、デプロイメント、実際のランタイムの証拠を分離します。原因が証明されていない場合は、そのように述べてください。

原因、識別証拠、修正、証明、および残りの不確実性を報告します。

関連スキル