| name | topic-ingest |
| description | 将一条已生成的 digest/research 归档到指定 topic,并更新 topic 的 sources/timeline(M2/M3 辅助能力)。 |
| allowed-tools | workspace, shell, python |
触发条件
当用户说“把这条 digest 挂到某个 topic”“更新 topic 的 sources/timeline”“把 exports/digests 的内容归档到主题档案”等场景使用本技能。
目标
- 输入:一条 digest/research Markdown 文件路径 +
topic_id - 输出:
- 确保文件位于:
archives/topics/<topic_id>/digests/ - 更新:
archives/topics/<topic_id>/sources.md - (可选)追加:
archives/topics/<topic_id>/timeline.md
- 确保文件位于:
操作步骤(SOP)
确认 topic_id
- 必须是稳定 slug(小写+下划线),例如
space_industry。
- 必须是稳定 slug(小写+下划线),例如
确认输入文件路径
- 允许输入文件位于:
archives/topics/<topic_id>/digests/(已在 topic 内)exports/digests/(需要归档进 topic)
- 允许输入文件位于:
必要时复制到 topic
- 若文件不在
archives/topics/<topic_id>/digests/下:- 将其复制到
archives/topics/<topic_id>/digests/<same_filename>.md(避免移动导致历史引用失效)
- 将其复制到
- 若文件不在
更新 topic 的 sources(可选 timeline)
- 运行:
python3 scripts/topic_ingest_digest.py <topic_id> <digest_path_in_topic>- 若用户要求更新时间线:加
--timeline
- 运行:
对用户反馈
- 返回:
- 最终 digest 路径
- 是否更新了
sources.md/timeline.md
- 返回:
输出格式
topic_id:<topic_id>digest_path:<path>sources_updated:true|falsetimeline_updated:true|false