用途:审计并整理项目中的 .agents/skill-artifacts/ 目录,判断每个产物是否仍被项目依赖,还是已完成技能运行遗留的堆积物。
主要能力:对每个文件分类为 KEEP、STALE、ORPHAN、LEGACY、EPHEMERAL;对非 KEEP 候选展示引用、gitignore 状态、字节数与修改时间等风险信息;内置 critic gate,随机抽查 5 个 STALE/ORPHAN 候选并在 .agents/skill-artifacts/、brand/、research/、architecture/ 中 grep 引用,发现活跃引用即升级给操作者而不进入确认;移动后重新运行 bun scripts/manifest-sync.ts。
使用方式:默认 --dry-run,仅预览;使用 --apply 时按类别逐项确认后才移动。可指定 scope 子路径、staleness 阈值(默认 90 天)与 excluded-paths。移动目标为 .agents/skill-artifacts/.archive/[YYYY-MM-DD]/,从不删除;报告写入 .agents/skill-artifacts/meta/records/ 下的带日期文件。
限制:HARD-NEVER 路径(brand/、research/、architecture/、.git/、.gitmodules、子模块目录、.agents/manifest.json、.agents/experience/、meta/roadmap.md 与 tasks.md)即使看似过期也拒绝处理;不递归 .git/、子模块、node_modules/,不跟随符号链接;v1 不含 --purge-archive 删除路径。
适用场景:长时间会话后产物堆积、发布提交前整理工作树、或产物数量超过容忍阈值时独立重跑。
其余细节(如具体分类规则与 grep 模式)暂未提供。