Agent Skills › Stanshy/AgentHub › harness-audit

harness-audit

GitHub

周期性审计项目Harness健康状态，基于七大原则检查CLAUDE.md、Hook、Skill及Knowledge配置，输出评分与改进建议。

.knowledge/company/skill-templates/harness-audit/SKILL.md Stanshy/AgentHub

Trigger Scenarios

用户输入/harness-audit命令需要评估当前项目AI助手配置完整性时

Install

npx skills add Stanshy/AgentHub --skill harness-audit -g -y

More Options

Non-standard path

npx skills add https://github.com/Stanshy/AgentHub/tree/main/.knowledge/company/skill-templates/harness-audit -g -y

Use without installing

npx skills use Stanshy/AgentHub@harness-audit

指定 Agent (Claude Code)

npx skills add Stanshy/AgentHub --skill harness-audit -a claude-code -g -y

安装 repo 全部 skill

npx skills add Stanshy/AgentHub --all -g -y

预览 repo 内 skill

npx skills add Stanshy/AgentHub --list

SKILL.md

Frontmatter

{
    "name": "harness-audit",
    "description": "Periodic Harness health audit based on 7 design principles",
    "allowed-tools": "Read, Glob, Grep, Bash"
}

Harness 健康審計

週期性檢查專案 Harness（CLAUDE.md + Hook + Skill + Knowledge）的健康狀態。

使用方式

/harness-audit

參數

無（操作當前專案）

檢查項目（七大原則）

原則 1: 上下文架構（給地圖不給百科全書）

CLAUDE.md 行數 ≤ 100（超過 = 警告）
CLAUDE.md 有文件索引且索引完整
.knowledge/ 文件都在索引中登記

原則 2: 架構約束（用工具強制不靠 prompt）

掃描 CLAUDE.md 中的「禁止」「不得」等文字規則
檢查是否有對應 Hook 強制（.claude/settings.json）
未被 Hook 覆蓋的文字規則列出建議

原則 3: 知識層級（公司 vs 專案）

.knowledge/company-rules.md 存在
.knowledge/team-workflow.md 存在
專案級規範與公司級不衝突

原則 4: 技能即流程（Skill 覆蓋）

~/.claude/commands/ 或 .claude/commands/ 目錄存在且有 skill 檔案
掃描已部署的 Skill 數量
列出未部署但可用的公司 Skill（對照 AgentHub skill-templates/）

原則 5: Hook 健康

.claude/settings.json 存在且 JSON 合法
Stop hook 存在
PreToolUse hook 存在（forbidden-commands）
Hook 腳本檔案存在且可執行

原則 6: 文件新鮮度

.knowledge/ 下各文件最後修改日期
超過 30 天未更新的文件標記為「可能過時」

原則 7: 整體評分

每個原則 0-2 分（0=缺失, 1=部分, 2=完善）
總分 /14，≥10 = 健康，7-9 = 需改善，<7 = 警告

輸出格式

# Harness 健康審計報告

**專案**: {project-name}
**日期**: {today}
**總分**: {score}/14

## 評分明細
| 原則 | 分數 | 說明 |
|------|------|------|
| 1. 上下文架構 | {0-2} | {detail} |
| 2. 架構約束 | {0-2} | {detail} |
| 3. 知識層級 | {0-2} | {detail} |
| 4. 技能覆蓋 | {0-2} | {detail} |
| 5. Hook 健康 | {0-2} | {detail} |
| 6. 文件新鮮度 | {0-2} | {detail} |
| 7. 整體完整性 | {0-2} | {detail} |

## 行動項目
1. {highest priority action}
2. {second priority action}
...