topic-ingest
将一条已生成的 digest/research 归档到指定 topic,并更新 topic 的 sources/timeline(M2/M3 辅助能力)。
When & Why to Use This Skill
The topic-ingest skill is a powerful Claude agent tool designed for automated knowledge management and research archiving. It streamlines the organization of generated digests by systematically filing them into specific topic directories while automatically updating source lists and chronological timelines. This ensures that research outputs are not just stored, but integrated into a structured, searchable, and up-to-date knowledge repository.
Use Cases
- Case 1: Research Archiving - Automatically moving newly generated market research digests from a general export folder to a dedicated 'Industry Trends' topic archive for better organization.
- Case 2: Source Management - Automatically updating a topic's 'sources.md' file whenever a new research document is added, ensuring all references are tracked in real-time.
- Case 3: Timeline Tracking - Appending new research findings to a topic's timeline to maintain a chronological record of developments and insights for long-term projects.
- Case 4: Knowledge Base Maintenance - Standardizing the file structure of research outputs by enforcing slug-based naming conventions and centralized storage within a workspace.
| name | topic-ingest |
|---|---|
| description | 将一条已生成的 digest/research 归档到指定 topic,并更新 topic 的 sources/timeline(M2/M3 辅助能力)。 |
触发条件
当用户说“把这条 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