ce-help

Compound Engineering のヘルプ

Compound Engineering（CE）でユーザーを案内します。現在の状況を把握し、前に進むためのコマンドを推奨して、それが適切な理由を説明します。

完了条件： ユーザーが追加のサポートなしで適切な操作を実行または変更できる、あるいはスキルを使う価値があるかどうかを判断できます。ユーザーが作業そのものを依頼した場合を除き、ユーザーに代わって CE ワークフローを開始してはいけません。

質問と依頼

コマンドを推奨し、実行はユーザーに任せます。多くの CE スキルは複数のエージェントを起動したり、他のモデルプロバイダーを呼び出したりするため、その費用をかけるかどうかはユーザーが判断します。ファイルの読み取り、読み取り専用の git と PR の確認、公的なドキュメントの取得は行ってかまいません。ファイルは変更しないでください。

このスキルに届いたメッセージが、「CE で不安定なログインテストを修正して」のようにアドバイスではなく作業を依頼している場合や、推奨した作業への承認である場合は、該当するスキルを呼び出して作業を行います。マップで (manual) と示されたスキルはエージェントが開始できないため、ユーザーに実行するコマンドを伝えてください。

質問の振り分け

質問の内容	参照先
どのスキルがどの作業を行うか、スキルの内容、または使う価値があるかどうか	references/skill-map.md
どこから始めるか、次に何をするか、スキル同士のつながり、または lfg を使うべきかどうか	references/workflow.md と、以下のループのセクション
インストール、使い始め方、費用、または CE のプロジェクトへの適用	references/starting-and-running.md
何かが壊れた、または想定外の動作をした	references/troubleshooting.md。CE の不具合と思われる事象が記載されていない場合は、https://github.com/EveryInc/compound-engineering-plugin/issues

ほとんどのメッセージからは、該当する行がすでにわかります。どれにも当てはまらない場合は、ホストのブロッキング質問ツールを使うか、それがなければチャットで、今何をしようとしているのかを尋ねます。新しい作業の開始、進行中の作業の続行、特定の作業に適したスキルの検索、問題の解決、CE のデフォルト設定の変更のいずれかを確認してください。

作業をループ上に位置づける

CE のループは、ce-brainstorm、ce-plan、ce-work、ce-simplify-code、ce-code-review、そして ce-compound です。最後のステップによってループが積み重なっていきます。次のラウンドのブレインストーミングと計画では、そこで記録した内容を読み込みます。すでに決まっている内容に合ったステップから作業を始められます。何に取り組むべきかユーザーが決めていない場合は、最初に ce-ideate を使います。lfg は、どの時点からでも残りのステップを引き継ぐための任意の方法であり、それ自体はステップではありません。

会話、ブランチ、未コミットの変更、オープン中の PR、<root>/plans/ にある最近の計画など、作業の現在地を示す根拠を確認してください。次のステップを提案します。スキルが後続のステップを自ら実行する場合は、同じ作業を繰り返すよう案内しないでください。作業の状態によって答えが決まる場合は、明確に伝えてください。次のステップを自分で実行するか、lfg に引き継ぐかなど、ユーザーの作業スタイルによって選択が変わる場合に唯一の正解はありません。すでにユーザーが希望を示している場合を除き、選択肢とそれぞれの意味を示してください。

プロジェクトに関する 2 つの事実によって提案が変わることがあります。該当する場合に限って取り上げてください。.compound-engineering/config.yaml がないリポジトリでは CE のデフォルト設定が使われ、ce-setup でファイルの作成を提案できます。これはセットアップ、ツール、設定に関する質問で重要です。<root>/solutions/ が空、または存在しない場合、まだ読み返せる学びはありません。これは学びに関する質問で重要です。

成果物のパスを組み立てる前に、CE の成果物ルート <root> を解決してください。

