10x-cli-setup

10x-cli のセットアップ

ユーザーの CLI とプロジェクトを準備し、作業コンテキストを guide に渡します。バージョンを選択したり、ヘルパーをインストールしたり、コースコマンドを実行したりする前に、互換性リファレンスをお読みください。実際のランナーのヘルプと、それに対応する公開済みソースを使用してください。更新され続ける master README だけでは、インストール済みの CLI がサポートする機能を確認できません。

次の CLI リリースでは、10x helpers install --tool <chosen-profile> によるプロジェクト限定のバンドルインストールも提供されます。このコマンドは未リリースで、1.21.0／1.22.0 の master ベースラインには含まれていません。まず実際のランナーで helpers --help を確認してください。ファイル一式、明示的なターゲット、競合の処理については、ローカルリファレンスのバンドルされた公開コピーに従ってください。ランナーが対応していない場合は、既存の固定された公開ルートを維持してください。

1. プロジェクトと既存のインストールを確認する

ユーザーの依頼と既存のセッションコンテキストを使用します。ファイルを書き込む前に、対象のプロジェクトディレクトリ、シェル、AI ツールを特定してください。ガイド付きの 10xDevs4 演習のコンテキストは macOS／zsh、10xdevs4、claude-code、pl です。これを v3 プロジェクトや別のプロファイルを選択したユーザーに、黙って適用しないでください。

POSIX シェルでは、失敗を隠さずにランナーを確認します。

pwd
command -v 10x

見つかった場合は、10x --version と --help、get --help、sync --help、auth --help を実行します。実行ファイルのパスとインストール方法を記録してください。既存のインストールが正常に動作しているなら、再インストールや再ログインは不要です。実行ファイルが存在しても動作しない場合は、そのエラーを保持し、ランタイム、PATH、権限の問題を診断してください。これはコマンドが見つからない場合とは異なります。他のシステムでは、POSIX の検出用スニペットではなく、そのシェルの実行ファイル検索機能を使用してください。

プロジェクトの .10x-cli.json と既存のプロファイルマニフェストを、編集せずにローカルメタデータとして確認します。コースのバインディングはプロファイル間で共通です。--tool を変更しても、v3 から v4 には切り替わりません。v3 プロジェクトにバインドされた状態で v4 の演習を行う場合は、別のディレクトリを使い、v3 プロジェクトはそのまま保持してください。破損、不明、または競合しているバインディングやマニフェストは、診断のために保持してください。アクセスを強制するために削除してはいけません。

2. 対応するランナーを選択してから、必要な場合のみインストールする

ローカルリファレンスのバージョンと機能の確認に従ってください。実際のパッケージバージョン、ソースリビジョン、サポートされている構文を記録します。リリース済みの構文は get m1l1 --type skills --name NAME です。位置引数はレッスンの参照先であり、スキル名ではありません。対応するレッスンとスキルがコンテンツに含まれていることを確認してください。ローカルビルドであることや、バージョン番号が高いことだけでは、両方が確認できたことにはなりません。スキルのフィルター機能が利用できない場合は、プロジェクトと公開ヘルパーの準備を続け、ダウンロード前に保留中の機能を具体的に報告してください。ユーザーが選択していない完全なレッスンや別のコースで代用してはいけません。

npm／npx を使う場合は、そのパッケージの engines に照らして Node のバージョンを確認してください（確認済みのベースラインでは Node 20 以降が必要です）。適切なグローバル CLI がない場合は、リファレンスに記載された固定バージョンの npx ランナーを使えば、グローバルインストールを避けられます。ユーザーが指定したグローバルまたはスタンドアロンの方法を尊重し、その方法に対応するインストール／更新手順を使用してください。インストールに必要な既存の認証は引き継いでください。権限エラーが発生しても、自動的に sudo を使ったり、グローバル設定をリセットしたり、認証情報を削除したりしてはいけません。

インストールまたは更新後に、バージョンとヘルプを再確認してください。セットアップから guide まで、同一のランナーを一貫して使用し、PATH 上の古い 10x が確認済みの npx バージョンに置き換わらないようにします。ネットワークに接続できない場合は、利用可能なローカルのバージョンとヘルプ、および対応するパッケージ同梱のドキュメントを確認してください。公開、アクセス、ダウンロードの確認は未検証のままにしてください。オフラインでのバージョン確認だけを根拠に、セットアップが完了したと主張してはいけません。

3. 認証とコースの利用可否を別々に確認する

選択したランナーの auth --status を実行します。コース API には接続できますが、 ログイン用メールは要求しません。セッションの有効性と現在のアクセス状態の両方を 確認してください。有効なトークンがあることや終了コードが成功であることは、 access_checked または v4 へのアクセスを証明するものではありません。 アクセスを確認できなかった場合は、そのエラーを残してください。

