merge VLM skills into a single workflow expert skill

2026-02-13 12:01:10 +08:00
parent 54416065fe
commit 5931f16a71
6 changed files with 292 additions and 0 deletions
@@ -0,0 +1,67 @@
+# VLM Workflow Guide
+
+This guide details the standard end-to-end process for organizing a video library using VLM.
+
+## 1. Setup and Discovery
+
+### Initialize Configuration
+```bash
+vlm config init
+```
+Edit `~/.vlm/config.yaml` to set `library_root`.
+
+### Library Scan
+```bash
+vlm scan
+```
+- **Goal**: Create `inventory.csv`.
+- **Note**: Ensure `ffprobe` is installed for resolution and codec metadata.
+
+## 2. Identification
+
+### Filename Parsing
+```bash
+vlm parse --inventory inventory.csv
+```
+- **Goal**: Create `identities.json`.
+- **Why --inventory?**: It embeds video metadata (v2 schema) required for quality-based duplicate resolution.
+
+### Metadata Enrichment
+```bash
+vlm enrich
+```
+- **Goal**: Update `identities.json` with TMDB data.
+- **Troubleshooting**: If matches are missing, check `enrichment.api_keys` in config.
+
+## 3. Analysis and Planning
+
+### Detect Issues
+```bash
+vlm analyze
+```
+- **Goal**: Create `analysis.json`.
+- **Outputs**: Lists duplicate files and episode gaps in series.
+
+### Create Execution Plan
+```bash
+vlm plan --analysis analysis.json
+```
+- **Goal**: Create `plan.json`.
+- **Strategy**: VLM uses the `duplicate_keep` policy (default: `by_reputation`) to decide which files to keep and which to quarantine.
+
+## 4. Execution and Safety
+
+### Review the Plan
+Open `plan.json` and check the `human_summary` field or the proposed `operations`.
+
+### Execute Changes
+```bash
+vlm execute           # Dry-run
+vlm execute --confirm # Actual operations
+```
+
+### Reverting Changes
+```bash
+vlm rollback
+```
+Restores files using the latest log in `~/.vlm/rollback/`.