Agent Skills
返回列表
Harness 规则审查器

Harness 规则审查器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_429459cf/harness-rule-reviewer。

技能介绍

要解决的问题

AI 编码助手的指令文件很容易腐烂。CLAUDE.md、AGENTS.md 和 rules/*.md 通常从 README 复制、在 review 里顺手补一句、或者为某个紧急需求临时加规则，结果入口文件变成第二份文档，规则目录里混着常识、重复约定和已经过期的任务信息。没人愿意逐行判断哪条还值钱；项目同时用 Claude Code 和 Codex 时，两套配置还可能给出互相矛盾的指令。

核心能力与工作步骤

这个技能做的是指令层静态审查，不碰源代码和 CI 配置。流程先扫描根目录、.claude/rules/、.codex/rules/ 以及子目录覆盖文件，再按三项测试处理每条规则：必要性看它是否挡下真实且反复发生的问题；清晰性看新成员能否无上下文理解；可执行性看是否告诉模型具体怎么做，而不是只说“要写好代码”。

审查结果会汇总成 Markdown 报告，包括结构评估、冗余检测、必要性评分、文件大小与最长行检查、规则冲突、可执行性、死链和跨平台一致性。报告按 P0 到 P2 给出行动清单：先删除或修复冲突，再合并重复规则，最后才考虑补规则。对迁移中的项目，它也能对比 CLAUDE.md 与 AGENTS.md，把同一条约定不一致的地方标出来。

适用边界与注意点

它不是代码审查工具，不会检查实现、测试脚本或构建配置，也不负责校验非 Markdown 文件的语法。规则文件应该保持约束性质：给出最小必要约束并指向文档，而不是写成 300 行教程。另外要注意生效范围，子目录配置会覆盖根目录，项目配置会覆盖用户级配置，因此审查时必须按目录层级看优先级。

使用场景

  • 刚创建或修改 `CLAUDE.md`、`AGENTS.md`，需要审查结构、必要性、清晰度和死链，再决定是否合并或精简章节。
  • 新增 `.claude/rules/` 或 `.codex/rules/` 规则后，需要检测与其他规则的冲突、冗余，以及是否存在不可执行的模糊约束。
  • 项目同时维护 Claude Code 和 OpenAI Codex 配置，需要对比构建命令、测试命令、代码风格等指令是否一致。
  • 准备从 Claude Code 迁移到 Codex，或反过来迁移，需要审查入口配置、规则文件和层级覆盖是否会产生行为差异。

适合人员

  • 使用 Claude Code 或 OpenAI Codex 的开发工程师，希望在提交配置前确认规则不会冗余、冲突或过度约束模型。
  • 维护 monorepo 或多目录项目的技术负责人，需要检查根配置、子目录配置和规则文件之间的覆盖关系。
  • 负责团队 AI 编码规范的工程管理者，需要定期审计 `CLAUDE.md`、`AGENTS.md` 和 `rules/*.md` 是否仍然必要。
  • 正在迁移 AI 编码助手平台的开发者，需要定位两套配置文件中的命令、风格和层级差异。