entropy-manager

用途

熵管理 Skill（Entropy Manager）是一个面向代码库的熵扫描工具，用于检测代码库中的混乱与失序，并给出清理建议。其核心信念是：AI 团队每行代码都在增加系统的混乱度，不主动减熵，系统会自然腐败。灵感来源为热力学第二定律、软件工程 hygiene 以及 Daniel "秩序规则" 宪章。

主要能力

工具将熵分为六大分类：

文档熵（DOC）：过时文档、失效链接、空 TODO、错误日期，通过日期检查、TODO 统计、断链检测发现。
命名熵（NAME）：非 kebab-case/snake_case 文件、命名不一致，通过文件名模式匹配发现。
代码熵（CODE）：死代码、注释掉的块、未使用的 import、console.log 遗留，通过 AST/grep 扫描发现。
配置熵（CONF）：过时配置、未使用的 env var、孤立的 agent 配置，通过配置文件交叉验证发现。
文件熵（FILE）：错位文件、tmp 残留、重复文件、空 .gitkeep，通过目录结构验证发现。
依赖熵（DEP）：未使用依赖、过时版本、安全漏洞，通过 package.json/requirements.txt 扫描发现。

严重度分为三级：

🔴 Critical：安全/功能影响，如硬编码密钥、破损的入口文件，需立即处理。
🟡 Warning：维护性影响，如死代码>50行、过时 TODO>10个，需本周处理。
🟢 Info：美观/一致性，如命名不统一、空文件，下次顺手修。

使用方式

触发条件包括：手动触发（熵扫描 / entropy scan / 减熵 / 清理）；定期触发（建议每周一次 cron，entropy-weekly-scan）；重大变更后（项目上线、大规模重构后）。

执行流程分为四个阶段：

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，追踪熵值是否下降、对比上次新增了多少熵。

报告格式包含总评分、分类得分表、Critical/Warning/Info 问题列表以及趋势分析。

扫描范围：默认范围为 ~/clawd/（工作主目录，排除 .git、node_modules、venv）、~/.openclaw/agents/（Agent 配置）、~/.openclaw/skills/（全局 Skills）。项目级范围可指定，如 entropy-scan.sh ~/clawd/projects/blue-blood-elite/。

适用场景

适用于需要定期维护代码库整洁度的团队或个人，尤其是使用 AI 团队协作开发的项目。可在项目上线、大规模重构后执行扫描，也可通过每周 cron 定期扫描，持续追踪熵值变化趋势。

限制

依赖 bash 4+、Python 3.11+（用于复杂分析脚本）、git（用于历史对比）。自动修复仅针对 🟢 级别问题，且需确认后执行。与宪章的关系：秩序规则第 8 条 — 熵管理秩序，要求每周至少一次全系统熵扫描，Critical 级别问题不过夜。

文件结构：

entropy-manager/
├── SKILL.md              # 本文件
├── scripts/
│   ├── entropy-scan.sh   # 主扫描脚本
│   └── entropy-fix.sh    # 自动修复脚本（需确认）
└── README.md

技能介绍

用途

主要能力

使用方式

适用场景

限制