このプロジェクトについて

Jules Promptsは、コーディングエージェント向けに設計された、機械可読なタスクプロンプト、Agent Skills、および意図的に欠陥を仕込んだフィクスチャのキュレーションライブラリです。名前は歴史的なものであり、手順はハーネスに依存せず、Jules、Claude Code、Codex、Cursorなどの特定の製品には依存しません。 リポジトリはいくつかの層で構成されています： - `_prompts/`：ウェブサイト、JSONインデックス、MCPスラッシュコマンドを含む、標準的な手順テキスト。 - `skills/`：`_prompts/`から生成された、Agent Skillsとしてフォーマットされた同じテキストで、`.claude/skills/`または`.agents/skills/`にコピーする準備ができています。 - `fixtures/`：スキルがどのように失敗するかを示すために、意図的に欠陥を仕込んだミニチュアリポジトリ。 - `plugin/`：マニフェスト、スキル、スラッシュコマンドを含む、インストール可能なバンドルとしてのライブラリ全体。 - `library.json`：すべての手順、そのカテゴリ、およびティアの機械可読なリスト。 生成されたすべての出力は、ソースと同期していることを確認するためにCIでバイト単位でチェックされます。新しい出力形式を追加することは、`scripts/emit.py`の`TARGETS`リストに1つのエントリを追加するだけです。 手順は、`status: legacy`とマークされていない限り、`core`として分類されます。コア手順は、エージェントが実際に持つ失敗に対処しますが、レガシー手順は、2025年からの汎用的なタスクテキストであり、依然として有用ですが、このライブラリをユニークにしているものではありません。 ライブラリには、`harness/AGENTS.md`に`AGENTS.md`の常設ドクトリンが含まれており、スキルが選択されていない場合に確実に発動するようにしています。 入門ガイドは、`PROMPTS_GUIDE.md`（各プロンプトと推奨シーケンスを説明）と`ENVIRONMENT_SETUP.md`（エージェントのクローン、インストール、テスト用にリポジトリを準備）に記載されています。 使用オプションは次のとおりです： - Agent Skillsとして：スキルディレクトリを`.claude/skills/`にコピーし、`harness/AGENTS.md`をプロジェクトの`AGENTS.md`に貼り付けます。 - MCPサーバーとして：`mcpServers`でサーバーを構成し、Claude Code、Claude Desktop、VS Code/Copilot Chat、Windsurf、Zedでプロンプトをスラッシュコマンドとして公開します。サーバーはリポジトリをライブで読み取り、`<PR_URL_OR_DIFF_RANGE>`などのプレースホルダーは引数として公開されます。 - 人間向け：YAMLフロントマターの後のプロンプトファイルの本文をコピーし、エージェントの指示入力に貼り付けます。 - エージェント向け：`https://jules-prompts.wecanuseai.com/prompts.json`を取得し、タイトル/説明/カテゴリでプロンプトを選択し、そのURLからレンダリングされたプロンプトを取得するか、`_prompts/<slug>.md`を読み取ります。 - フィクスチャに対して：`python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md`を使用してフィクスチャをスコアリングし、holds/broken/skippedの判定とカバレッジ行を出力します。 貢献ガイドラインでは、まだカバーされていない繰り返し発生するタスクにのみプロンプトを追加し、YAMLフロントマターを整合させ、ハーネスに依存しない手順を作成し、スキルを再生成し、ガイドとワークフローを更新し、失敗をキャッチするプロンプト用のフィクスチャを追加し、整合性チェックに合格することを強調しています。