10x-cli-guide

10x-cli：ダウンロード、使用、更新

コマンドを実行する前に、同梱の互換性とチャンネルのリファレンスをお読みください。固定されたランナーのセットアップ、バージョン確認、2つのヘルパーチャンネル、所有権に関する保護策が記載されています。コマンドではリリース済みのレッスン限定スキルフィルターを使用します。使用前に、実際に選択されたパッケージと内容を確認してください。ローカルビルドやソースへの収録は、機能がリリース済みである証拠にはなりません。

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

環境

セットアップの引き継ぎ情報（プロジェクトルート、コース、ツール、言語、ランナー／バージョン、認証／アクセス状況、更新方法、ヘルパーチャンネル／パス）を再利用してください。不足している情報があれば、その項目だけを確認してください。CLI がインストール済みで正常に動作している場合、再インストールは不要です。セットアップが必要な場合は、実際の SKILL.md とリファレンスを探すか、公開チャンネルからそのヘルパーをインストールしてください。存在しない兄弟ヘルパーを名前で呼び出さないでください。

ガイド付きの受け入れコンテキストは macOS/zsh、Claude Code、10xdevs4、ポーランド語です。すべての失敗を Windows と判定する POSIX コマンドではなく、環境から実際の OS とシェルを確認してください。書き込みを行う前に、対象のプロジェクトルートを選択してください。v4 の場合は既存の v3 プロジェクトを保持し、別のディレクトリを使用してください。通常の get、sync、プロファイル変更ではエディションは移行されません。バージョン／コースに不整合がある場合は、.10x-cli.json とすべてのマニフェストを保持してください。

リファレンスで定義された検証済みの 10x_cli ランナー、またはユーザーが指定した検証済みのグローバル／スタンドアロン実行ファイルを使用してください。

10x_cli --version
10x_cli get --help
10x_cli sync --help
10x_cli auth --status
10x_cli list

これらのコマンドには --course を含めないでください。ディレクトリがすでにコースに紐付けられている場合、CLI は .10x-cli.json からエディションを読み取ります。そうでない場合は、ライブ API の推奨（アカウントが利用できる最上位のエディション）を使用します。get には Course: <slug> (<reason>) と表示されます。最初の書き込みの前に、一度確認してください。別の利用資格があるエディションを意図的に確認する場合に限り、--course <slug> を使用してください。紐付け済みのプロジェクトを別のエディションに書き換えることはできないため（course_mismatch）、v4 は新しい空のディレクトリで開始します。

レッスンリファレンス、スキルフィルター、レッスン限定の同期について、ソース／リリースの証拠を確認してから、以下のフィルター付きプレビューでエンドポイントを確認してください。help が正常終了したことを機能の対応証明と見なさないでください。未対応の CLI 構文、未公開／欠落したコンテンツ、ロックされたモジュール、メンバーシップ拒否、ネットワーク障害は、それぞれ区別してください。最終リリースの証拠が不足していても、公開ヘルパーや演習ファイルの準備を妨げる必要はありません。

config.json からは、必要な非機密の設定だけを読み取ってください。macOS／Linux では、ベースディレクトリは空でない $XDG_CONFIG_HOME、なければ ~/.config です。Windows では %APPDATA%、なければユーザーの AppData/Roaming です。末尾に 10x-cli/config.json を追加してください。auth.json を表示したり、stderr を破棄したり、doctor の JSON を切り詰めたり、不明な問題を修復するために設定を消去したりしないでください。この手順で明示されたコース／ツール／言語は、そのコマンドでは保存済みの既定値より優先されます。

セッション管理

ログインが必要な場合は、ユーザーに配信チャンネルを選んでもらい、ログインを完了してもらってください。

10x_cli auth                  # Interactive: choose email or Circle
10x_cli auth --method email   # Email magic link; default for piped/JSON output
10x_cli auth --method circle  # One-time approval link delivered in Circle
10x_cli auth --status
10x_cli auth --logout

メールが届かない場合は、Circle が役立ちます。承認リンクの有効期限は15分です。CLI は自動で再送しません。非対話モードでは、ユーザーのメールアドレスを --email で指定し、--method circle を明示的に選択してください。ユーザーから認証を求められるまでは、ログインメッセージを送信しないでください。セッションは透過的に更新されるため、更新で復旧できない場合にのみ再ログインが必要です。

