---
name: entropy-manager
description: Entropy scanner for codebases — detect disorder and suggest cleanup actions
---
# 熵管理 Skill (Entropy Manager)
> **核心信念**：AI 团队每行代码都在增加系统的混乱度。不主动减熵，系统会自然腐败。
> 灵感来源：热力学第二定律 × 软件工程 hygiene × Daniel "秩序规则" 宪章
## 触发条件
- 手动触发：`熵扫描` / `entropy scan` / `减熵` / `清理`
- 定期触发：建议每周一次 cron（`entropy-weekly-scan`）
- 重大变更后：项目上线、大规模重构后
## 熵的 6 大分类
| # | 类别 | 代号 | 说明 | 检测方式 |
|---|------|------|------|----------|
| 1 | **文档熵** | `DOC` | 过时文档、失效链接、空 TODO、错误日期 | 日期检查、TODO 统计、断链检测 |
| 2 | **命名熵** | `NAME` | 非 kebab-case/snake_case 文件、命名不一致 | 文件名模式匹配 |
| 3 | **代码熵** | `CODE` | 死代码、注释掉的块、未使用的 import、console.log 遗留 | AST/grep 扫描 |
| 4 | **配置熵** | `CONF` | 过时配置、未使用的 env var、孤立的 agent 配置 | 配置文件交叉验证 |
| 5 | **文件熵** | `FILE` | 错位文件、tmp 残留、重复文件、空 .gitkeep | 目录结构验证 |
| 6 | **依赖熵** | `DEP` | 未使用依赖、过时版本、安全漏洞 | package.json/requirements.txt 扫描 |
## 严重度分级
| 级别 | 定义 | 示例 | 处理时限 |
|------|------|------|----------|
| 🔴 **Critical** | 安全/功能影响 | 硬编码密钥、破损的入口文件 | 立即 |
| 🟡 **Warning** | 维护性影响 | 死代码>50行、过时 TODO>10个 | 本周 |
| 🟢 **Info** | 美观/一致性 | 命名不统一、空文件 | 下次顺手修 |
## 执行流程
### Phase 1: 扫描诊断
```bash
bash ~/clawd/skills/entropy-manager/scripts/entropy-scan.sh [target_dir]
```
输出：`~/clawd/tmp/entropy-report-YYYY-MM-DD.md`
### Phase 2: 报告生成
扫描结果汇总为：
- 总熵值评分（0-100，100=完美）
- 各分类得分
- Top 10 高熵文件
- 自动可修复项 vs 需人工确认项
### Phase 3: 自动修复（需确认）
对 🟢 级别问题自动修复（需 CEO 确认后执行）：
- 重命名文件到规范格式
- 删除空 .gitkeep（目录有内容时）
- 清理 tmp/ 超过 7 天的文件
- 移除注释代码块（>10行连续注释代码）
### Phase 4: 记录追踪
- 每次扫描结果追加到 `~/clawd/tmp/entropy-history.jsonl`
- 趋势：熵值是否在下降？
- 对比上次：新增了多少熵？
## 报告格式
```markdown
# 熵扫描报告 — YYYY-MM-DD
## 📊 总评分: 72/100 (较上次 +5)
| 分类 | 得分 | 问题数 | Critical | Warning | Info |
|------|------|--------|----------|---------|------|
| DOC | 65 | 12 | 0 | 4 | 8 |
| NAME | 80 | 5 | 0 | 1 | 4 |
| CODE | 70 | 8 | 1 | 3 | 4 |
| CONF | 85 | 3 | 0 | 1 | 2 |
| FILE | 60 | 10 | 0 | 5 | 5 |
| DEP | 75 | 4 | 0 | 2 | 2 |
## 🔴 Critical (立即处理)
1. [CODE] ~/clawd/projects/xxx/config.py:5 — 硬编码 API key
## 🟡 Warning (本周处理)
1. [DOC] ~/clawd/MEMORY.md — 3 个 TODO 超过 30 天未更新
2. [FILE] ~/clawd/tmp/ — 15 个文件超过 7 天
## 🟢 Info (下次顺手修)
1. [NAME] ~/clawd/scripts/api_health_check.py → 建议 api-health-check.py
## 📈 趋势
- 上次扫描: 67/100 (YYYY-MM-DD)
- 变化: +5
- 熵增最快: FILE (+8 问题)
- 熵减最快: CODE (-3 问题)
```
## 扫描范围
### 默认范围
```
~/clawd/ # 工作主目录（排除 .git, node_modules, venv）
~/.openclaw/agents/ # Agent 配置
~/.openclaw/skills/ # 全局 Skills
```
### 项目级范围
```bash
entropy-scan.sh ~/clawd/projects/blue-blood-elite/
```
## 与宪章的关系
**秩序规则第 8 条 — 熵管理秩序**：
> 系统自然趋向混乱。AI 团队每行代码都在增加熵值。不主动减熵，等于慢性自杀。
> 每周至少一次全系统熵扫描，Critical 级别问题不过夜。
## 依赖
- bash 4+
- Python 3.11+（用于复杂分析脚本）
- git（用于历史对比）
## 文件结构
```
entropy-manager/
├── SKILL.md # 本文件
├── scripts/
│ ├── entropy-scan.sh # 主扫描脚本
│ └── entropy-fix.sh # 自动修复脚本（需确认）
└── README.md
```