verify
apothem verify コマンドの CLI リファレンス。
ハーネスアダプターのインストールを検証します。
構文
apothem verify --harness NAME|all [--profile PATH] [--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]選択された各アダプターの verify() 実装を呼び出します。
選択されたすべてのアダプターが、管理対象ターゲットが存在し有効であると報告した場合にのみ、0 で終了します。
--profile がない場合、チェックは構造的です —— すべての管理対象ターゲットが存在し、有効でなければなりません。
--profile がある場合、チェックはさらにプロファイルへの忠実性を要求するため、存在してはいるもののドリフトしたインストールは verify に失敗します。これにより、単に「存在するか？」ではなく、「まさにこのプロファイルが忠実にインストールされているか？」に答えます。
スキルをホームディレクトリに書き込むアダプターについては、verify は、期待されるすべてのスキルフォルダーが SKILL.md とともに存在することも、どのインストールがそれを書き込んだかにかかわらずチェックします。そのため、フォルダーを共有するツールのうち 1 つだけがインストールされているマシンでも検証に合格します。
フォルダーが欠落している場合、および Apothem のスキルの名前を持つフォルダーが Apothem が書き込んだものではない何かに属している場合に失敗します。
失敗した行はそのどちらであるかを示します。plain モードではその後に Note: 行が続き、JSON の行では user_level オブジェクトが missing と unlisted のパス、および message を列挙します。
欠落したフォルダーを復元するには install を実行してください。外部のフォルダーはリネームまたは移動してから、update を実行してください。
--harness all のスイープは、プロファイルの exclude_harnesses —— install/update のバッチが適用したのと同じ除外 —— に従うため、verify が意図的に除外されたハーネスを欠落として報告することは決してありません。
除外は、--profile が指定されている場合はそこから、そうでない場合はデフォルトのプロファイルから取得されます。デフォルトが読み取れないか存在しない場合は、レジストリ全体にフォールバックします。
オプション
| オプション | 説明 |
|---|---|
--harness NAME | 検証するハーネスアダプター、またはレジストリ全体のセットを表す all（必須）。 |
--profile PATH | 忠実性をチェックする基準となる共有プロファイル YAML。これがない場合、チェックは純粋に構造的なものになります。 |
--project PATH | プロジェクトスコープのハーネス向けのプロジェクトルート。 |
--quiet, -q | 情報出力を抑制します。エラーのみが出力されます。 |
--verbose, -v | 追加の診断出力を出力します。 |
--format plain|json | 出力形式（デフォルト: plain）。 |
--json | --format json の短縮形。 |
--no-color | 出力中の ANSI カラーコードを無効にします。 |
-h, --help | ヘルプを表示して終了します。 |
JSON 出力
{
"schema_version": 1,
"status": "success",
"command": "verify",
"action": "verified",
"harness": "claude-code",
"files_written": [],
"results": [
{
"harness": "claude-code",
"outcome": "unchanged",
"operation": "verify",
"path": "C:\\Users\\Example\\.claude\\settings.json",
"message": "managed targets verified",
"installed": true,
"verified": true
}
],
"warnings": [],
"error": null,
"installed": true,
"verified": true,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}選択されたハーネスのいずれかが欠落しているか無効な場合、status は error になり、失敗した結果の行は verified: false を持ち、プロセスはコード 1 で終了します。
例
apothem verify --harness claude-code
apothem verify --harness claude-code --json
apothem verify --harness all --project .終了コード
| コード | 意味 |
|---|---|
| 0 | ハーネスが検証された — すべての管理対象ターゲットが存在し、有効である |
| 1 | ハーネスが検証されなかった — 管理対象ターゲットが欠落しているか無効である |
| 64 | 使用法エラー: 不明なオプションまたはコマンド、あるいは欠落した、または無効なオプション値。--json のもとでは、エラーはコード cli.usage を持つ JSON エンベロープになります。 |
関連項目
- apothem install — ハーネスの設定をインストールする
- apothem update — 現在のプロファイルをハーネスに再適用する
- apothem doctor — システム全体のインストール診断