OctoEvaluate

解决什么问题 · Problem

现有工具(代码健康度、复杂度分析)都在测「代码写得好不好」,没有工具回答「这些工作值不值得做」。尤其当 AI agent 通宵产出几十个 commit,你需要审计:哪些是真价值、哪些是过度工程、哪些方向本身就错了。

两条铁律定义了一切:一、时点评判、绝不后见之明——五月的功能不因七月被重写而扣分,七月的重写按它自己的日期评(结构性保证,不是靠嘱咐);二、评价值、不评代码洁癖。评不准的 commit 不会被悄悄埋掉:标 needs_research(联网按时点查证)或 needs_user(打包问 owner),未解决项在报告里显式列出。

怎么用 · How to use

SKILL.md 中的真实运行方式(在 skill 自己的目录下):

cd "${CLAUDE_SKILL_DIR}" && node scripts/run.mjs \
  --project /absolute/path/to/git/project --mode self

流水线 extract → timeline → judge → aggregate → render,可断点续跑——分数按 SHA 冻结,重跑只做新增工作。输出 Markdown + 单文件交互 HTML(轨迹图支持 commit / 日 / 周三档切换)。三种模式共用同一套冻结分数:self 审自己(含 AI agent 的产出)/ manager 按作者卷积看谁的工作创造价值 / oss 审外部项目的方向。

适用场景 · When to use

• 复盘自己或 AI agent 的产出——找 wasted effort 与过度工程
• 管理者按作者看价值贡献(奖励价值,不奖励产量)
• 判断一个开源项目是在有方向地前进还是原地打转