内容
# cc-audit
一款用于审计Claude Code设置的Claude Code技能,可以通过一条命令检查模型配置、MCP服务器、规则膨胀、缓存效率和上下文使用情况。
## 检查内容
| 类别 | 详情 |
|----------|---------|
| **静态配置** | 默认模型、钩子覆盖率、MCP数量 |
| **规则膨胀** | 行数统计、项目特定规则泄漏到全局 |
| **会话分析** | 缓存命中/未命中、空闲时间、上下文百分比、模型切换、图像引起的缓存中断、/compact使用情况 |
| **官方最佳实践** | 实时搜索Claude Code文档 - 将您的设置与当前推荐进行比较 |
## 安装
将以下内容粘贴到任何Claude Code会话中:
```
请安装此技能:https://github.com/danyuchn/cc-audit
步骤:
1. git clone https://github.com/danyuchn/cc-audit /tmp/cc-audit-install
2. mkdir -p ~/.claude/skills/cc-audit
3. cp /tmp/cc-audit-install/SKILL.md ~/.claude/skills/cc-audit/
4. rm -rf /tmp/cc-audit-install
```
或手动:
```bash
mkdir -p ~/.claude/skills/cc-audit
curl -fsSL https://raw.githubusercontent.com/danyuchn/cc-audit/main/SKILL.md \
-o ~/.claude/skills/cc-audit/SKILL.md
```
## 使用
安装后,通过以下任意命令触发:
```
/cc-audit
健诊
帮我审查 Claude Code
quota 检查
```
## 示例输出
```
### 1. 设置快照
默认模型: sonnet ✅
钩子: PreToolUse / PostToolUse / PostCompact / TaskCreated ✅
MCP 数量: 6
### 2. 会话健诊
项目 模型 空闲(分) CacheMiss 图破缓存 Context% 换模型 /compact 轮数
knowledge-base claude-sonnet-4-6 ✅ 3.8 ✅0 ✅0 ✅ 33.0% ✅ - 42
claude-course claude-sonnet-4-6 🟡 13.6 🟡2 ✅0 🟡 92.6% ✅ 🟡 84
### 3. 官方最佳实践 vs 目前设置
📌 ...(实时查询官方文档)
### 5. 可执行建议
🔴 wordpress.md 在 global rules → 移到项目的 .claude/rules/
🟡 claude-course context 超 80% 但未 /compact → 养成 60% 就压缩的习惯
```
## 工作原理
- **静态检查**:读取 `~/.claude/settings.json` 和 `~/.claude.json`
- **会话分析**:解析 `~/.claude/projects/` 中最近的 5 个 JSONL 文件
- **缓存检测**:`cache_creation_input_tokens` 峰值 + `cache_read_input_tokens` 下降 = 确认缓存未命中
- **上下文百分比**:`(input + cache_create + cache_read) / 200,000`
- **官方文档**:实时 WebSearch 对抗 `code.claude.com` 和 `docs.anthropic.com`
## 要求
- 具有有效订阅的Claude Code
- Python 3(预安装在 macOS/Linux 上)
- `gh` CLI(仅在您想贡献时需要)