preference-load

name	preference-load
description	用户偏好画像加载与增量学习 · 加载 user_profile.json / 首次走 BOOTSTRAP 极简 3 题问卷 / 每次对话后从对话内容自动抽取增量 / 顺便做数据源体检。这是 agent 跨次复用的护城河。
version	1.0.0
author	null
tags	["travel","preference","profile","bootstrap","deps-check"]
license	MIT
triggers	["agent 首次激活（检测 user_profile.json 不存在）","用户说\"重置我的偏好\"","每次对话结束时（增量学习）","03 / 04 / 06 / 09 任一 skill 调用前需要读取偏好"]
inputs	[{"name":"mode","type":"string","enum":["load","bootstrap","update","ensure_deps"],"required":true},{"name":"conversation_log","type":"file","formats":["json"],"doc":"update 模式下传入对话日志，从中抽取偏好","required":false}]
outputs	[{"name":"user_profile","type":"file","format":"json","path":"data/user_profile.json"}]

偏好画像加载与增量学习（preference-load）

我解决什么问题

通用 AI 每次对话都要重新解释一遍"我不爱排队 / 不吃辣 / 必须有星巴克"。 我把偏好沉淀到 data/user_profile.json，跨次会话复用，且每次对话后自动学新东西。

这是 agent 真正的护城河之一——通用 AI 没法做。

🔴 任务前硬规则：必读 user_profile

每次进入新任务，agent 在阶段 1 第一句话之前，必须先调一次 load_profile.py。

为什么必读：

• 老用户在 data/user_profile.json 里可能有 history.completed_trips（去过哪些城市/拒过哪些 POI/惯用预算档）
• 不读 → 重复问用户已知信息（"你预算多少？"用户上次明明说过 standard 档）→ 体验差
• 不读 → 跳过快通道（老用户应该直接进阶段 2 而不是走 BOOTSTRAP 问卷）

命中已有 profile 时的正确开场：

我看到你之前去过成都/重庆，偏好是 standard 档 + 不爱排队。
这次还按这个吗？说一下目的地/日期/人数就可以开始。

❌ 反例：用户名明明已知，agent 还问"你叫什么名字"；预算偏好已知还问"预算多少"。

四种调用模式

mode=load（默认）

读 data/user_profile.json，输出给上游 skill 使用。 文件不存在时自动跳到 mode=bootstrap。

mode=bootstrap（首次启动）

走 BOOTSTRAP.md 定义的极简 3 题问卷：

• Q1 节奏（暴走/正常/躺平）
• Q2 禁忌（多选/留空）
• Q3 预算档位

把答案写入 data/user_profile.json。

关键约束：

• 只问这 3 题，不要变成 10 题问卷
• 留空允许（用户可以不回答 Q2）
• 答完立即进入正题，不要再追问

mode=update（每次对话结束）

从对话日志里抽取增量信息：

• 用户说"这家店看起来不错" → favorite_pois +1
• 用户说"这家不要" → rejected_pois +1
• 用户拒绝 3 个网红店 → 在 tastes.scene_dislikes 里加 "crowded_check_in_spot"
• 用户多次问"附近有星巴克吗" → constraints.must_have_starbucks_or_equivalent = true

学习规则：

• 单次拒绝不足以下结论，至少 2 次模式重复才更新
• 学习完后用 markdown 列表告诉用户："我新记下了 X / Y / Z，对吧？" 给用户确认机会
• 用户否认 → 不写

mode=ensure_deps（依赖体检）

检查当前 session 的 <available_skills> 列表，确认哪些数据源可用：

• meituan-travel 是否在列表中
• xhs-explore 是否在列表中
• online-search 是否在列表中

不可用的数据源在产物里标注降级，并主动告知用户如何开通。

体检结果写入 data/.cache/deps_check.json，下次启动时读取。

增量学习的反作用力

每次更新后：

• 在 SKILL 输出里告知用户："我新记了 ___，是吗？"
• 用户否认 → 立即回滚
• 跨 3 次会话都没用到的偏好，自动降权（避免画像越长越偏）

退出码

• 0 = 正常
• 2 = 需要用户操作（缺连接器 / 缺 key / 需扫码）
• 3 = profile 文件损坏（备份 + 重建）

反模式