Skip to content

dotnet azure lessons_ja

Kazushi Kamegawa edited this page Nov 11, 2026 · 4 revisions

.NET / Azure 教訓プラグイン

English

概要

この端末の Codex 履歴と、既存の複数端末での調査結果をもとに dotnet-azure-lessons プラグインを改善します。11 個のスキルと読み取り専用レビューエージェントを維持し、重複や適用範囲の広すぎる指示を整理して、実例から確認できる不足を追加します。

追跡

種別 Issue
親 Issue #107
子 Issue #108
子 Issue #109
子 Issue #110
子 Issue #111
Pull request PR #112

背景

既存プラグインは、.NET、Azure、PowerShell、エージェントセッションで繰り返し受けた訂正を既にまとめています。今回、証拠や依頼範囲を超えて単一の行動を要求するルールと、プロファイル移行や資格情報の診断に関する実務上の教訓を明確に扱えていない箇所が見つかりました。

この端末の履歴には、ユーザー環境プロファイルの変更を候補領域で準備・検証してから切り替え、変更の管理対象外にあるデータを保護し、部分失敗から復旧するパターンが記録されています。また、CI の成功と、未実行の移行手順を区別する必要性も確認できます。PR レビューでは、投稿前に更新後の head と既存の議論を確認し、指摘を再検証していました。この事例は head 更新を確認する手順を支持しますが、以前の指摘が誤っていた証拠ではありません。元セッションの識別情報や非公開パスはローカルにとどめます。

設計

  • 11 個のスキルとレビューエージェントを維持します。重複する体験談、完了時の繰り返し文、隣接するスキルが所有する手順を削除します。自明でないルールには簡潔な確認方法と理由を残します。
  • 依頼範囲、許可、環境、例外を明確にします。ルール単独で外部更新、インストール、資格情報の初期化、設定変更、無関係な UI 操作を許可しません。コマンドの先頭一致に関する助言は、現在のセッションに該当ポリシーがある場合に限ります。
  • 過去のレビューを投稿する前に現在の PR head と既存コメントを確認すること、CLI 認証を Git 資格情報ヘルパーと分けて診断すること、環境・プロファイルの更新を切替前に準備・検証し、管理外データを保護して部分失敗からの復旧を定義すること、PowerShell ソースと生成ファイルのエンコーディング要件を区別することを追加します。
  • 固定的な受け入れ条件を作業に応じて絞ります。デバッグでの再現と修正後の受け入れ確認を区別し、実行できないプラットフォーム試験やスクリーンショットは証拠の不足として報告します。安全なパッケージビルドと資格情報を使う公開を区別し、インストールや UI 操作は適切な許可済み環境で行います。
  • 実証された不具合を防ぐ技術的詳細を維持します。共通ルールの所有先を一つにし、技術的な意味を変える際は実装または権威ある資料で確認し、ルールの見出し名で相互参照します。
  • レビューエージェントはステージ済み・未ステージの変更も確認し、実際に直すべき問題と証拠不足を分けて報告し、読み取り専用を維持します。

実装フェーズ

  1. 11 個のスキルとレビューエージェントを監査し、繰り返しの理由や完了時の定型文を整理します。許可、証拠、環境に関する境界を改めます。
  2. PR 運用、環境・プロファイル更新、CLI 認証、PowerShell エンコーディングに履歴に基づく指針を追加します。共有する検証・確認手順を一元化します。
  3. レビューエージェントのスキル選択と報告基準を更新し、スキル名、マニフェスト、適用条件の整合性を保ちます。
  4. 最終的なスキルの動作に合わせて英語・日本語の計画書とリポジトリ文書を更新します。

検証

  • マーケットプレースのマニフェスト、frontmatter、スキル名、相対リンクを検証し、最終差分と日英の整合性を確認します。
  • プラグイン内に非公開の識別情報や秘密情報がないか検索します。元セッションの抜粋は公開しません。
  • head が変わった PR、認証失敗、拒否された操作、ステージ済みファイル、環境更新の部分失敗、プラットフォーム検証ができない状況を読み取り専用で評価します。文面の一致ではなく判断と副作用を確認します。
  • 静的検証、シナリオ評価、実クライアントでのスキル選択を分けて報告します。実際に観測していないクライアントの起動やプラットフォーム上の実行を確認済みと報告しません。

Clone this wiki locally