ダウンロード

起動演習では、レッスン 1「アイデアから PRD へ」に沿って、既存の 10xCards の例を使用します。10x-plan はこの起動デモの対象ではありません。 レッスンのスキルを 4 つすべて用意します：10x-idea-check、10x-init、10x-shape、および 10x-prd。アイデア評価の実行は任意ですが、レッスン 1 の準備時にはそのファイルも利用できる状態にしてください。 ユーザーが特定のスキルのみをリクエストした場合は、その限定された範囲を維持してください。各名前の機能と利用可能性を確認した後、選択したスキルツリーを 4 つに分けて完全な状態でダウンロードします。対応する書き込みの前に、それぞれのドライランを確認してください：

10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl

各レポートと、SKILL.md だけでなくサポートツリー全体を確認してください。 選択した macOS/zsh の演習ディレクトリで、使用前に以下の確認をすべて成功させてください （失敗した場合は停止し、最後の確認だけで成功を推定しないでください）：

test -s .claude/skills/10x-idea-check/SKILL.md
test -s .claude/skills/10x-idea-check/references/examples.md
test -s .claude/skills/10x-idea-check/references/assessment-guide.md
test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
test -s .claude/skills/10x-init/SKILL.md
test -s .claude/skills/10x-shape/SKILL.md
test -s .claude/skills/10x-shape/references/prd-schema.md
test -s .claude/skills/10x-prd/SKILL.md
test -s .claude/skills/10x-prd/../10x-shape/references/prd-schema.md

PRD のエントリーポイントは、自身のディレクトリを基準に ../10x-shape/references/prd-schema.md を参照します。PRD ツリーだけでは不十分です。インストールしたすべてのエントリーポイントと、それらが必要とするすべてのリファレンスを読みます。上記のパスは既知のソースの最小要件であり、公開バンドルから追加ファイルを破棄してよいという意味ではありません。 .claude/.10x-cli-manifest.json も確認してください：lessons.m1l1.skills に 4 つすべての名前が含まれ、files.skills にファイルハッシュが含まれている必要があります。これらはレッスンが所有する部分ダウンロードであり、独立した所有者ではありません。コースとの紐付けについては .10x-cli.json を確認してください。部分ダウンロードによって、完全なレッスンリリースの識別情報が確立されるわけではありません。

CLI 1.21.0 は v4 とフィルター付きスキルダウンロードを使用して公開されています。本番の m1l1 EN/PL には、アイデアチェック、初期化、構成、PRD とそれらのリファレンスが含まれます。これらの改訂されたヘルパーは別個のソース変更であり、コース用コピーが公開済みであることの証明ではありません。 選択した実際のリリースに照らして 4 つすべての名前を確認してください。名前、スキーマ、所有者、またはリリースが存在しない、あるいは一致しない場合は、正確なエラーを保持して演習を停止してください。レッスン全体、別のコース、またはフィルター付き get に黙って置き換えてはいけません。

CLAUDE-m1l1 はレッスン固有の別のルールであり、これらのフィルター付きスキル取得では提供されません。確認済みの init/shape/prd ソースは、この一連の実行にそのルールを必要としません。ただし、レッスン全体のすべてのステップがそのルールなしで機能することを示すものではありません。 学習者がすでに持っているレッスン 1 の入力と手順を使用してください。それらでルールが必要な場合は、既存のプロジェクトルールとその出所を確認します。存在しない場合は、前提条件が不足していることを報告し、そのステップを実行する前にレッスンまたはリリースの所有者からサポート対象の手順を入手してください。ルールのコマンドを作り出したり、回避策としてレッスン全体をダウンロードしたりしないでください。既存のプロジェクトルールを上書きしてはいけません。

閲覧には 10x_cli list m1 を使用してください。上記のコマンドは、スキル名で 1 つのレッスンをフィルターします。get 10x-init はサポートされていません。--print は確認用です： TTY の Markdown 出力には SKILL.md しか含まれない場合があり、非 TTY 出力は JSON エンベロープになります。パッケージのインストールとして、print 出力を SKILL.md にリダイレクトしてはいけません。

