From aigroup-workflow
Automates codebase health maintenance by detecting architecture drift, outdated docs, and low-quality code. Prevents tech debt accumulation via systematic cleanup after tasks or on suspected degradation.
How this skill is triggered — by the user, by Claude, or both
Slash command
/aigroup-workflow:entropy-managementThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
AI Agent 会复制仓库中已有的模式——包括不好的模式。随着时间推移,这不可避免地导致漂移。
AI Agent 会复制仓库中已有的模式——包括不好的模式。随着时间推移,这不可避免地导致漂移。 手动清理不可持续。熵管理将清理系统化,定期执行,像垃圾回收一样防止技术债积累。
核心原则:技术债是高利贷——持续小额偿还远优于积累后大规模清理。
发现的问题不能只修一次——必须同时编码为约束,防止再次发生。
每次熵管理运行结束后,必须更新质量评分和技术债追踪。
code-reviewer 审查中反复出现同类问题(模式漂移信号)运行 Harness 传感器套件收集机器可检测的问题:
node scripts/hooks/dispatcher.cjs stop
记录所有 [FAIL] 和 [WARN] 项。
自动化传感器无法覆盖的维度,需要人工/Agent 推理检查:
| 检查项 | 方法 |
|---|---|
| CLAUDE.md 引用路径是否有效 | 逐条验证文件/目录存在 |
| docs/ 文档描述是否匹配实际行为 | 抽样对比 |
| SKILL.md 中的流程是否被实际遵循 | 回顾近期任务记录 |
| 模板是否与当前实践一致 | 对比模板与近期产出 |
| 检查项 | 方法 |
|---|---|
| 是否有文件放在错误目录 | 检查目录约定是否被遵守 |
| 是否有重复/冗余文件 | 搜索相似文件名和内容 |
| 技能包结构是否一致 | 抽样检查 SKILL.md 格式 |
| 协作产物是否在正确位置 | 检查 .orchestration// 结构 |
| 检查项 | 方法 |
|---|---|
| 近期审查中的高频问题 | 分析 .orchestration//code-reviewer/ |
| 是否有被跳过的工作流阶段 | 检查产物完整性 |
| 是否有"沉默的传感器"(从不报错) | 评估传感器有效性 |
对发现的问题分类处理:
| 问题类型 | 处理方式 |
|---|---|
| 可快速修复的具体问题 | 立即修复(文档更新、文件移动等) |
| 需要编码为约束的重复模式 | 在 scripts/hooks/checks/ 加 check,让违规自动触发 [FAIL] |
| 需要架构讨论的系统性问题 | 与用户讨论;动手前先达成共识 |
把本次发现和处理沉淀到下列位置(按相关性挑,不必每次都全做):
scripts/hooks/checks/ 加自动化 checkdocs/PROJECT_CONTEXT.md 或 docs/ARCHITECTURE.mddocs/rules/<topic>.md 或 docs/red-flags.md~/.claude/projects/<slug>/memory/,自动加载)docs/red-flags.mddocs/rules/<topic>.md每次熵管理运行后,应产出:
✅ dispatcher 扫描结果(node scripts/hooks/dispatcher.cjs stop)
✅ 推理型扫描发现清单
✅ 修复的问题列表
✅ 新增的约束 / check / 规则文档(如有)
| 信号 | 行动 |
|---|---|
| 传感器全部通过但直觉上代码库有问题 | 传感器覆盖不足,加新 check |
| 修复一个漂移又发现三个 | 可能是架构问题,先与用户讨论再动 |
| 反复出现同类问题但没有沉淀为约束 | 必须在 scripts/hooks/checks/ 加自动检测 |
npx claudepluginhub codeape-7/ai-agent-workflowgroupAudits a repo for AI-readiness, scoring ~20 dimensions across Foundation, Why, What, Hygiene, and Sync. Use when inheriting a legacy repo or asking "is this repo agent-ready?"
Reviews Claude Code plugins, skills, codebases, and docs in modes like quick scans, git commit tidying, deep skill analysis, holistic cross-plugin checks, and docs consistency.
Audits entire codebase for structural quality, file sprawl, thin wrappers, leaked logic, spaghetti growth, and dependency freshness via context7. Encourages code-judo simplifications.