用途
feature-radar-archive 是 feature-radar 技能集中的归档环节,负责把一个功能需求从活跃状态移入 .feature-radar/archive/ 目录,并强制执行学习提取流程。它适用于功能已完成、已被现有能力覆盖、已被拒绝、不适用于当前架构或延期处理等场景。
主要能力
- 将功能归档为 .feature-radar/archive/{nn}-{slug}.md,并标注状态。
- 支持的状态包括:Done(已完整实现并可用)、Covered(现有功能已覆盖该用例)、Rejected(决定不实现)、N/A(不适用于当前架构)、Deferred(有价值但延期,需附理由)。
- 强制执行五项提取检查:创建归档文件、提取经验到 specs/{topic}.md、派生新机会到 opportunities/{nn}-{slug}.md、更新 references/{topic}.md、更新 specs/ecosystem-trends.md。
- 归档后删除原 opportunities/ 中的对应文件,并更新 base.md 的 Tracking Summary 计数。
使用方式
- 确认要归档的功能,检查 opportunities/ 中是否存在对应文件。
- 确定状态(Done / Covered / Rejected / N/A / Deferred)。
- 创建归档文件 .feature-radar/archive/{nn}-{slug}.md,格式参照 ../feature-radar/references/SPEC.md § 3.2。
- 按 ../feature-radar/references/WORKFLOW-PATTERNS.md 进行检查点评审与标注。
- 逐项执行提取清单,每项检查都必须给出明确结果,例如“No learnings to extract”“New opportunity identified: {description}”“No reference updates needed”。
- 若功能原先在 opportunities/ 中,使用相同编号;若是新功能,使用下一个可用编号。
- 删除原 opportunities/ 文件,更新 base.md 计数。
- 以表格形式呈现提取结果,并按照 ../feature-radar/references/DIRECTIVES.md 模板输出“Archive Complete”完成摘要。
适用场景
适用于使用 feature-radar 工作流管理功能需求、需要系统化沉淀经验并追踪功能生命周期的团队或个人。
限制
提取清单不可跳过,每次归档必须完成全部五项检查。“Deferred”不是垃圾桶,必须包含明确的延期理由和重新评估条件。归档文件格式、工作流模式与完成摘要模板均依赖 feature-radar 技能集中的参考文件。