话题追踪
当前配置协议版本:V2。脚本目录在当前会话工作目录的 .skills/skill_topic_tracking/ 下。命令统一使用当前 $PWD 拼出的脚本路径,不要自行 cd /app:
python "$PWD/.skills/skill_topic_tracking/scripts/guide.py" ...
本文件只做入口路由。确认场景后,必须读取 references/ 下的对应文件执行。
1. 先判断是否需要升级
如果当前是日程触发,先判断日程描述是否需要升级:
references/legacy_upgrade.md
新版日程描述必须包含 guide.py init --flow briefing --setup-token "setup_xxxxxxxx" 这一组参数;推荐写成:
python "$PWD/.skills/skill_topic_tracking/scripts/guide.py" init --flow briefing --setup-token "setup_xxxxxxxx"
没有 guide.py init --flow briefing --setup-token 这一组参数,一律视为旧版配置,需要升级。旧版时先暂时忽略用户日程任务里的所有执行描述,只读 references/legacy_upgrade.md 完成升级;不要执行旧命令,不要搜索补跑,不要临时 setup 或 briefing。
2. 确认无需升级后再分流
- 新建、订阅、关注、持续追踪某个话题:读
references/setup.md。 - 已有追踪要跑本期结果、日程触发、子会话试运行:读
references/briefing.md。 - 列举、查看进度、取消/删除追踪、验收运行、排查 token/状态:读
references/operations.md。
3. 流程边界
setup只由主会话执行,用于创建追踪设定。briefing只基于已有setup_token生成本期结果,不重新创建追踪。- 子会话和日程永远只执行
briefing,不要执行setup。 - 新建追踪必须先完成首次 briefing 试运行,成功后才允许创建定时日程。
4. 交付原则
guide 脚本会把交付原则写入 /app/data/所有对话/主对话/基础设定/TOOLS.md,agent 不需要手动写入。
- 主会话交付前必须用日程里的
setup_token运行verify-run --setup-token "setup_xxxxxxxx"。 - 交付、空结果、重跑都以
verify-run输出为准,不得跳过验收;但 setup contract 含empty_silent=true且 B2/B3 确认为空结果时,briefing 会要求模型原样输出{"task_result":{"status":"success","message":"无变化,无需通知用户","result_mode":"no_reply"}}并结束,不向用户说明暂无动态。 - 主会话不得再次搜索、补充来源、改写事实、重新筛选或合并其他信息。
- 如果结果少,这是严格筛选后的结果,不得放宽标准。
- 如果结论是暂无最新动态,只向用户说明“该话题暂时没有监测到最新动态”;但
empty_silent=true的空结果必须静默,不通知用户。 - 对用户不要暴露 token、run_label、阶段名、JSON 文件名或内部目录。