Communitygithub.com

Agent Lean Safe Coding(エージェント向け省エネ安全コーディング)

Windows対応で安全なコーディングスキルとプラグインパッケージ。Codex、Claude Code、AIエージェント向け。

Agent Lean Safe Coding(エージェント向け省エネ安全コーディング) とは?

Agent Lean Safe Codingは、AIコーディングエージェントがより小さく、より安全にコードを生成・編集するためのスキルパッケージです。主にWindows環境やテキストが豊富なリポジトリでの編集リスク(エンコーディング、改行、シェル経由のテキスト破損など)を軽減します。lite/full/auditの3つのモードを備え、タスク分類、安全エンベロープ、再利用ラダー、パッチ予算、最小検証という明確な手順でエージェントの行動を制御します。特に、既存コードやプラットフォーム機能の再利用を最優先し、不必要な依存関係や過剰な抽象化を防ぐことで、変更サイズを抑えつつ信頼性を高めます。Codex、Claude Codeなど、SKILL.mdを解釈できる任意のAIエージェントで使用可能です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/agent-lean-safe-coding

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

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

ドキュメント

Agent Lean Safe Coding(エージェント向け省エネ安全コーディング) は何をしますか?

このスキルを使用して、コーディングエージェントをより小さく、より安全に保ちます。必要な動作だけを構築し、既存のものを再利用し、Windowsやテキストリッチなリポジトリを脆弱な編集から保護します。

デフォルトモードは full です。

  • lite: クイックトリアージ、狭いコンテキスト、最小限の安全なパッチ。
  • full: トリアージラダー、Windows/テキスト安全エンベロープ、依存関係チェック、パッチ予算、検証。
  • audit: 編集なし。計画や差分をレビューして、過剰構築、重複ロジック、依存関係リスク、Windows/テキストリスク、弱い検証を確認します。

実行ループ

  1. タスクを分類する。
  2. リスクのあるファイルを安全エンベロープ内に置く。
  3. コードを書く前にトリアージラダーを適用する。
  4. パッチ予算を設定する。
  5. ローカルで編集し、スタイルを維持する。
  6. 最小の目的ゲートを検証する。
  7. 結果を再利用とリスクメモとともに報告する。

1. 分類

編集前にタスクタイプを命名する:

  • bugfix: 共有原因を見つける。ガードを散りばめる前に、兄弟呼び出し元を検査する。
  • feature: 要求された動作がすでにプラットフォーム、フレームワーク、またはリポジトリで提供されているか確認する。
  • refactor: 具体的な単純化またはリスク削減を必要とする。趣味でコードを再配置しないこと。
  • review: 削除、再利用機会、安全でないシェル/テキスト操作、欠落したチェックを指摘する。
  • docs/text: エンコーディング、改行、Markdown構造、および例を保護する。

要求が不明瞭だが、保守的なデフォルトが安全な場合は、そのデフォルトで進め、前提を簡潔に述べること。

2. 安全エンベロープ

以下のいずれかが存在する場合、安全エンベロープを使用する: Windowsパス、PowerShellまたはcmd、非ASCIIテキスト、中国語テキスト、絵文字、Markdown、プロンプト、テンプレート、ローカライゼーションファイル、完全一致置換、不明なエンコーディング、CRLF/LFに依存するファイル、またはソースと誤認される可能性のある生成出力。

エンベロープ内では:

  • 小さな編集にはパッチツールを優先する。
  • 非ASCIIコンテンツをシェルパイプラインやインラインPowerShell文字列に渡さない。
  • フォーマッターがファイルを所有していない限り、既存の改行スタイルを維持する。
  • スクリプトにはパスAPIまたは引用符で囲まれたリテラルパスを使用する。
  • コンソールの文字化けは表示上の証拠としてのみ扱い、書き換え前にバイトまたはUTF-8読み取りを検査する。
  • ユーザーが明示的に要求しない限り、生成フォルダー、依存関係フォルダー、キャッシュ、バイナリ、スクリーンショット、アーカイブを編集しない。

エンコーディング、改行、パス、またはシェル脆弱性のリスクがあるタスクでのみ、references/windows-text-safety.md を読み込むこと。

3. トリアージラダー

カスタムコードの前に、タスクをきれいに解決できる最初のレベルで停止する:

  1. 必要性を除去する: リクエストは既存パスの削除、設定、または文書化で満たせるか?
  2. プロジェクトコードを再利用する: ヘルパー、コンポーネント、フック、バリデーター、テストユーティリティ、コマンド、スキーマ、または確立されたパターン。
  3. 言語または標準ライブラリの動作を使用する。
  4. プラットフォームまたはフレームワークの動作を使用する: ブラウザコントロール、CSS、データベース制約、フレームワークルーティング、バリデーション、キャッシュ、シリアライゼーション、またはビルドツール。
  5. すでにインストールされている依存関係を使用する。
  6. 小さなローカル実装を追加する。
  7. 明確な理由、リスク、および承認の必要性を示してのみ、新しい依存関係または大規模な実装を提案する。

プロダクション依存関係を自動的に追加しないこと。新しい依存関係が正当化されるように見える場合、それが何を置き換えるのか、なぜインストール済みのオプションが適合しないのか、メンテナンスリスク、および正確なインストールコマンドを説明すること。

依存関係/再利用の判断が自明でない場合のみ、references/reuse-ladder.md を読み込むこと。

4. パッチ予算

編集前に、小さな予算を選択する:

  • 変更が予想されるファイル。
  • 意図的に変更しないファイル。
  • 再利用する既存コードまたはプラットフォーム機能。
  • 最小検証コマンド、またはコマンドが有用でない理由。

より少ないファイル、より少ない抽象化、および動作に近い直接的な変更を優先すること。現在のタスクで必要でない限り、インターフェース、ファクトリ、サービスレイヤー、設定スイッチ、将来の拡張ポイント、またはラッパーを追加しないこと。

5. パッチルール

  • 呼び出し元側に繰り返し回避策を追加する代わりに、ルートパスを一度修正する。
  • 動作が正しいままの場合、冗長なコードを削除する。
  • フォーマットの変更を差分に含めない。
  • コメントは稀に保つ。意図的な制限を後で可視化する必要がある場合にのみ、簡潔なコメントを1つ使用する。
  • ショートカットに既知の上限がある場合、その上限とアップグレードトリガーをそのコメント内に記載する。
  • 1つの小さな関数をサブシステムに変えないこと。

6. 検証

変更を証明する最も狭い新鮮なゲートを実行する:

  • 影響を受ける動作の既存テスト。
  • 非自明な新しいロジックに対する集中単体テストまたはセルフチェック。
  • テストが利用できない場合の編集された言語ファイルの構文/型/リンターチェック。
  • ドキュメントのみまたは自明な1行変更に対する差分レビュー。

非自明なブランチ、パーサー、金銭/セキュリティパス、またはデータ損失パスには、実用的な場合に1つの実行可能なチェックが必要。自明な1行変更には新しいテスト基盤は不要。

7. 最終報告

最終報告は短く:

Changed - ...
Triage - reused/stdlib/platform/installed dependency/local code/new dependency proposal
Safety - Windows/text risks handled or not relevant
Verified - command/result or reason
Risks - remaining limit, if any

audit モードの場合、最初にファイル/行参照(可能であれば)とともに所見を返し、次に削除/再利用リストと最小の検証ギャップを返す。

関連スキル