使用例：10xCardsでアイデアからPRDまで

ツリーのダウンロードは準備にすぎません。既存の10xCardsの例と、レッスン1で学習者が実際に回答した内容を使用してください。それらの入力がない場合は、学習者に提示を求めてください。プロダクト要件、代わりのtask.md、完成済みの計画をでっち上げてはいけません。非公開のレッスン内容を公開用のフィクスチャやトランスクリプトに含めないでください。 npm installによってネイティブのスラッシュ／$による検出や自動有効化が行われると想定してはいけません。エージェントにはローカルのパスを明示してください。学習者が、アイデアが自身の経験、時間、コースの目標に合っているか評価したい場合は、まず.claude/skills/10x-idea-check/SKILL.mdとそのリファレンスを読み、そのスキルに従ってください。学習者がアイデアを具体化する準備ができている場合は、評価を必須の前提にしないでください。 次の手順を個別に進めてください。

1. .claude/skills/10x-init/SKILL.mdを読み、選択したプロジェクトでその指示に従ってください。作成対象がまだ存在しない場合に作成されるcontext/changes、context/archive、context/foundationディレクトリと、それぞれのREADMEを確認してください。既存のファイルは保持してください。
2. .claude/skills/10x-shape/SKILL.mdと.claude/skills/10x-shape/references/prd-schema.mdを読んでください。学習者の10xCardsの入力を使い、スキルに従って情報を引き出してください。学習者自身が回答し、チェックポイントを承認できるようにしてください。学習者に代わって回答してはいけません。先に進む前に、それらの回答と照らし合わせてcontext/foundation/shape-notes.mdを確認してください。
3. .claude/skills/10x-prd/SKILL.mdと同階層のスキーマを読み、実際のcontext/foundation/shape-notes.mdを基にドラフトを生成してください。その入力およびインストール済みのスキーマと照らし合わせてcontext/foundation/prd.mdを確認してください。未解決のドメイン上の選択肢は未確定のままにしてください。スキルに定められた既存ファイルとの衝突時の選択に従ってください（適切な結果がバージョン付きファイルになることもあります）。

成功には、学習者のメモとスキーマに準拠したPRDが必要です。不足点を明示し、元のプロジェクトの成果物を保持してください。ダウンロードのトランスクリプトだけでは不十分です。PRDを確認したら終了してください。続けて技術スタックの選定、ブートストラップ、実装に進んではいけません。異なるグローバル／ローカルのスキルのコピーを読んだ場合は、結果を受け入れる前にパスを正してください。実際に使用したエージェント、プロファイル、言語、出力パス、確認項目を記録してください。2つの正式な出力ファイル名には上書きを無理に適用せず、新しく分離された演習用ディレクトリを使用してください。

更新

同じランナー、ディレクトリ、ツール、言語を使用します。エディションはプロジェクト独自のままなので、sync にも --course は不要です。sync は、これらのフィルター付き get の後に m1l1 を含む、ダウンロード済みのレッスン全体を更新します。プレビューには、ほかのスキル、プロンプト、設定、コースルールが含まれる場合があります。範囲が広がっていることを確認し、ユーザーが承諾した場合にのみ適用してください。1つのスキルだけを更新するには、代わりにそのスキルのフィルター付きプレビューと get を再度実行してください。隠れたルールの前提条件を回避する手段として sync を使わないでください。

10x_cli sync --tool claude-code --lang pl --dry-run
10x_cli sync --tool claude-code --lang pl

通常の sync では、選択した4つのスキルだけでなく、マニフェストに記録されたレッスン全体が更新されます。--all は範囲をロック解除済みのレッスンに広げますが、この作業では不要です。管理対象のファイルが欠落している場合は修復し、ローカルの編集内容は競合または保持されたファイルとして確認できる状態にしてください。終了コードが 0 でも、レポートのすべての結果とリソース数を確認してください。競合によるスキップだけなら、プロセスエラーではありません。リモートのダイジェストに変更がないことを、ローカルファイルが無傷であることと同一視しないでください。