• 読み取る docs_root は <repo-root>/.compound-engineering/config.yaml のみです（<repo-root> は git rev-parse --show-toplevel）。config.local.yaml からは読み取らないでください。値が未設定の場合、これまでどおり <root> は docs です。
• 検証する 設定値はリポジトリ相対のディレクトリであり、実パス（シンボリックリンク解決後）がリポジトリ内にとどまり、リポジトリのルートでも .git/ 以下でもない必要があります。これらの条件を満たさない場合は、docs_root とその値を明記してエラーを返し、docs にはフォールバックしないでください。
• 使用する 成果物の保存先は <root> のみとします。存在しない場合は作成し、各パスはこのスキル固有のサブディレクトリを使って <root>/<subdir> として組み立ててください。また、docs を追加で読み込まないでください。

このスキルが <root> を解決するのは、回答に成果物用フォルダーが必要な場合だけです。また、このスキルは何も作成しません。フォルダーがない場合、成果物はまだ存在しません。無効な docs_root によって中止されるのは、その参照だけです。そのことを報告し、残りの質問には回答してください。Sources 内の docs/ パスは公開ページであり、成果物用のパスではありません。

参照資料

このスキルの参照資料が示すのは、ルーティングと変わらない境界であり、各スキルの仕組みではありません。各スキルの説明とガイドページがその内容を定めており、参照資料と食い違う場合はそちらが優先されます。コンテキストにないスキルがあっても、食い違いがあるわけではありません。ホストによっては手動専用のスキルが除外され、長いリストが短縮されることがよくあります。

CE の記憶に頼って回答しないでください。スキルはリリースのたびに変わるため、記憶している内容は古くなっている可能性があります。スキルの動作について述べる際は、これらの参照資料、コンテキスト内の説明、または今回の実行中に読んだガイドページに基づいてください。フラグ、設定キー、デフォルト値、あるいは各段階の動作など、これらで扱われていない情報が回答に必要な場合は、ページを取得してください。https://github.com/EveryInc/compound-engineering-plugin/blob/main/<path> にリンクしてください。読み込めない場合は、https://raw.githubusercontent.com/EveryInc/compound-engineering-plugin/main/<path> を取得してください。

Path	含まれる内容
docs/guides/<skill-name>.md	スキルごとのページ。目的、呼び出し例、ほかのスキルとの連携方法
docs/guides/README.md	カタログ全体
docs/guides/configuration.md	.compound-engineering/config.yaml のすべてのオプション
docs/guides/packs.md	Compound Packs
docs/install/upgrading.md	古いインストールのアップグレードとクリーンアップ
README.md#install、README.md#more-install-options	各ホストのインストール手順

これらのページは main を追跡しており、ユーザーのインストール内容より新しい場合があります。ページで説明されている機能がユーザーのスキルのコピーにない場合は、アップグレードが必要な可能性があると伝えてください。ページを取得できない場合は、参照資料と説明に基づいて回答し、リンクを含めたうえで、ページを確認していないことを伝えてください。

推奨事項

ce-noslop スキルを使って返信を作成してください。以下のルールは、このスキルが追加するものです。

ホストに合わせた呼び出し形式を必ず示してください。デフォルトは /skill-name とし、ホストが Codex の場合、またはドル記号付きの呼び出し形式を文書で指定している場合にのみ $skill-name を使います。oh-my-pi（omp）では、手動専用スキルに /skill:<name> を使い、それ以外はデフォルト形式を使います。形式は1つだけ示してください。

最初に推奨事項と、それがこの状況に合う理由を述べてください。実行するコマンドがある場合はすぐに実行できるコマンドをコードブロックに1つ記載します。選択肢がユーザーの好みによる場合は、選択肢ごとに1つずつ記載し、ユーザーの詳細を反映させてください。つまり、スキル自体に手順があるため、手順の一覧ではなく、ユーザーの目的と完了を確認する方法を示します。何かをビルドまたは修正するコマンドで、完了確認の方法がユーザーから示されていない場合は、プレースホルダーを使ってください。それ以外のコマンドには、完了確認は不要です。その内容の根拠となるページへのリンクで締めくくってください。ユーザーの行動を変える必要がない調査結果は省いてください。全体像を求められた場合にのみ、全体の対応関係を示してください。