はじめに
セットアップの失敗箇所を絞る
成功しなかった段階を、登録・認証、ワークスペース作成、設定生成、確定、初回観測、エージェント接続に分けて調べます。
初期セットアップのどこで止まったか
| 段階 | 確認するもの | 次の操作 |
|---|---|---|
| 登録・招待 | メール認証と招待の適用 | アカウント作成の残っている手順を進める。 |
| サインイン | orc auth status --json | 使用中の認証元を確認する。 |
| ワークスペース作成 | 作成結果のIDとworkspaces get | 同じアカウントで作成結果を読み戻す。 |
| 設定生成 | orc observations get --workspace WORKSPACE_ID --json | エラーを解消し、同じ対象の生成を再開する。 |
| 設定確定 | 確定結果のinitial_batch_id | 候補を確認して確定する。 |
| 初回観測 | 同じバッチの状態と結果 | runs batches getとruns batches results getで確認する。 |
| WebのWelcome終了 | workspaces setup getのcompleted_at | 観測完了と区別し、Webに残る手順を進める。 |
measurement_quota_exhaustedは観測利用枠を確認できない状態です。対象IDとエラーを担当者へ伝えます。init --websiteが未知のオプションになる場合は、0.5.0向けの段階別コマンドを使います。
手順
node --version
orc --version
orc --help
orc status --json
orc auth status --json
orc workspace current --json
orc setup skills --agent codex --statusorc が見つからなければ Node.js と導入先の PATH を確認します。401 は使用中の認証元、403 は対象と必要権限、空の一覧はワークスペースとデータの有無を確認します。status の終了コード 0 だけで正常と判断せず、各フィールドを読みます。Skills は installed / missing / broken / version-drift / conflict を確認し、conflict の通常ファイルを消しません。MCP は登録、OAuth、実際の取得の順で切り分けます。共有するのはバージョン、秘密を除いたエラー、対象 ID、再現手順です。
失敗が残る場合は、失敗を報告して再検証するで、このワークフローと失敗した手順を報告へ添えます。