競合するスキルが1つある場合は、差分を確認し、ローカルの作業をバックアップしてから、同じディレクトリで同じツールと言語を使用し、対話型ターミナルからそのスキルのフィルター付き get を再試行してください。ユーザーが選択した解決方法を保持してください。CLI のヒントでコンテキストが省略されている場合は、提案するコマンドにこれらのフラグを戻してください。自動的に --force を実行しないでください。ローカルのスキル／プロンプトの編集内容を上書きする可能性があり、保護されたルールや安全な削除を回避することもできません。設定テンプレートは、ファイルが存在しない場合にのみ作成されます。クリーンアップでは、変更済み／未追跡のファイルや、ほかの場所が所有するファイルは保持されます。sync 後にスキルディレクトリを手動で一掃しないでください。

コースのツールキット自体で何が変わったか確認するには、changelog を使用します。このコマンドは未リリースです。まず実際のランナーで changelog --help を確認してください。

10x_cli changelog                      # toolkit releases since this project's last sync
10x_cli changelog --since v2.55.0      # releases after a version
10x_cli changelog --course 10xdevs4    # another course than this project's
10x_cli changelog --since 2026-10-01   # releases from that UTC day on

このコマンドが一覧表示するのは、ツールキットのリリースノート（リリースごとのスキル、プロンプト、ルール、設定テンプレート）であり、このプロジェクトのファイルではありません。ダウンロード対象の確認には、引き続き sync --dry-run が正となります。sync が成功するか、フィルターなしの get が成功すると、最新のツールキットバージョンがプロジェクトのマニフェストに基準として記録されます。記録されていない場合、コマンドは最後に適用したレッスンの日付を基準にするか、最新5件のリリースを表示します。終了コードが 0 で「No toolkit changes」と表示されるのは正常です。ファイルが書き込まれることはありません。

3種類の更新はそれぞれ独立しています。npm／バイナリのバージョンを変更すると CLI が更新されます。意図的に選んだ新しい保持 SHA を指定して、公開されている skills add を再実行すると、公開ヘルパーが更新されます。CLI の sync では、CLI が所有するコーススキルが更新されます。実行ファイルや、公開インストーラーが所有するヘルパーのコピーは更新されません。

チャネル：両方のヘルパーを2つの経路から利用できます

公開オンデマンド経路は、CLI／認証より前に利用でき、選択したソース SHA でプロジェクトのヘルパーを1つインストールします。CLI 経路では、ヘルパーのコンテンツが公開され、m1l1 にアクセスできるようになった後、認証済みのフィルター付き get を使用します。10x-cli-setup と 10x-cli-guide については、リファレンスに記載された正確なコマンドとガードに従い、必要なものだけをインストールしてください。どちらの経路でも、それぞれのヘルパー独自の references/compatibility.md が提供されます。

インストール済みのコピーごとに、所有元は1つにしてください。書き込む前に、コピー先のパス／シンボリックリンク、CLI マニフェスト、公開インストーラーのプロジェクト登録を確認してください。ヘルパーがすでに CLI に所有されている場合は、そのコピーを使用して sync してください。公開版から CLI 版へ所有元を移す場合は、ヘルパー全体とメタデータを管理対象のツリー外にバックアップし、元の固定バージョンのインストーラーにあるプロジェクト／エージェントの削除フローを使って、そのヘルパーだけの登録を解除します。登録とコピー先が存在しないことを確認してから、フィルター付き get を実行してください。ローカルの編集内容は、バックアップから慎重に統合してください。どちらかの所有元が残っている場合は、移行を中止してください。CLI 版から公開版への移行には、スキル単位の登録解除について検証済みの方法がありません。マニフェストを手作業で編集するのではなく、新しい隔離プロジェクトを使用してください。

プロファイルとトラブルシューティング

スキルツリー全体は、選択したプロファイルの skills/<canonical-name>/ に配置されます。

プロファイル	ツールディレクトリ	レッスン全体の配信に使うルールファイル
claude-code	.claude/	CLAUDE.md
cursor	.cursor/	.cursor/rules/10x-course.mdc
copilot	.github/	.github/copilot-instructions.md
codex	.agents/	AGENTS.md
devin-desktop	.devin/	AGENTS.md
gemini	.gemini/	GEMINI.md
generic	.ai/	AGENTS.md