ログインが必要な場合に限り、ユーザーに対して、確認済みの auth コマンドを 対話型ターミナルで実行し、表示されるフローを完了するよう案内してください。 確認したバージョンでは、メールまたは Circle メッセージで送信されるマジックリンク （--method email／--method circle）を使用します。選択したリリースのヘルプに 従ってください。ユーザーの承認なしに、メールアドレスを要求したり、マジックリンクを 開いたり、ユーザーに代わってログインしたりしないでください。auth.json、 トークン、マジックリンクの URL、メールの内容を読み上げないでください。 セッションとアクセスの状態のみを要約してください。

次に、選択したランナーの引数なしの list を使用します。--course を指定しない場合、 CLI はプロジェクトの .10x-cli.json のバインディングからエディションを取得します。 まだバインドされていないディレクトリでは、ライブ API の推奨（アカウントが アクセスできる最も上位のエディション）から取得します。意図的に別の、利用権のある エディションを確認する場合に限り、--course <slug> を追加してください。 メンバーシップがない場合、コースが未公開の場合、モジュールがロックされている場合、 ネットワーク障害の場合を区別してください。CLI を再インストールしたり、別のツールを 選択したりしても、アクセス権は付与されません。以降のダウンロード／同期コマンドでは --tool と --lang を明示し、--course は指定しないでください。これにより、 すべてのダウンロードがプロジェクトのエディションに固定されます。

4. ツールディレクトリを人為的に作らず、準備状況を診断する

選択したランナーの doctor --json を実行します。data.checks と data.overall の 全項目、および終了ステータスを確認してください。外側の status: "ok" は出力を 包む値であり、すべてのチェックに合格したことを示すものではありません。Doctor は 設定済みのプロファイル（またはそのデフォルト）を使用するため、報告されたツールが 意図したツールと一致するか確認してください。確認したベースラインでは --tool フラグはありません。認証チェックには、解決されたエディションと選択理由 （details.course、details.selectionReason）も報告されます。最初のダウンロード前に、 これを自己確認に使用してください。プロジェクトは最初の書き込み時に 1 つの エディションにバインドされます。別のエディションを使うには新しい空のディレクトリが 必要です。バインド済みのプロジェクトに書き込むと course_mismatch で失敗します。

新しいプロジェクトで最初のダウンロードを行う前は、.claude/（または報告された プロファイルディレクトリ）がなくても問題ない場合があります。それだけが失敗しており、 書き込み可能な正しいプロジェクトである場合は、最初のダウンロードが成功すると ディレクトリが作成されることを説明してください。チェックを緑色にするだけのために、 ダミーのディレクトリを作成しないでください。認証、アクセス、API、バインディング、 書き込み権限に関する失敗は、それぞれ個別に維持し、対処してください。オフライン時に 更新確認がスキップされたとしても、CLI が最新であるとは判断できません。

5. 実際のガイドに引き継ぐ

プロジェクトにインストールされている 10x-cli-guide/SKILL.md と、その references/compatibility.md を探してください。追加または更新する前に、リファレンスを使ってインストール経路と所有者を確認してください。見つからない場合は、選択した公開オンデマンド経路または互換性のある CLI 経路からガイドをインストールし、作成されたファイルを確認してください。npm CLI をインストールしただけでは、どちらのヘルパーもエージェントで利用可能にはなりません。見つからないガイドが利用可能だと主張したり、未確認のスラッシュコマンド検出に頼ったりしないでください。エージェントには、実際に作成されたガイドの正確なパスと、そのローカルリファレンスを読むよう伝えてください。

秘密情報を含めず、次の簡潔なコンテキストを会話で引き継いでください。

Project: absolute cwd; course binding or unbound
Course / tool / requested language: 10xdevs4 / claude-code / pl (or user's choice)
Runner: exact executable or pinned npx command; observed version and source ref
CLI install/update method: npx pin / npm global / standalone asset
Auth: valid / login required / unknown; live course access and module state
Setup helper: actual path, public or CLI owner, observed source ref if known
Guide helper: actual path, owner and source ref if known; full reference present
Readiness: verified checks; remaining release/network/access issues, if any
Next task: guide's lesson setup (idea-check/init/shape/prd) → use → sync journey, or the user's narrower request

レッスン 1 のセットアップでは、4 つすべてのスキルとそのリファレンスを引き継いでください。 10x-idea-check、10x-init、10x-shape、10x-prd です。アイデアの評価は実行しなくてもかまいませんが、レッスンのセットアップ時にそのファイルを省略する理由にはなりません。特定のスキルが 1 つ指定された場合は、より限定されたダウンロードのままにしてください。実際に作成されたファイルと、ネイティブのスラッシュコマンド検出は別々に確認してください。

準備ができたら、インストールをやり直したり、すでに提示された選択肢をユーザーに繰り返し尋ねたりせずに、ガイドに沿って進めてください。ダウンロードをまだ実行できない場合は、残っている障害を正確に報告してください。準備段階を、実際の作業を完了したかのように示さないでください。