熵减审查

SkillDocs & knowledge

Lets 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.

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.md
  • reference/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.md
  • templates/.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