用途:帮助维护整洁的代码库,识别并归档已过时或不再相关的内容。不单纯依赖时间戳或 deprecated 标记,而是侧重上下文相关性并尊重用户判断,可结合 onboard-repo 或项目认知的结论。
主要能力:交互式识别过时内容(目录、文件);按用户给定规则列出候选(如同某目录下的全部 markdown 文件);将内容移动到 _archive/<original_path>,镜像原有目录结构以保留历史,优先使用 git mv,否则用 mv。成功标准包括:候选基于用户意图或项目分析确定、用户明确确认、内容被安全归档、关键路径不误伤。
使用方式:当用户提出清理、归档或审计仓库时触发。用户在指令中指定目标(如归档 legacy 目录)时,技能先确认存在并列出内容摘要;请求模糊(如“清理旧东西”)时,会查看 docs/、experiments/、tmp/ 等并询问用户,再提出明确方案与确认,然后执行归档并清理空的父目录。示例命令:mkdir -p _archive/<parent_dir> 与 git mv <source> _archive/<source>(未被 git 跟踪时回退为 mv)。
适用场景:入职分析后的清理、按上下文归档旧原型代码、手动将旧文件移入归档。
限制:默认不删除,只有在用户明确要求永久删除时才用 rm;不自动判断何为过时;不重写归档后损坏的导入引用(可交由 run-repair-loop 或 refactor-code);不改写 git 历史;除非明确获准,不移动或删除 .git、.github、node_modules 及根配置文件(如 package.json)。归档导致构建失败或文档需更新时,可转交 run-repair-loop 或 validate-doc-artifacts。