clean-artifacts 是一个单代理编排技能,编排器即执行者,critic 检查在流程内完成。核心用途是对 docs/forsvn/artifacts/ 做审计与整理:判断文件是仍被依赖,还是数周前的残留物。分类词表默认如下:KEEP(manifest 新鲜、近期被消费,或属 canonical/anchor)保留;STALE(manifest 条目超过阈值且无近期消费者)归档并确认;ORPHAN(无 manifest 条目、产出技能已移除、手工创建后被弃用)归档并确认;LEGACY(frontmatter 标记 superseded/archived 或生命周期 ephemeral)强归档;EPHEMERAL(匹配已知临时模式)强归档。HARD-NEVER 覆盖以上规则,始终输出 KEEP。
必要规则是 MOVE 而非删除:移动到 docs/forsvn/artifacts/.archive/[YYYY-MM-DD]/;--purge-archive 是唯一删除路径且 v1 不纳入范围。HARD-NEVER 拒绝对象包括 canonical(brand/、research/、architecture/)、VCS(.git/、.gitmodules、submodules)、基础设施(.forsvn/index/manifest.json)、追加写入(docs/forsvn/experience/)、锚点(docs/forsvn/artifacts/meta/{roadmap,tasks}.md)。默认 --dry-run,无 --apply 与逐分类确认不移动。critic 门禁不可协商:在 docs/forsvn/artifacts/、brand/、research/、architecture/ 中随机 grep 5 个 STALE/ORPHAN 引用,发现活跃引用则升级。任何移动后须重新运行 bun scripts/manifest-sync.ts。
使用方式:从 SKILL.md 斜杠调用触发插值,Warm Start 会显示范围、磁盘 .md 文件数与超过 90 天的数量、manifest 最后改动、排除路径,并询问是否覆盖默认(如 --apply、--threshold-days 30)。Cold Start 无范围提示时走四问提示并把排除写入 docs/forsvn/experience/technical.md。流程阶段为 sanity-check → 遍历(跳过 .git/、node_modules/、.archive/、排除项、符号链接)→ 按顺序分类 → critic 门禁 → 带风险层级的候选表(TIER-1 gitignored、TIER-2 tracked-clean、TIER-3 tracked-dirty,TIER-3 绝不移动)→ dry-run 报告或逐分类确认后应用 → 归档移动 → manifest-sync → 写报告。
产物路径为 docs/forsvn/artifacts/meta/records/[YYYY-MM-DD]-cleanup-artifacts-<slug>.md,带日期且不可变,生命周期 snapshot,供操作者审计。完成状态包括 DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT;manifest 缺失或损坏建议运行 bun scripts/manifest-sync.ts。限制方面:v1 不含 --purge-archive,TIER-3 永不移动,HARD-NEVER 不可违反;具体参数与反模式见 references/configuration.md 与 references/anti-patterns.md。其它平台、收费、价格与效果资料暂未提供。