用途:依据项目的 COMMANDMENTS.md 审查本次改动的代码风格与可读性约定,审查对象为当前分支、PR 或未提交改动,输出一份逐条清单:每条适用戒律标注状态,违规处引用 file:line 并给出具体修复。干净的 diff 是合法结果,不得编造问题。该技能只检查 linter 无法覆盖的内容,不重复 oxlint / oxfmt / knip 已强制的问题,也不提议格式上的无谓改动。
主要能力与流程:先按 repo 根目录 COMMANDMENTS.md、docs/COMMANDMENTS.md、~/.agents/docs/commandments.md 的顺序查找并通读规则,跳过“Beyond style”章节及简介中标注由 linter 强制的内容;若均不存在则停止并告知用户。再解析参数确定范围:PR 引用用 gh pr diff N -R owner/repo 与 gh pr view N -R owner/repo --json title,body,headRefName,files;无 PR 则审查本地改动,即 git diff、git diff --staged、git status --porcelain 的未跟踪文件,以及通过 git merge-base HEAD origin/HEAD(回退 origin/main、main)确定基线后的 git diff <base>...HEAD。--full 审查每个改动文件全文,默认按 diff。开始前用一行向用户确认范围。
逐条核对:由 LLM 引导而非扫描器,针对每条戒律读取规则与自检项、查看改动代码并分类,必要时用 Grep/Read 获取上下文。超过约 15 个改动文件时用 Agent 工具按文件组分发子智能体,子智能体只做调研不编辑。严重度按概率×后果校准,多数可读性发现为 LOW 或 MEDIUM,仅真实正确性或可维护性陷阱为 HIGH。评级最高的是第 1 条可读性。评论类严格按第 13-14 条执行评论清扫:列出 diff 新增的所有评论行(含测试文件),逐条判定;.test. 文件中的任何评论均属违规,应把意图并入 it(...)/describe(...) 标题后删除。对分层与单一职责(第 2、3 条)只给建议与目标位置,不擅自重构。格式化工具能修或能捕获的问题直接剔除。
报告:按戒律编号分组输出完整清单,状态含 PASS、VIOLATION、NEEDS REVIEW、N/A;给出 CLEAN、MINOR(仅 LOW)或 NEEDS WORK(存在 MEDIUM+)的总体结论。仅当用户传 --fix 或看报告后要求时才应用修复,从小到大、保持最小 diff,第 2、3 条相关改动只列为建议;修复后运行 pnpm run check 并报告结果。
适用场景:需要在代码评审或提交前按项目自有可读性约定做一次人工式、可追溯的检查时。限制:必须存在 COMMANDMENTS.md,否则无法执行;依赖 gh、git 等命令行工具与项目约定文件;不替代 linter,也不自动改动分层结构。收费、价格与具体平台支持等信息暂未提供。