AgentSkillsCN

x07-lint-repair

通过快速修复（`x07 fix`）或显式 JSON Patch（`x07 ast apply-patch`）对 X07 x07AST JSON 进行语法检查与优化。

SKILL.md
--- frontmatter
name: x07-lint-repair
description: Lint X07 x07AST JSON and converge via quickfixes (`x07 fix`) or explicit JSON Patch (`x07 ast apply-patch`).
metadata:
  short-description: Lint + fix + patch loop
  version: 0.1.0
  kind: docs

x07-lint-repair

Use this skill when an X07 file fails linting and the agent needs a repeatable converge loop.

Note: x07 run, x07 build, and x07 bundle run the same auto-repair loop by default (--repair=...). Use this skill when you want raw diagnostics or tighter control.

Canonical converge loop

  1. •

    Lint (machine-readable JSON report):

    • •x07 lint --input src/main.x07.json --report-json
  2. •

    Apply tool-provided quickfixes (when diagnostics include JSON Patch quickfixes):

    • •x07 fix --input src/main.x07.json --write --report-json
  3. •

    If a custom fix is needed, apply an explicit JSON Patch (RFC 6902):

    • •x07 ast apply-patch --in src/main.x07.json --patch /tmp/repair.patch.json --validate
  4. •

    Canonicalize after patching:

    • •x07 fmt --input src/main.x07.json --write --report-json

Repeat (max 3 iterations). If still failing, stop and change strategy (reduce scope, regenerate the x07AST cleanly, or ask for clarification).