Communitygithub.com

Gentleman-Programming/gentle-ai-rdd-defect-workflow

トリガー: RDD(レシート駆動開発)、レビュー権限、レシート/系統、修正/リカバリ、デリバリーゲート/キルスイッチ、境界レビュー不具合。作業をガイドします。

gentle-ai-rdd-defect-workflow とは?

このスキルは、ソフトウェア開発における不具合修正ワークフローを厳格に管理するために設計されています。特にClaude CodeやCursorなどのAIエージェントが、RDD(レシート駆動開発)モード下で不具合修正を安全かつ正確に実行できるよう、トリガー条件、ハードルール、意思決定ゲート、実行手順を定義しています。主な特徴として、レビュー証拠はあくまでレビュー専用とし、通常のコミット・プッシュ・PR・リリース権限はリポジトリポリシーに従うこと、承認済みIssueとクリーンなmainブランチでの再現が必須であること、因果的不変条件ごとに独立したIssueとPRを使用すること、オペレーターフローの完全な棚卸しとベンチマークによる真実の証拠が必要なこと、コード変更量を400行以内に制限することなどが挙げられます。実行はCodeGraphを用いた影響マッピング、専用ワークツリー、振る舞い優先テストの順で進め、最終的には読み取り専用の検証を経て判定を出力します。このスキールは、AIエージェントが自律的に不具合修正を行う際の品質保証とガバナンスを強化し、複数のプラットフォーム(Claude Code, Cursor, Codexなど)で利用可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gentleman-Programming/gentle-shell/tree/main/skills/rdd-defect-workflow

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

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

ドキュメント

起動契約

フロントマターのトリガー条件が不具合ワークフローに該当する場合に本スキルをロードします。

このスキルは公開コラボレーションをガイドします。Issueの承認、ラベル付与、レビュー、例外処理、マージ権限は付与しません。

ハードルール

  • レビューおよび「Judgment Day」の証拠はレビューのみに使用されます。Piはデリバリー権限を発行しません。通常のコミット、プッシュ、PR、リリースは、RDDモードに関係なく常にリポジトリポリシーに従います。
  • 実装前に、承認済みIssue(status:approved)とクリーンな現在のmainでの再現が必要です。既存のPRをチェックして、優越または競合がないか確認し、古いクレームは停止または縮小します。
  • 因果的不変条件の単位でグループ化します。独立した不変条件とロールバック境界ごとに、1つのIssueと1つのPR(または明示的なチェーン)を使用します。独立した原因は分割します。優越または競合する権限ラインを決してマージしてはいけません。
  • IssueまたはPRが主張するすべてのオペレーターフロー(エントリ、モード、環境、期待値、否定制御を含む)を棚卸しします。CLIまたはライフサイクルフローごとに、1つの真実のブラックボックスベンチジャーニー、またはコアベンチがそれを表現できない場合は実際のランタイムE2E証拠が必要です。合成プロキシカバレッジは別のランタイムを証明しません。
  • CodeGraph優先の影響マッピング、専用ワークツリー、振る舞い優先テストを使用します。候補のフリーズ前に、ソースを書き換える正規化を実行します。
  • 編集前に変更を予測します。ハードリミットは追加行+削除行で400行です。超える場合は、チェーンまたはメンテナー承認済みの明示的な例外で停止します。
  • RDDが有効な場合、レビューレシート、系統、修正、リカバリの証拠を正確な候補に紐付けます。境界レビュー不具合は1つの修正トランザクションに留めます。その証拠をデリバリー権限として扱ってはいけません。
  • 公開前に独立した読み取り専用の候補検証が必要です。検証はソースまたは権限を編集できません。調査結果には新しい候補が必要です。
  • コミュニケーションは人間的で証拠に基づいたものにします。リポジトリラベルとワークフローメタデータはメンテナーが所有するものであり、コントリビューターの非難の証拠ではありません。

意思決定ゲート

条件アクション
RDDモードが有効レビュー証拠はレビュー専用のまま。通常のコミット、プッシュ、PR、リリースはリポジトリポリシーに従い、Piのデリバリー権限はなし。
Issueゲートまたは再現に失敗証拠を持って待機、停止、または縮小。
不変条件またはロールバックが独立している独立したIssueと権限PRラインに分離。
コアベンチが適合する/しないベンチジャーニー/実際のランタイムE2E。プロキシは不可。
予測が400行を超える編集前にチェーンまたは承認済み例外。

実行手順

  1. モード、承認、PR競合、現在のmainでの再現を確認します。
  2. 不変条件とロールバックに名前を付けます。ワークツリーを分離します。コード、テスト、証拠、ドキュメント、配布、登録をCodeGraphマッピングします。
  3. フローと制御を棚卸しします。失敗するテストと最小限の修正を追加します。
  4. 正規化し、予算を適用し、テストを実行し、各フローの正確な候補、コマンド、シナリオ、結果を記録します。
  5. フリーズし、読み取り専用で検証し、判定、証拠、および1つの人間的な次のアクションを提供します。

出力契約

rdd_mode、issue_pr、causal_invariant、operator_flows、journey_runtime_evidence、changed_line_budget、tests、rollback、unresolved_authority_decisionsを返します。

承認済みおよび優越/競合している権限ラインを特定します。すべてのフロー、否定制御、候補に紐付いた証拠、追加行+削除行およびチェーン/例外、テスト結果、独立したロールバック、未解決のメンテナー決定を含めます。

参照

サポートファイルはありません。現在のリポジトリポリシーが権威を持ちます。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

関連スキル