用途:在 llmwiki/html/ 或 wiki/sources/draft/ 积累大量本地文件(如长时间工作后产生大量报告、提案)时,整理这些文档,避免“资料珍贵但混乱、难找、克隆后丢失”。
主要能力:分三层处理——PROMOTE(把真正有价值的决策/经验/模式提升到 wiki 的 ADR 或 concept)、ARCHIVE(把渲染产物、草稿报告等临时文件按功能分组移入 archive/)、KEEP(保留在活动工作区)。工具负责确定性的分类、移动和重建索引;agent 负责阅读判断哪些内容值得提升。
使用方式:先运行 python3 fdk/tools/docs-curate.py plan 做 dry-run,打印三层分类;然后由 agent 阅读 PROMOTE 项和提案草稿,把尚未进入 wiki 的决策写成 llmwiki/wiki/sources/adr/ADR-NNN-<slug>.md,把概念/模式写成 llmwiki/wiki/concepts/<slug>.md,并更新 wiki/index.md 与 wiki/log.md;再运行 python3 fdk/tools/docs-curate.py apply 执行归档与重建索引。仅想重排并索引归档时运行 python3 fdk/tools/docs-curate.py reindex。可用 apply --keep-dates 3 调整保留活动状态的日期阈值。
适用场景:本地文档库膨胀、需要区分“值得提交的 wiki 内容”与“可归档的临时产物”时。
限制与规则:必须先 PROMOTE 再 ARCHIVE,避免把含珍贵内容的草稿直接归档(本地文件被 gitignore,丢失不可恢复);归档是移动而非删除;canonical 文件(overstack.html、index.html、-cheatsheet、-health-dashboard)永不归档;新 wiki 条目需带 ## Origin 并更新索引与日志。具体命令参数与更多细节以原始资料为准,暂未提供其他平台或收费信息。