プロファイルの変更時には、移行、対象となる管理対象ファイルの削除、または両方を残す選択肢が提示されることがあります。どの選択肢も、ユーザーの任意のコンテンツを削除したり、コースのエディションを切り替えたりするものではありません。旧式の windsurf エイリアスや孤立ファイルの扱いについては、選択したバージョンのヘルプ／出力に従ってください。これらのパス対応表は、Windows や他のエージェントでの動作確認が完了したことを示すものではありません。シェル構文はユーザーが実際に使っているシェルに合わせてください。

診断が役立つ場合は 10x_cli doctor --json を実行し、終了ステータスだけでなく、data.overall と data.checks の全体を確認してください。これは設定済みのプロファイルをチェックするもので、--tool や --course 引数はチェックしません。認証チェックでは、解決されたエディションと選択理由（details.course、details.selectionReason）が報告されます。これは、このディレクトリにどのエディションが適用されているかを自己確認するためのものです。初回の get より前であれば、ツールディレクトリが存在しないのは想定内の場合があります。その失敗だけを説明し、他の失敗も引き続き表示してください。Doctor の終了コード 78 と、外側の JSON の status: "ok" は同時に発生することがあります。

症状	次の手順
認証情報がない／期限切れ	認証ステータスとライブアクセスの結果を確認し、セットアップを通じてユーザー自身にログインを完了してもらいます。ログイン時にメールが送信されることがあります。
メールが届かない	10x_cli auth --method circle を提案し、ユーザー自身にメッセージをリクエストしてもらいます。
circle_login_disabled	Circle は利用できません。10x_cli auth --method email を使います。
dm_rejected	Circle のダイレクトメッセージを有効にするか、メールログインを使います。
circle_login_expired	新しい Circle ログインをリクエストするか、メールを使うようユーザーに伝えます。自動で再送してはいけません。
コースへのアクセスが拒否された	選択したコースとメンバーシップを確認します。ツールの変更や再インストールではアクセス権は付与されません。
v4 がロック中または未公開	モジュールの利用可能状況／リリースの根拠を確認します。ゲートを迂回したり、v3 にフォールバックしたりしてはいけません。
サポートされていない名前／インデックスがない	CLI パッケージとコンテンツリリースが正確か確認し、エラーをリリース担当者に伝えます。
changelog_unsupported	バックエンドではまだツールキットの変更履歴を提供していません。sync/get は引き続き動作します。後で再試行してください。コンテンツの失敗として扱ってはいけません。
ネットワーク／API の失敗	診断情報を保持し、サービスが復旧したら同じコンテキストで再試行します。設定はリセットしません。
セットアップ後に 10x-idea-check がない	古いヘルパーの手順では、init/shape/prd のみが選択されていました。実際のコマンド、選択したプロファイルのパス、マニフェストを確認します。上記の idea-check preview/get を使って、完全なツリーを追加します。ファイルがすでに存在する場合は、その SKILL.md を直接読み、再インストールする前にエージェントの検出／再読み込みの挙動を確認します。スラッシュコマンドがないだけでは、ファイルがないとは限りません。
ディレクトリ／プロファイルが違う	cwd と明示的なフラグを再確認します。新しいプロジェクトにはツールディレクトリが存在しないのが正当な場合があります。
署名／リリースの不一致	失敗の内容とソースの識別情報を保持します。検証を無効にしたり、無関係なバイト列を再利用したりしてはいけません。
エディション／マニフェストの競合	修復に備えてバインディングとマニフェストを保持します。削除せず、別の v4 プロジェクトを使います。
ファイルの競合または権限の失敗	影響を受けるパスとローカルの編集内容を確認し、バックアップを保持して、該当する問題を解決します。広範囲な chmod／リセット／強制実行は行いません。

必要な場合に限って --verbose を使い、診断情報を共有する前に認証情報を伏せてください。bench など無関係な日常コマンドについては、このランナーに対応するヘルプを確認してください。古いバイナリの根拠として、任意の master README を取得してはいけません。