aAAaqwq 熵管理 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 ~/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 - 趋势：熵值是否在下降？
- 对比上次：新增了多少熵？
报告格式
# 熵扫描报告 — 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
项目级范围
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