topic-research
初始化或更新一个主题研究档案(文件系统)并联动 tasks/mem0,支持长期跟踪(M3)。
When & Why to Use This Skill
The Topic Research skill automates the creation and maintenance of structured research archives within a file system. By integrating task management and long-term memory (mem0), it enables users to build persistent, evolving knowledge bases for complex subjects, ensuring that insights are systematically documented, tracked, and actionable over time.
Use Cases
- Industry Analysis: Automatically establish a structured research framework for emerging markets (e.g., the space industry), tracking key players, trends, and open questions in a centralized archive.
- Academic & Technical Deep-Dives: Organize complex study materials into a standardized directory structure with version-controlled summaries, source tracking, and framework iterations.
- Strategic Planning: Convert high-level research goals into a systematic archive, linking findings to specific tasks and storing core conclusions in long-term memory for cross-session continuity.
| name | topic-research |
|---|---|
| description | 初始化或更新一个主题研究档案(文件系统)并联动 tasks/mem0,支持长期跟踪(M3)。 |
触发条件
当用户说“建立一个行业/主题研究框架”“开始研究某主题”“把主题研究做成体系化档案”等场景使用本技能。
目标
- 初始化/维护主题档案目录:
archives/topics/<topic_id>/(见topic-archive-spec.md)。 - 将待验证项与下一步行动写入
tasks(带topic_id)。 - 将阶段性结论写入 mem0(
user_id=U1_USER_ID,topic=<topic_id>)。
操作步骤(SOP)
确认 topic_id 与边界
topic_id:稳定 slug(小写+下划线),例如space_industry。- 边界:包含/不包含什么;研究目标是什么。
初始化档案(若不存在)
- 创建
archives/topics/<topic_id>/并写入模板:overview.md、framework.md、timeline.md、sources.md、open_questions.md
- 模板来源:
templates/topic/。
- 创建
更新框架(可迭代)
- 将用户目标映射到
framework.md的维度。 - 生成一个“已知/未知/争议点”列表,写入
overview.md/open_questions.md。 - 若已启用
glm_router:可用glm_router.glm_router_write_file写入overview/framework/open_questions的初稿(低成本、避免长文回流);再由 Codex 统一校对与落盘。
- 将用户目标映射到
生成任务
- 对
open_questions.md中需要推进的事项,调用tasks.create_task(topic_id=<topic_id>, source="topic_research")。 - 把创建的
task_id记录回open_questions.md(用括号标注即可)。
- 对
写入 mem0(阶段性结论)
- 对于已经明确的结论/框架原则,写入
mem0-memory.add_memory(user_id=U1_USER_ID, kind=topic_insight, topic=<topic_id>)。
- 对于已经明确的结论/框架原则,写入
对用户反馈
- 输出:
- 档案路径
- 新建/更新的任务列表
- 写入 mem0 的结论摘要
- 输出:
输出格式
topic_path:archives/topics/<topic_id>/tasks_created: 列表(id,title)mem0_updates: 列表(kind,topic,summary)