coding-guidelines-verify

jMerta 的头像作者 jMerta

验证更改是否遵循最近的范围 AGENTS.md 规则:按嵌套范围分组更改的文件,自动修复格式,运行代码检查/测试,并报告违规情况。当用户希望对更改的文件进行范围合规检查时使用。

📖 中文导读:验证更改是否遵循最近的范围 AGENTS.md 规则:按嵌套范围分组更改的文件,自动修复格式,运行代码检查/测试,并报告违规情况。当用户希望对更改的文件进行范围合规检查时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: coding-guidelines-verify description: "Verify changes follow nearest-scoped AGENTS.md rules: group changed files by nested scope, auto-fix formatting, run lint/tests, and report violations. Use when the user wants scoped compliance checks for changed files."

Coding guidelines verifier

Goal

Validate that changes follow the nearest nested AGENTS.md:

  • default: changed files only
  • default: auto-fix formatting before lint/tests
  • monorepo-aware: each module’s AGENTS.md is the source of truth for that scope

Workflow (checklist)

  1. Collect changed files (staged + unstaged + untracked).
  2. For each changed file, find the nearest parent AGENTS.md.
    • If a file has no scoped AGENTS.md, report it (suggest running coding-guidelines-gen).
  3. Parse the codex-guidelines block (schema: references/verifiable-block.md).
  4. Run, per scope:
    • format (auto-fix) -> lint -> tests
    • apply simple forbid rules (globs/regex) from the block
  5. Produce a short compliance report (template: references/report-template.md).

Automation

Use scripts/verify_guidelines.py to group scopes, run commands, and report results.

  • If python is not available or the script fails, tell the user and ask whether to install Python or proceed with a manual per-scope verification.

Deliverable

Provide:

  • The per-scope compliance report (use references/report-template.md).
  • Any auto-fix formatting changes applied.
  • Lint/test commands run and their results, plus any violations.