DenisSergeevitch/agents-best-practices

Provider-neutral Agent Skill for Codex, Claude Code, and agentic harness design.

何を解決するか

このプロジェクトは、AIモデルを安全で信頼性が高く、本番環境で利用可能な状態にするためのランタイム環境である「エージェントハーネス」を構築するための構造化されたフレームワークとベストプラクティスを提供します。モデルが実世界のシステムで監査されず、安全でないオペレーターにならないように、エージェントに自律性を与えることと、そのリスクを防ぐことの間にある緊張を解消します。

仕組み

プロンプトベースの安全性に頼るのではなく、このプロジェクトはモデルが行動の提案のみを行う一方で、アプリケーションコード（ハーネス）が検証、承認、実行を担当する厳格な制御プレーンを定義しています。以下の参考資料の包括的なライブラリを提供しています：

  • エージェントループ：リトライ、予算（時間、コスト、トークン）、終了ルールの管理。
  • ツールガバナンス：狭く型指定されたツールの使用とリスクベースの権限レベル（例：読み取り、下書き、破壊的書き込みの分離）。
  • コンテキスト管理：リトリーバル、メモリ、自動コンパクションの戦略で、アクティブな状態を維持する。
  • 高度なアーキテクチャ：MVPエージェント、再帰的ハーネス、予測的ツール実行のためのブループリント。
  • 環境適応：未知の環境でツールを安全に発見し、バインドする方法。

対象者

コード作成、研究、サポート、運用、営業、財務、医療など、さまざまな分野でAIエージェントを開発している開発者やアーキテクトで、単なるプロトタイプから本番環境で安全に運用可能なシステムへと進化させたい人。

特徴

  • プロバイダ非依存：OpenAI、Anthropicなど、さまざまなLLMプロバイダで動作可能。
  • リスクベースの権限：自律的な読み取りと承認が必要な書き込みの明確な区別を強制。
  • ハーネス中心の哲学：安全性と信頼性の責任をプロンプトからランタイムコードに移行。
  • 包括的なブループリント：MVP設計、既存ハーネスの監査、長期間の目標実装のための具体的ガイドを含む。
  • エージェントスキル統合：CodexやClaude Codeと互換性のあるポータブル「エージェントスキル」としてパッケージ化。

関連

  • プロジェクト
    HoangNguyen0403/agent-skills-standard

    Agent Skills Standard (AGS) は、NPM経由で配布されるCLIで、開発チームがコーディング規準、セキュリティルール、SDLCワークフローテンプレートを小さなMarkdown「スキル」として公開できます。CLI（`ags init` / `ags sync`）は `.skillsrc` 設定ファイルを作成し、言語固有のスキルパック（20以上のスタックで合計280スキル）をダウンロードし、階層的なルーター（`AGENTS.md → _INDEX.md → SKILL.md`）を生成します。AIコーディングアシスタント（Cursor、Claude Code、Copilot、Geminiなど）はこのルーターを読み、編集中のファイルに該当するルールのみを読み込み、プロンプトトークンを約85％削減します。オプションのMCPサーバーでフックの強制、シークレット漏洩編集のブロック、実行時監査ログの提供が可能です。このプロジェクトは、汎用的なチュートリアルやリストではなく、本格的なAIコーディングアシスタントユーティリティです。

  • プロジェクト
    mohitagw15856/pm-claude-skills

    PM Skills は、Claude、ChatGPT、Gemini などに、賃貸契約書の解読、PRDの作成、給与交渉シミュレーションなど、プロフェッショナルおよびライフマネジメントのタスクを上級者レベルで実行するための、実際の手順を提供する、1 169個の Markdown「エージェントスキル」からなるオープンソースのライブラリです。各スキルは、フレームワーク、テンプレート、チェック項目、および避けるべきパターンを含むシンプルな Markdown ファイルです。1行の `npx` コマンドでインストールでき、Claude Code ではネイティブに使用可能。他のエージェントにはプロンプトとして貼り付けることもできます。リポジトリには npm/PyPI パッケージ、Docker イメージ、および Telegram、Slack、Raycast、Obsidian、n8n などの統合も提供されています。ウェブプレイグラウンドでは、インストール不要でブラウザ上でスキルを実行できます。

  • プロジェクト
    shareAI-lab/learn-claude-code

    17レッスンからなるチュートリアルで、LLMベースのコーディングエージェント（Claude）の周囲の「ハarness」コードを構築する方法を学びます。ツールの追加、権限、コンテキスト管理、メモリ、タスクスケジューリング、マルチエージェント協調、目標駆動の終了処理を、モデルがツール呼び出しを決定できるシンプルなエージェントループの周囲に実装します。

  • プロジェクト
    addyosmani/agent-skills

    Agent Skills は、25のMarkdownベースのエンジニアリングワークフロー（仕様、計画、ビルド、テスト、レビュー、配信など）のライブラリであり、シンプルなCLI経由で多くのAIコーディングエージェントにインストール可能。スラッシュコマンド、オートビルドモード、専門ペルソナ、リファレンスチェックリストを提供し、AI生成コードが開発ライフサイクル全体にわたりシニアエンジニアのベストプラクティスに従うようにする。

  • プロジェクト
    MoizIbnYousaf/ai-agent-skills

    AI Agent Skillsは、約115個の厳選されたAIエージェント「スキル」（プロンプトとコードのセット）を、棚（フロントエンド、バックエンド、モバイル、ワークフロー、エージェントエンジニアリング、マーケティング）に整理して提供するnpmベースのCLI/TUIです。ローカルの「house-copy」スキルと、メタデータのみの上流（upstream）スキルを、閲覧、検索、インストール、管理することができます。また、`init-library`を使用して、個人のライブラリを立ち上げ、新しいスキルの追加、カタログ化、ベンダー化、更新の同期、ドキュメント生成も可能です。Claude、Cursor、GeminiなどのあらゆるAgent-Skills互換エージェントで動作し、複数のインストール先をサポートしています。再利用可能なエージェント能力の整理された検索可能なツールボックスを求めている開発者やチームに最適です。