# Tham chiếu CLI

Trang này được sinh từ bề mặt lệnh mà bản phát hành đóng gói. `ariadnev` và `av` dùng thay cho nhau ở mọi nơi.

## Các lệnh trong bản phát hành này

- [`vcskill`](#vcskill)
- [`vcskill add-skill`](#vcskill-add-skill)
- [`vcskill backups`](#vcskill-backups)
- [`vcskill contract`](#vcskill-contract)
- [`vcskill coverage`](#vcskill-coverage)
- [`vcskill doctor`](#vcskill-doctor)
- [`vcskill eval`](#vcskill-eval)
- [`vcskill install`](#vcskill-install)
- [`vcskill list`](#vcskill-list)
- [`vcskill migrate`](#vcskill-migrate)
- [`vcskill query`](#vcskill-query)
- [`vcskill run`](#vcskill-run)
- [`vcskill run cancel`](#vcskill-run-cancel)
- [`vcskill run resume`](#vcskill-run-resume)
- [`vcskill run status`](#vcskill-run-status)
- [`vcskill telemetry`](#vcskill-telemetry)
- [`vcskill uninstall`](#vcskill-uninstall)
- [`vcskill update`](#vcskill-update)
- [`vcskill validate`](#vcskill-validate)

## `vcskill`

Install a curated, quality-gated workflow kit across coding-agent targets.

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--cwd <dir>` | override project root |
| `--dry-run` | plan only, write nothing |
| `--home <dir>` | override home root |
| `--yes` | skip interactive prompts |
| `-V, --version` | output the version number |

## `vcskill add-skill`

Scaffold a new canonical skill in the kit

### Tham số

- `name` (bắt buộc)

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--description <text>` | skill description |

## `vcskill backups`

List or restore vcskill-managed backups

### Tham số

- `action` (bắt buộc) — list \| restore \<timestamp\>
- `timestamp` — backup timestamp (for restore)

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--file <rel>` | restore only the file matching this name |
| `--global` | use \~/ scope |

## `vcskill contract`

Print the provider×artifact capability contract (--json for machines)

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--json` | emit JSON instead of the Markdown matrix |

## `vcskill coverage`

Strictly check classified claims against skill content

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--skill <name>` | only check one skill (bare or vc: prefixed) |

## `vcskill doctor`

Health-check the installed kit against its receipt

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--fix` | re-merge hook bindings that drifted out of settings.json (backs up first) |
| `--global` | check \~/ scope |

## `vcskill eval`

Score kit quality — tier-1 static; tier-2 behavioral suite; optional tier-3 LLM judge

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--concurrency <count>` | maximum parallel isolated runs |
| `--deep-repeats <count>` | repeats for every golden task |
| `--model <name>` | pinned model identity |
| `--runner <json-argv>` | strict JSON argv array; prompt is sent on stdin |
| `--runtime-provider <name>` | pinned runtime provider identity |
| `--runtime-version <version>` | pinned runtime version identity |
| `--skill <name>` | only evaluate one skill (bare or vc: prefixed) |
| `--skill-repeats <count>` | repeats for every skill routing cell |
| `--suite` | run the tier-2 behavioral scenario suite |
| `--timeout-ms <milliseconds>` | per-run timeout |
| `--variant <name>` | benchmark variant: vcskill or reference |

## `vcskill install`

Install the kit to one or more providers

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--global` | install to \~/ instead of ./ |
| `--provider <list>` | comma-separated provider ids |

## `vcskill list`

Show kit contents and per-provider install state

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--global` | check \~/ scope |

## `vcskill migrate`

Relocate installed files when provider path conventions change

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--global` | operate on \~/ instead of ./ |
| `--provider <id>` | limit to one provider |

## `vcskill query`

Show recorded vcskill history (installs \| doctor \| history)

### Tham số

- `view` — installs \| doctor \| history

### Tùy chọn

Lệnh này không có tùy chọn.

## `vcskill run`

Validate or execute a versioned graph workflow

### Tham số

- `workflow` — canonical workflow ID

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--initial-state <json>` | initial graph state as a strict JSON object |
| `--instruction <text>` | workflow instruction |
| `--json` | emit a stable versioned JSON envelope |
| `--model <model>` | runtime model identity (stored outside Graph IR) |
| `--run-id <id>` | stable run ID (generated when omitted) |
| `--runtime <provider>` | explicit runtime: codex or claude-code |
| `--runtime-version <version>` | required runtime version (resume must match the original) |
| `--validate` | compile and lint without probing or executing |

## `vcskill run cancel`

Request cooperative cancellation for an active run

### Tham số

- `run-id` (bắt buộc) — existing run ID

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--json` | emit a stable versioned JSON envelope |

## `vcskill run resume`

Resume a durable run with the original graph and runtime identity

### Tham số

- `run-id` (bắt buộc) — existing run ID

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--instruction <text>` | workflow instruction |
| `--json` | emit a stable versioned JSON envelope |
| `--model <model>` | runtime model identity (stored outside Graph IR) |
| `--runtime <provider>` | explicit runtime: codex or claude-code |
| `--runtime-version <version>` | required runtime version (resume must match the original) |

## `vcskill run status`

Read durable status without invoking a provider

### Tham số

- `run-id` (bắt buộc) — existing run ID

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--json` | emit a stable versioned JSON envelope |

## `vcskill telemetry`

Anonymous telemetry status (stateless, off unless configured; opt out with VCSKILL\_TELEMETRY\_DISABLED=1)

### Tham số

- `action` — status

### Tùy chọn

Lệnh này không có tùy chọn.

## `vcskill uninstall`

Remove a previously installed kit (receipt-based, preserves user-modified files)

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--global` | uninstall from \~/ instead of ./ |
| `--provider <list>` | comma-separated provider ids (default: every provider in the receipt) |

## `vcskill update`

Self-update to the latest vcskill release (--check to only report)

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--check` | only report whether an update exists; don't install |
| `--global` | check \~/ scope |

## `vcskill validate`

Lint the kit source (frontmatter, sizes, references, claim coverage) without installing

### Tùy chọn

| Tùy chọn |  |
| --- | --- |
| `--check` | also fail if the README provider matrix is out of sync (CI gate) |