qiaomu-opencli-autofix

Diagnose and patch OpenCLI adapters with up to three bounded repair rounds.

978|75|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/joeseesun/qiaomu-opencli-skills --skill qiaomu-opencli-autofix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qiaomu-opencli-autofix
Source: https://github.com/joeseesun/qiaomu-opencli-skills/tree/main/qiaomu-opencli-autofix
Command: npx skills add https://github.com/joeseesun/qiaomu-opencli-skills --skill qiaomu-opencli-autofix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically diagnose, patch, and retry OpenCLI adapters when a command fails due to DOM or API changes, reducing manual debugging effort.

Core Features & Use Cases

  • Diagnose failures using OPENCLI_DIAGNOSTIC, read RepairContext, and identify whether the issue is DOM selectors, API responses, or auth/timeouts.
  • Patch adapters with minimal changes, focusing on the authoritative RepairContext.adapter.sourcePath, then re-run the command to verify.
  • Safe, bounded repair workflow with up to 3 repair rounds, explicit stop conditions, and guidance on when not to patch.

Quick Start

Run OPENCLI_DIAGNOSTIC=1 opencli <site> <command> to diagnose and patch the adapter, then retry the command.

Frequently Asked Questions about qiaomu-opencli-autofix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix OpenCLI adapter failures when DOM selectors or API schemas change?

To fix OpenCLI adapter failures from DOM or API changes, run OPENCLI_DIAGNOSTIC=1 to diagnose the issue. The tool identifies whether the failure is caused by selector changes, API schema shifts, or auth timeouts, then applies bounded patches directly to the authoritative adapter source path.

What is the process for diagnosing a broken OpenCLI command?

Diagnosing a broken OpenCLI command involves running the command with OPENCLI_DIAGNOSTIC enabled and reading the RepairContext. This mechanism identifies the specific failure type—DOM selectors, API responses, or auth issues—before attempting any bounded patching.

How many repair rounds does OpenCLI adapter patching allow?

OpenCLI adapter patching allows up to three safe, bounded repair rounds. After each patch modifies the authoritative adapter location, it requires a subsequent re-test of the command to verify the fix before proceeding or stopping at explicit stop conditions.

When should I avoid automatically patching an OpenCLI adapter?

You should avoid patching an OpenCLI adapter when the failure falls outside the scope of selector, API schema, or auth issues. The diagnostic workflow includes explicit stop conditions and guidance on when not to patch if the error is unresolvable within three repair rounds.

Does OpenCLI adapter repair require modifying files outside the adapter source path?

No, OpenCLI adapter repair enforces that patches modify only the authoritative adapter location specified in RepairContext.adapter.sourcePath. This strict boundary ensures minimal, safe changes without affecting external files or system configurations.