ocr delegate preview fails with unknown flag: --format (mismatch with SKILL.md added in commit b1c7c6a)

[d2kx]

OpenCodeReview Version

open-code-review v1.8.10 (4bcc95a)

Operating System

Linux (x86_64)

Installation Method

npm (global)

LLM Provider

Other OpenAI-compatible endpoint

Bug Description

Commit b1c7c6a updated open-code-review-delegate/SKILL.md to instruct host agents to execute ocr delegate preview --format json. However, the CLI binary's command parser for delegate preview does not accept --format. Either --format needs to be implemented in the CLI binary for delegate preview, or --format json should be removed from SKILL.md.

Steps to Reproduce

1. Install the latest open-code-review CLI tool and install/enable the open-code-review-delegate skill in a coding agent (e.g., QwenCode).
2. Prompt the agent to run a code review using delegation mode.
3. The host agent reads SKILL.md and attempts to execute: ocr delegate preview --format json
4. Observe the command failure due to an un-recognized --format flag.

Expected Behavior

Either:

1. ocr delegate preview should accept the --format json flag and return machine-readable JSON output as documented/instructed in skills/open-code-review-delegate/SKILL.md.
   OR
2. If --format is not intended for ocr delegate preview, skills/open-code-review-delegate/SKILL.md should be updated to remove --format json so agents do not invoke invalid CLI arguments.

Logs / Error Output

Command: ocr delegate preview --format json
Directory: (root)
Output: Error: unknown flag: --format
Error: (none)
Exit Code: 1

Additional Context

• PR / Commit reference: Commit b1c7c6a updated SKILL.md and QCA templates to explicitly instruct host agents to pass --format json.
• Agent impact: When host agents run into this error, they are forced to catch the non-zero exit code, fall back to executing ocr delegate preview --help, and re-run the command without --format json.

[amh1k]

Working on this issue

[jon-devlapaz]

Independently reproduced this with open-code-review v1.8.10 (4bcc95a) on macOS/arm64 after a global npm installation of @alibaba-group/open-code-review.

The agent skill instructed:

ocr delegate preview --format json

Result:

Error: unknown flag: --format

ocr delegate preview --help lists no format flag, and rerunning ocr delegate preview without --format json succeeds and emits the workspace review manifest in text form. This breaks the documented delegation workflow on Codex as well; the host agent must detect the failure and fall back manually.