熵减审查
SkillDocs & knowledgeLets your agent audit a repository for bloat, overlapping rules, and stale conventions, then write a review report.
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the 熵减审查 skill
About this skill
Periodically reviews software entropy growth in the agent-infra repository and outputs a structured entropy-reduction review report. Use when the repository needs to identify rule overlap, documentation bloat, dead conventions, and version-scatter risks before a release or during a maintenance windo
What this skill tells your AI
The instructions your AI receives, as published by fitlab-ai/agent-infra in .agents/skills/entropy-check/SKILL.md and read by ahel’s review.
行为边界 / 关键规则
- 本技能是 agent-infra 仓库本地维护技能,不属于
update-agent-infra分发模板。 - 本技能不修改业务代码、规则、skill 或文档;只创建一份审查报告。
- 报告写入
.agents/workspace/logs/entropy-check/entropy-check-YYYYMMDD-HHMMSS.md。 - 发现项只给出证据与建议,不自动创建任务、不自动改文件。
- 不确定的边界选择写入报告的
## 人工裁决待办,不中途向用户提问。
执行步骤
1. 创建报告目录并做状态核对
创建输出目录:
mkdir -p .agents/workspace/logs/entropy-check
运行并记录以下命令,原文写入报告 ## 状态核对:
git status -s
git branch --show-current
date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
2. 读取审查参考
执行审查前先读取:
reference/checklist.mdreference/report-template.md
3. 收集证据
按 checklist 收集证据,至少覆盖:
.agents/rules/issue-sync.md.agents/rules/issue-pr-commands.md.agents/rules/issue-fields.md.agents/rules/pr-sync.md.agents/rules/pr-checks-commands.md.agents/rules/create-issue.md.agents/skills/*/SKILL.mdtemplates/.agents/skills/**- 仓库源码、规则、Skill 与模板中的
TODO(compat) package.json.agents/.airc.json- 版本发布相关文档与脚本
使用 rg、find、wc -l、git status 等可复现命令收集证据,并把关键命令原文写入报告。
4. 执行语义审查
根据 reference/checklist.md 逐项判断是否存在软熵增:
- 规则职责重叠或边界漂移
SKILL.md膨胀且应拆分到reference/- over-design、死约定或重复规则
- 临时兼容 TODO 缺少删除对象、可验证条件,或删除条件已经满足
- bilingual 命名约定混用且缺少边界说明
- version 号散落导致漂移风险
每条发现必须包含证据、影响、建议和严重度。只有发版前必须处理的问题才标记为 release-blocking。
5. 写入报告
按 reference/report-template.md 创建报告:
report=".agents/workspace/logs/entropy-check/entropy-check-$(date "+%Y%m%d-%H%M%S").md"
报告必须保留结构化章节,便于发版流程引用报告路径并让维护者裁定后续任务。
6. 输出结论
输出报告路径和发现统计。若存在 release-blocking 发现,明确提示当前发版流程应先处理或由维护者裁定后继续。
Signals
- GitHub stars
- 86
- Forks
- 5
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
entropy-check- Source
- github.com/fitlab-ai/agent-infra
github.com/fitlab-ai/agent-infra
More in Docs & knowledge
Skill · mattpocock
More in Docs & knowledgecanvas-design
Skill · anthropics
More in Docs & knowledgedoc-coauthoring
Skill · anthropics
More in Docs & knowledgewriting-for-agents
Skill · mattpocock
More in Docs & knowledgespec-driven-development
Skill · addyosmani
More in Docs & knowledgedefuddle
Skill · kepano
More in Docs & knowledge