SuperAPI AI 工具集

archive-increments

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

用途:保持 .specweave/increments/ 目录整洁,通过智能归档管理增量(increment)。核心遵循 10-10-10 规则:保留最近 10 个增量可直接访问、超过 10 天不活跃则归档、归档操作应在 10 秒内完成。归档结构分为活跃增量、_archive/(已完成或历史增量)与 _abandoned/(失败或废弃增量)。

主要能力:智能检测哪些增量不应归档(状态为 active 或 paused、最近 10 个、存在未关闭的 GitHub/JIRA/ADO 议题、有未提交改动),哪些应归档(完成超过 60 天、完成且 30 天无活动、被新版本取代、确认后的失败实验)。支持按发布组、功能组或时间分组归档。

使用方式:常用命令包括 /sw:archive-increments(交互式确认)、--keep-last 5、--archive-completed、--pattern "v0.7"、--older-than 30d、--list-archived、--restore 0015、--stats。可通过配置调整 keepLast、autoArchive、archiveAfterDays、preserveActive、archiveCompleted 等参数。

适用场景:发布后清理旧版本增量、季度清理、磁盘空间不足时归档较大的已完成增量、恢复历史增量作参考。

限制与安全:归档前会校验元数据、外部同步状态、Git 状态与依赖引用,并需用户确认;采用原子移动并保留完整结构,可恢复且有审计日志。默认手动归档,不强制归档活跃工作。项目特定经验可查看 .specweave/skill-memories/archive-increments.md。