Adapter audit skill#

Use this skill when you want to systematically audit and fix CLI adapter projects — for example, scanning all search adapters in opencli for missing url fields and batch-generating patches.

When to use#

• auditing adapter output schemas for missing fields (url, timestamp, thumbnail, etc.)
• generating batch fixes across many adapters at once
• preparing multi-file PRs to upstream projects
• maintaining output consistency across a large adapter registry

Core workflow#

1. Scan#

Scan all adapters in the target project and classify each by:

• adapter type (YAML declarative vs TS/JS coded)
• which output fields are present
• which standard fields are missing

Standard fields to check:

• url — direct link to the content item
• title — content title
• author — creator/author name
• timestamp / date — publish or capture time

2. Classify fix type#

For each missing field, determine the fix strategy:

SituationFix strategyField is computed internally but not in columnsAdd to columns listField is computed but stripped by a map stepPass through the map step + add to columnsField is not computed but can be constructed from existing dataAdd construction logic + add to columnsField requires external data not available in the API responseSkip or mark as "needs upstream API change"

3. Fix#

Apply fixes using the minimum change principle:

• For YAML adapters: add field to return object + map step + columns array
• For TS adapters: add field to return object + columns array
• Never change existing fields or behavior
• Only add new fields

4. Verify#

After fixing, run the project's existing tests:

bash

npm run build    # ensure TS compiles
npm test         # ensure nothing breaks

5. Submit#

Create a single well-documented PR with:

• clear title describing the scope
• table showing before/after coverage
• per-adapter fix type classification
• risk assessment (should always be "additive only")

Proven example#

This skill was used to audit opencli's 33 search adapters:

• Before: 22/33 (67%) had url in output
• After: 32/33 (97%) had url in output
• Fix types used: columns-only (3), map-passthrough (2), construct-from-data (4)
• Files changed: 9
• Lines changed: +17 / -10
• PR: merged within hours, all CI green

Output contract#

The audit output should include:

1. total adapters scanned
2. per-adapter field coverage table
3. fix strategy for each missing field
4. list of files changed
5. before/after coverage metrics
6. risk classification

Key rules#

• Never modify existing output fields — only add missing ones
• Prefer constructing URLs from existing API data over adding new API calls
• Skip fields that genuinely don't apply (e.g., url for dictionary word lookup)
• Always verify the constructed URL format is correct for the platform
• Group all fixes into a single PR for easier review

Quick invocation template#

text

Use /adapter-audit to scan all search adapters in this CLI project for missing url fields, fix them, and prepare a PR.

text

请用 /adapter-audit 扫描这个 CLI 项目里所有 search adapter 的缺失字段，批量修复并准备 PR。