Harness-Audit Skill：给 AI coding 项目做一次”体检”，专治 agent 越来越慢

Harness-Audit Skill：给 AI coding 项目做一次”体检”，专治 agent 越来越慢

很多开发者装了五六个 skill、十几条 rules、满满当当的 CLAUDE.md，却发现 agent 越来越迟钝——每次对话都要先读一堆”历史包袱”。harness-audit 正是来解决这个问题的：它扫描你项目的 agent 配置文件，告诉你哪里是性能瓶颈，并给出可以直接复制粘贴的修复代码。

功能与设计原则

harness-audit 是一个 Agent Skill（基于 Agent Skills 开放标准），专门审计 AI coding 项目 harness 的完整性。它用程序化方式检查关键 hooks、验证指示文件、检测持久记忆系统信号，并审查 CI/pre-commit/init.sh 等基础设施。核心原则是：每次让 agent 开始工作前，先确认它不需要加载垃圾内容。

认可度

• GitHub 星数：截至 2026-09-18 约 320+ 星
• 定位：2026 年 9 月新上榜 GitHub trending，是当前 agent tooling 基础设施热潮中的实用工具
• 兼容 agent：Claude Code、Codex、Cursor、Antigravity CLI（Gemini CLI 的继承者）

链接

GitHub：https://github.com/fmslutions/harness-audit

原作者

fmslutions（GitHub username），专注于 AI coding 工具链效率优化领域。

介绍

大多数 AI coding 项目在引入 agent 协作后会经历一个”配置积累”阶段：CLAUDE.md 从几行变成几百行，rules 目录塞满各种指南，hooks 层层叠加。表面上看项目”越来越智能”，实际上 agent 每轮对话都要先消化这些内容才能开始工作，导致响应变慢、上下文利用率下降。

harness-audit 的思路是把这个问题可视化。它从五个维度给项目的 harness 打分：Instructions（指令）、State（状态）、Verification（验证）、Scope（范围）、Lifecycle（生命周期）。每个维度有具体检查项，分数一目了然。审计完成后，它不只告诉你哪里有问题，还直接给出可粘贴的配置片段作为修复起点。

另一个设计亮点是”防退化机制”（guardrails）：审计会安装检查点，防止项目在后续开发中重新陷入混乱。这意味着团队里任何成员引入的新 skill 或规则都会被自动监控，不会悄悄拖慢 agent。

特点

• 五维评分体系：Instructions / State / Verification / Scope / Lifecycle，每个维度独立打分，定位最大瓶颈
• 可执行修复建议：输出带优先级的修复清单，每条建议附可直接粘贴的配置片段，不需要开发者自己摸索
• 防退化 guardrails：安装后持续监控 harness 状态，防止项目再次积累冗余配置
• 多 agent 兼容：支持 Claude Code、Codex、Cursor、Antigravity CLI，技能以 GitHub 存储库形式分发，安装后即插即用
• 支持 Obsidian 集成：如果项目使用 Obsidian 做知识管理，harness-audit 也能扫描相关配置
• 前置检查强制执行：审计前强制执行 lint+build 验证基准、检查 git status、阅读相关规范，确保数据真实可用

使用方法

安装（在 Claude Code 中）：

npx skills add fmslutions/harness-audit

或者在项目目录直接运行：

npx skills add https://github.com/fmslutions/harness-audit

执行审计：

进入项目目录，运行 skill，它会自动扫描以下内容：

• .claude/settings.json 中的关键 hooks（Stop、PostToolUse）
• CLAUDE.md 或 AGENTS.md 的文件长度与模块化程度（超过 200 行会被标记）
• 持久记忆系统信号（.memobank、mem0/letta 引用、MEMORY.md）
• CI 配置（.github/workflows）、pre-commit hooks、init.sh、会话纪律要求

解读结果：

审计会输出类似这样的评分卡（以 2026-09-18 典型输出为例）：

=== Harness Audit: my-project ===
Instructions   4/5  ✓ CLAUDE.md present, modular rules in .claude/rules/
                ✗ No project-level REVIEW.md for PR review guidance
State          2/5  ✓ .claude/handoffs/ exists (3 files)
                ✗ No PROBLEMS.md — issues scattered
                ✗ No feature_list.json
Verification   3/5  ✓ Tests run, pytest configured
                ✗ No init.sh
Scope          3/5  ✓ no-pre-existing-evasion principle in CLAUDE.md
                ✗ No WIP=1 enforcement
Lifecycle      2/5  ✗ No SessionStart hook
Bottleneck: State (2/5)

根据瓶颈维度，开发者可以优先修复最高优先级的配置项，而不是眉毛胡子一把抓。

使用场景与目标用户

• 新项目初始化：在为团队新建 Claude Code/Codex 项目时，用 harness-audit 确保 harness 从一开始就结构清晰
• 现有项目诊断：agent 越来越慢但找不到原因时，用它做一次全面体检
• 多成员团队：多人协作的代码库，harness-audit 的 guardrails 能防止个人配置悄悄破坏整体效率
• 目标用户：使用 Claude Code、Cursor、Codex 等 AI coding agent 的开发者，尤其是工程团队 leader 或 DevOps 负责 agent 效能优化的人

输入与输出案例

输入：在项目目录运行 harness-audit 后得到完整评分卡

输出（节选）：

Lifecycle 2/5 ✗ No SessionStart hook
             ✗ No Stop hook for clean-state check
~ Manual cleanup convention exists but not enforced

Bottleneck: Lifecycle (2/5) — lack of structured session management

开发者根据这个结果，在 .claude/settings.json 中添加 SessionStart hook 来恢复会话上下文，问题即解决。

harness-audit 的价值在于把 agent harness 从”越堆越乱”变成”可控可测量”——它是 2026 年 AI coding 工具链走向工程化、可持续的一个重要信号。随着 agent 在团队开发中承担的任务越来越重，这类基础设施工具的需求会持续增长。

GitHub: https://github.com/fmslutions/harness-audit