analyze-confirm-develop は何をしますか？
コードベース分析、要件整合性確認、明示的な承認、およびスタイル一貫性のある開発のためのエージェントスキル
概要
zxyyang/analyze-confirm-develop は、AIエージェントがコード変更を行う際に、以下の3つの明確なフェーズを経ることを強制するスキルです。
- Analyze: 既存のコードベース、要件、およびプロジェクトスタイルを徹底的に分析する。
- Confirm: 分析結果に基づいて、人間の明示的な承認を得る。
- Develop: 承認後、スタイルに一貫性を持たせて実際のコード変更を実施する。
なぜこのスキルが必要か
AIエージェントは強力ですが、以下の問題を引き起こす可能性があります。
- 既存のコードスタイルやパターンに従わない変更を行う。
- チームの合意なしに大規模なリファクタリングを実施する。
- 変更の影響範囲を完全に理解せずにコードを変更する。
このスキルは、これらの問題を解決するために設計されています。
ワークフロー
フェーズ1: 分析 (Analyze)
- プロジェクトのコードベースをスキャンする。
- 既存のコーディング規約（
.editorconfig,.eslintrc,tsconfig.jsonなど）を読み取る。 - 変更対象となるモジュールのアーキテクチャと依存関係を分析する。
- 分析結果を構造化された要約として出力する。
フェーズ2: 確認 (Confirm)
- 分析結果を人間のレビュー担当者に提示する。
- 変更計画（どのファイルをどのように変更するか）を明示的に示す。
- 変更のリスクと影響を説明する。
- 明示的な承認（
y/yesの入力）を待つ。
フェーズ3: 開発 (Develop)
- 承認された計画に従ってコード変更を実施する。
- 変更中も常にプロジェクトのスタイルガイドに従う。
- 変更後に自動フォーマットとリントを実行する。
- 変更の要約を生成する。
設定
以下の環境変数または設定ファイルを使用して、スキルの動作をカスタマイズできます。
| 変数名 | デフォルト値 | 説明 |
|---|---|---|
ACD_REQUIRE_APPROVAL | true | 変更前に明示的な承認を要求するかどうか |
ACD_STYLE_CHECK_ENABLED | true | スタイルチェックを有効にするかどうか |
ACD_ANALYSIS_DEPTH | deep | 分析の深さ（shallow / deep） |
使用例
# スキルを直接呼び出す
agent run --skill zxyyang/analyze-confirm-develop --input "新しいユーザー認証モジュールを追加する"
# 分析のみを実行
agent run --skill zxyyang/analyze-confirm-develop --phase analyze --input "変更計画を立てたい"
制限事項
- 大規模なモノレポでは分析に時間がかかる場合があります。
- 人間の承認が必要なため、完全に自動化されたCI/CDパイプラインには適していません。
- このスキルは、AIエージェントの出力を検証するものではなく、変更プロセスをガイドするものです。
貢献
バグ報告や機能要望は、GitHubリポジトリのIssueにて受け付けています。
ライセンス
MIT