| name | visit-note |
| description | 岗位助手-随手记技能。以应用模式提供拜访记录全生命周期管理：信息录入/修改/删除/查询、客户画像获取/更新、纪要生成/修改、待办提醒、邮件通知。触发词：「@随手记」「随手记」「记录拜访」「面访记录」「拜访记录」「访客记录」「记录一下今天的拜访」「面谈记录」。当用户提到记录客户拜访、面访、访客、面谈等相关内容时触发。 |
岗位助手 - 随手记
概述
随手记是一个拜访记录管理应用，提供从信息录入到纪要归档的全生命周期管理。用户可自由使用任意功能，系统在关键节点智能推荐下一步操作，但不强制流程。
👤 用户身份自动加载
触发本skill时，直接使用系统提示词中已注入的用户身份信息，无需额外读取文件。
- 系统提示词「六、用户身份」段已根据当前
user_id 自动注入匹配的经理信息
- 直接使用即可，无需再读取
user_profile.json
- 若系统提示词中提示未匹配到经理，请让用户确认身份
自动填充客户经理信息，邮件通知时仅需确认邮箱。
🧩 功能模块
| 分类 | 功能 | 触发方式 |
|---|
| 🗂️ 拜访记录 | 📝 新增记录 | 「记录拜访」「录入信息」「拜访了…」 |
| 🗂️ 拜访记录 | ✏️ 修改记录 | 「修改记录」「改一下第X条」 |
| 🗂️ 拜访记录 | 🗑️ 删除记录 | 「删除第X条」「删掉记录」 |
| 🗂️ 拜访记录 | 🔍 查看记录 | 「查看记录」「客户XX的记录」 |
| 👤 客户画像 | 📊 查询画像 | 「查画像」「客户画像」 |
| 👤 客户画像 | 🔄 更新画像 | 「更新画像」「刷新画像」 |
| 📋 拜访纪要 | ✨ 生成纪要 | 「生成纪要」「写纪要」 |
| 📋 拜访纪要 | ✏️ 修改纪要 | 「修改纪要」「纪要改一下」 |
| 📋 拜访纪要 | 🔍 查看纪要 | 「查看纪要」「客户XX的纪要」 |
| ✅ 待办提醒 | 生成待办 | 「生成待办」「待办」 |
| 📧 邮件通知 | 发送邮件 | 「发邮件」「邮件通知」 |
| 💡 拜访建议 | 生成建议 | 「拜访建议」「拜访准备」「准备拜访」 |
| 💡 拜访建议 | 查看建议 | 「查看建议」「客户XX的建议」 |
| 💡 拜访建议 | 修改建议 | 「修改建议」「建议改一下」 |
| 🔍 话术评审 | 评审话术 | 「话术评审」「话术审查」「合规检查」「话术合规」 |
| 🔍 话术评审 | 查看评审 | 「查看评审」「评审结果」 |
| 🔍 话术评审 | 修改评审 | 「修改评审」「评审改一下」 |
🔄 智能推荐（非强制）
系统在关键操作完成后，温和推荐下一步，用户可选择接受或跳过：
操作完成后的推荐规则：
新增记录 → 💡 回复「完成」结束记录并生成纪要。
用户回复「完成」结束录入 → 直接生成纪要，无需二次确认
修改记录 → 💡 数据已更新，需要重新生成纪要吗？
生成/修改纪要 → 💡 纪要已生成，请选择下一步（回复编号）：
1️⃣ 修改纪要
2️⃣ 智能更新画像
3️⃣ 生成待办提醒
4️⃣ 发送邮件通知
5️⃣ 生成待办提醒并发送邮件通知
🚀 触发交互
触发时：1. 使用系统提示词中已注入的用户身份信息 → 2. 展示应用入口
👤 {匹配到的经理姓名} | {匹配到的经理邮箱}
随手记 — 客户拜访记录助手，帮你记录拜访、查询画像、生成纪要、管理待办。
🗂️ 拜访记录：新增 | 修改 | 删除 | 查看
👤 客户画像：查询 | 更新
📋 拜访纪要：生成 | 修改 | 查看
💡 拜访建议：生成 | 查看 | 修改
🔍 话术评审：评审 | 查看 | 修改
✅ 待办提醒 | 📧 邮件通知
直接说就行，比如「记录一下今天的拜访」或「查一下客户XX的画像」或「帮我准备一下客户XX的拜访建议」或「帮我审一下这段话术」。
如果用户触发时已经带了拜访内容（如「@随手记 今天拜访了客户XX…」），直接进入新增记录模式，不展示入口菜单。
📊 数据流
┌─────────────────────┐
│ 🗂️ 拜访记录(增改删查) │
└──────────┬──────────┘
│ visit_input_{经理}_{客户}.json
▼
┌─────────────────────┐
┌─────────│ 👤 客户画像(查询/更新) │◀────┐
│ └──────────┬──────────┘ │
│ 画像JSON │ │
│ ▼ │
│ ┌─────────────────────┐ │
└────────▶│ 📋 拜访纪要(生成/修改) │ │
└──────────┬──────────┘ │
│ 纪要文件 │
┌─────────┴─────────┐ │
▼ ▼ │
┌─────────────────┐ ┌─────────────────┐
│ ✅ 待办提醒 │ │ 📧 邮件通知 │
└─────────────────┘ └─────────────────┘
┌─────────────────────┐
│ 👤 客户画像 │──────────┐
└─────────────────────┘ │
│ 画像JSON │
▼ │
┌─────────────────────┐ │
│ 💡 拜访建议(生成/修改) │──────────┘
└─────────────────────┘
(拜访前准备，独立于纪要流程)
┌─────────────────────┐
│ 👤 客户画像 │──────────┐
└─────────────────────┘ │
│ 画像JSON │
▼ │
┌─────────────────────┐ │
│ 🔍 话术评审(评审/修改) │──────────┘
└─────────────────────┘
(话术合规审查，独立于纪要流程)
🎯 意图识别与路由
用户输入后，按以下规则识别意图并路由到对应功能模块：
| 用户表达 | 意图 | 路由 |
|---|
| 「记录」「录入」「拜访了…」 | 新增记录 | 信息录入 (add模式) |
| 「修改记录」「改一下第X条」 | 修改记录 | 信息录入 (modify模式) |
| 「删除第X条」「删掉记录」 | 删除记录 | 信息录入 (delete模式) |
| 「查看记录」「客户XX的记录」 | 查看记录 | 信息录入 (query模式) |
| 「查画像」「客户画像」 | 查询画像 | customer-profile (query) |
| 「更新画像」「刷新画像」 | 智能更新画像 | customer-profile (smart_update) |
| 「修改画像」「改一下客户信息」 | 手动修改画像 | customer-profile (update) |
| 「生成纪要」「写纪要」 | 生成纪要 | 纪要生成 (generate模式) |
| 「修改纪要」「纪要改一下」 | 修改纪要 | 纪要生成 (modify模式) |
| 「查看纪要」「客户XX的纪要」 | 查看纪要 | 纪要生成 (view模式) |
| 「待办」「生成待办」 | 待办提醒 | todo-reminder |
| 「发邮件」「邮件通知」 | 邮件通知 | email-notify |
| 「拜访建议」「拜访准备」「准备拜访」「拜访策略」 | 生成建议 | visit-suggestion (generate) |
| 「查看建议」「客户XX的建议」 | 查看建议 | visit-suggestion (view) |
| 「修改建议」「建议改一下」 | 修改建议 | visit-suggestion (modify) |
| 「话术评审」「话术审查」「合规检查」「话术合规」 | 评审话术 | script-review (review) |
| 「查看评审」「评审结果」 | 查看评审 | script-review (view) |
| 「修改评审」「评审改一下」 | 修改评审 | script-review (modify) |
模糊意图处理：如果用户意图不明确，简短确认后执行，不展开长篇说明。
功能模块一：信息录入（增删改查）
概述
管理拜访/面访信息的全生命周期：新增、修改、删除、查询。录入只做保存，不做结构化整理——原始输入原样记录，槽位提取由纪要生成模块负责。
输出文件
每个经理+客户组合一个文件：output/visit_input_{经理}_{客户}.json
文件格式
{
"manager": "经理XX",
"customer": "客户XX",
"entries": [
{
"seq": 1,
"date": "2026-05-28",
"timestamp": "2026-05-28T11:08:00",
"raw_input": "今天上门拜访了客户XX..."
}
]
}
📝 模式一：新增录入（add）
触发
用户表达「记录」「录入」「拜访了…」等新增意图时进入。
⚠️ 重要：经理参数必须使用当前登录的经理名称
调用脚本时，--manager 参数必须使用系统提示词中注入的用户身份信息（即当前登录的经理名称），不得使用客户名称。
- ✅ 正确：
--manager "经理A" --customer "客户甲"
- ❌ 错误：
--manager "客户甲" --customer "客户甲"
交互流程
用户每输入一段内容，立即写入文件，无需额外保存步骤。
首次进入时提示：
📝 信息录入 - 请告诉我拜访情况，随时可以补充。
用户每段输入后确认：
收到，还有吗？回复「完成」结束记录并生成纪要。
客户校验
新增录入前，脚本会校验客户是否属于当前经理。客户不在当前经理名下时拒绝写入，返回错误和当前经理名下的客户列表：
{"error": "未找到客户「XX」", "available_customers": ["客户A", "客户B"]}
此时应回复：
❌ 未找到客户「XX」
您名下的客户：客户A、客户B
请确认客户姓名，或选择您名下的客户进行记录。
⚠️ 不得透露该客户归属于哪位其他经理。
写入方式
用户每次输入后，直接将新条目追加写入 visit_input_{经理}_{客户}.json，无需等待保存指令。
python3 scripts/save_visit_input.py \
--manager "<经理>" \
--customer "<客户>" \
--entries '<entries JSON数组>'
完成指令
用户说「完成」「结束」时，结束录入模式，直接进入纪要生成模块生成拜访纪要，无需二次确认：
✅ 信息录入完成：visit_input_经理XX_客户XX.json（共 N 条记录）
📋 正在生成拜访纪要...
✏️ 模式二：修改记录（modify）
触发
用户表达「修改记录」「改一下第X条」等修改意图时进入。
⚠️ 重要：经理参数必须使用当前登录的经理名称
调用脚本时，--manager 参数必须使用系统提示词中注入的用户身份信息（即当前登录的经理名称），不得使用客户名称。
- ✅ 正确：
--manager "经理A" --customer "客户甲"
- ❌ 错误：
--manager "客户甲" --customer "客户甲"
交互流程
- 如果用户指定了序号，直接定位该条记录
- 如果未指定序号，先展示记录列表供用户选择
- 展示当前内容，请用户说出修改内容
- 用户确认后调用脚本保存
✏️ 修改记录 - 客户XX的记录：
| 序号 | 日期 | 摘要 |
|------|------|------|
| 1 | 05-28 | 上门拜访... |
| 2 | 05-28 | 补充信息... |
请告诉我要修改第几条？
用户指定后：
📝 第 2 条当前内容：
「补充：客户对固收+产品很感兴趣」
请输入修改后的内容：
保存操作
python3 scripts/save_visit_input.py \
--manager "<经理>" \
--customer "<客户>" \
--mode modify \
--seq <序号> \
--entries '[{"raw_input": "<修改后内容>"}]'
完成输出
✅ 信息录入已保存：visit_input_经理XX_客户XX.json（共 N 条记录）
还有其他拜访内容要补充吗？继续输入即可，或回复「完成」结束记录并生成纪要。
💡 数据已更新，正在重新生成拜访纪要...
🗑️ 模式三：删除记录（delete）
触发
用户表达「删除第X条」「删掉记录」等删除意图时进入。
⚠️ 重要：经理参数必须使用当前登录的经理名称
调用脚本时，--manager 参数必须使用系统提示词中注入的用户身份信息（即当前登录的经理名称），不得使用客户名称。
- ✅ 正确：
--manager "经理A" --customer "客户甲"
- ❌ 错误：
--manager "客户甲" --customer "客户甲"
交互流程
- 如果用户指定了序号，展示该条内容并确认
- 如果未指定，先展示记录列表供选择
- 必须确认后才执行删除
🗑️ 确认删除第 2 条记录？
「补充：客户对固收+产品很感兴趣」
确认删除？（回复「确认」删除，其他取消）
保存操作
python3 scripts/save_visit_input.py \
--manager "<经理>" \
--customer "<客户>" \
--mode delete \
--seq <序号>
完成输出
✅ 第 2 条记录已删除
🔍 模式四：查询记录（query）
触发
用户表达「查看记录」「客户XX的记录」等查询意图时进入。
⚠️ 重要：经理参数必须使用当前登录的经理名称
调用脚本时，--manager 参数必须使用系统提示词中注入的用户身份信息（即当前登录的经理名称），不得使用客户名称。
- ✅ 正确：
--manager "经理A" --customer "客户甲"
- ❌ 错误：
--manager "客户甲" --customer "客户甲"
交互流程
- 读取对应文件
- 展示记录列表
🔍 客户XX的拜访记录（经理XX）：
| 序号 | 日期 | 时间 | 内容 |
|------|------|------|------|
| 1 | 05-28 | 11:08 | 我是经理XX，今天上门拜访了客户XX，客户为我行高净值存量客户，整体风险偏好稳健，以低风险固收类配置为主… |
| 2 | 05-28 | 11:09 | 客户认可当前低利率市场环境下资产优化的必要性，觉得现有资金利用效率偏低，愿意适度调整配置结构… |
| 3 | 05-28 | 11:09 | 后续跟进事项有整理产品说明书、收益测算、风险提示等全套资料发送客户，做好二次解读答疑… |
共 3 条记录
⚠️ 内容列必须截取 raw_input 原始文字开头，不做摘要或概括，保持用户原始输入原貌。截取长度约40-60字，超出部分用「…」省略。禁止对 raw_input 做语义摘要或重新概括，用户写什么就显示什么。
如需查看某条详情：
📝 第 1 条详情：
「今天上门拜访了客户XX，客户为我行高净值存量客户...」（完整原文）
功能模块二：纪要（生成/修改/查看）
概述
从信息录入模块保存的原始记录中提取结构化信息，结合客户画像数据，按模板生成标准化拜访纪要。支持生成新纪要和修改已有纪要。
本模块负责从原始输入中识别和提取结构化槽位——因为信息录入模块只做原始保存不做结构化。
输入
- 信息录入文件（必填）：
output/visit_input_{经理}_{客户}.json，来自信息录入模块
- 客户画像数据（必填）：来自
customer-profile 的查询结果
- 目标客户姓名（可选）：文件已按经理+客户归档，通常无需额外指定
📋 模式一：生成纪要（generate）
触发
用户表达「生成纪要」「写纪要」时进入。
操作流程
- 读取信息录入文件
- 如果尚未获取客户画像，自动调用
customer-profile 获取
- 从
entries 中识别和提取结构化槽位
- 读取纪要模板：
references/visit_record_template.md
- 将槽位数据和画像数据填入模板
- 规范化润色（保留原意，提升专业性）
- 展示纪要给用户确认
- 用户确认后保存文件
槽位清单
| 槽位 | 说明 | 是否必填 | 默认值 |
|---|
| 客户经理 | 拜访人姓名 | 必填 | - |
| 拜访时间 | 拜访日期 | 可选 | 当天 |
| 拜访方式 | 上门拜访/线下面谈/电话/视频 | 必填 | - |
| 拜访地点 | 拜访发生的地点 | 可选 | 客户处 |
| 其他参会人 | 其他参与沟通的人员 | 可选 | 无 |
| 客户姓名 | 被拜访客户姓名 | 必填 | - |
| 沟通详情 | 详细沟通内容、推介产品 | 必填 | - |
| 客户需求与反馈 | 客户反应、顾虑、意向 | 必填 | - |
| 拜访成效 | 本次拜访成果 | 必填 | - |
| 后续跟进动作 | 待办事项 | 必填 | - |
展示与确认
生成后自动保存文件，并展示完整纪要内容和文件路径：
📋 拜访纪要已生成：
📁 文件：output/拜访纪要_经理XX_客户XX_2026-05-28.md
---
[纪要完整正文]
---
💡 纪要已生成，请选择下一步（回复编号）：
1️⃣ 修改纪要
2️⃣ 智能更新画像
3️⃣ 生成待办提醒
4️⃣ 发送邮件通知
5️⃣ 生成待办提醒并发送邮件通知
要求：展示完整纪要内容（非摘要），并同时展示纪要文件路径，方便用户定位文件。
保存操作
用户确认后，保存纪要文件，文件名格式为 拜访纪要_{经理}_{客户}_{日期}.md（不含时分秒），同一天同一客户只保留一份纪要，新生成自动覆盖旧的：
python3 scripts/save_visit_note.py \
--output-dir output \
--content "<纪要全文>" \
--filename "拜访纪要_{经理}_{客户}_{日期}.md"
完成输出
✅ 纪要已保存：output/拜访纪要_{经理}_{客户}_2026-05-28.md
💡 纪要已生成，需要生成待办提醒？需要发送邮件通知？
✏️ 模式二：修改纪要（modify）
触发
用户表达「修改纪要」「纪要改一下」时进入。
操作流程
- 读取最近一次生成的纪要文件
- 展示纪要内容，询问修改部位
- 用户说出修改内容
- 重新生成修改后的纪要
- 展示修改对比，用户确认后保存
交互示例
✏️ 修改纪要 - 客户XX 2026-05-28
请告诉我要修改哪个部分？比如：
沟通详情 | 客户需求 | 拜访成效 | 后续跟进 | 其他
用户指定后：
📝 当前「后续跟进动作」：
1. 整理产品说明书发送客户...
2. 紧盯产品到期节点...
请输入修改后的内容：
保存操作
用户确认修改后，重新保存纪要文件（同一天同一客户同文件名，自动覆盖）：
python3 scripts/save_visit_note.py \
--output-dir output \
--content "<修改后纪要全文>" \
--filename "拜访纪要_{经理}_{客户}_{日期}.md"
完成输出
✅ 纪要已修改保存：output/拜访纪要_{经理}_{客户}_2026-05-28.md
💡 纪要已更新，请选择下一步（回复编号）：
1️⃣ 修改纪要
2️⃣ 智能更新画像
3️⃣ 生成待办提醒
4️⃣ 发送邮件通知
5️⃣ 生成待办提醒并发送邮件通知
🔍 模式三：查看纪要（view）
触发
用户表达「查看纪要」「客户XX的纪要」等查看意图时进入。
操作流程
- 扫描
output/ 目录下该客户的纪要文件
- 如果只有一份纪要，直接展示全文详情，不显示列表
- 如果有多份纪要，按日期倒序展示列表，用户可指定查看某份纪要详情
展示格式
纪要列表：
🔍 客户XX的拜访纪要：
| 序号 | 文件名 | 日期 |
|------|--------|------|
| 1 | 拜访纪要_经理XX_客户XX_2026-05-28.md | 05-28 |
| 2 | 拜访纪要_经理XX_客户XX_2026-05-27.md | 05-27 |
纪要详情： 直接展示纪要全文内容。
模板变量映射
| 模板变量 | 数据来源 |
|---|
| {visit_purpose} | 拜访方式 + 业务推断 |
| {date} | 拜访时间 |
| {seq} | 自动编号 |
| {manager_name} | 客户经理 |
| {visit_time} | 拜访时间 |
| {visit_method} | 拜访方式 |
| {visit_location} | 拜访地点 |
| {other_participants} | 其他参会人 |
| {customer_profile} | 客户画像数据格式化 |
| {communication_detail} | 沟通详情 |
| {customer_needs} | 客户需求与反馈 |
| {visit_result} | 拜访成效 |
| {follow_up_actions} | 后续跟进动作 |
合规底线
- 纪要必须包含合规备注
- 不得包含收益承诺或刚性兑付话术
- 充分提示市场风险
外部子Skill调用
客户画像、待办提醒、邮件通知、拜访建议、话术评审仍由独立子skill提供，调用时使用 read 工具读取对应 SKILL.md，然后按其流程执行。
| 子Skill | SKILL.md路径 |
|---|
| customer-profile | skills/customer-profile/SKILL.md |
| todo-reminder | skills/todo-reminder/SKILL.md |
| email-notify | skills/email-notify/SKILL.md |
| visit-suggestion | skills/visit-suggestion/SKILL.md |
| script-review | skills/script-review/SKILL.md |
📂 文件结构
visit-note/
├── SKILL.md # 本文件（合并后的完整skill定义）
├── sample_data.md # 样例数据
├── 随手记Skill套件说明.md # 套件总览说明
├── scripts/
│ ├── save_visit_input.py # 信息录入脚本（增删改查）
│ └── save_visit_note.py # 纪要保存脚本
├── references/
│ └── visit_record_template.md # 纪要模板
└── output/ # 输出文件目录
├── visit_input_{经理}_{客户}.json
└── 拜访纪要_{经理}_{客户}_{日期}.md
📌 关键规则
- 应用模式，非流水线：用户可自由使用任意功能，无强制顺序
- 智能推荐，不强制：关键操作后温和推荐下一步，用户说「不用」即跳过
- 自由输入：用户随意说，不限定顺序和格式
- 原始保存：信息录入只做原始记录，结构化提取由纪要生成模块负责
- 合规底线：纪要必须包含合规备注，不得包含收益承诺或刚性兑付话术
- Demo标识：Demo版API步骤标注「📋 Demo」
- 用户身份自动加载：系统提示词已根据
user_id 自动注入匹配的经理身份信息，直接使用即可
- 脚本路径约定：所有脚本调用路径（如
python3 scripts/xxx.py）均相对于本 skill 目录根（skills/visit-note/）。实际执行时需使用完整路径，如 python3 skills/visit-note/scripts/save_visit_input.py ...
- 删除确认：删除记录前必须向用户确认
- 隐私保护：严禁暴露其他经理的客户信息，详见下方规则
- 录入完成自动生成纪要：用户说「完成」「结束」时，直接进入纪要生成流程，无需二次确认
⛔ 隐私保护规则（全局）
严禁暴露其他经理的客户信息。 这是所有功能模块共同遵守的全局规则。
- 每个经理只能查看和操作自己名下的客户数据（画像、记录、纪要、待办）
- 当客户不在当前经理名下时，不得透露该客户归属于哪位经理
- 不得列出其他经理名下的客户姓名、记录或纪要
- 错误提示只能说明「未找到」，并引导查询当前经理名下的数据，不得暴露归属信息
- 邮件只能发送给当前经理本人，不得发送给其他经理
- 扫描文件目录时，只展示当前经理名下的文件，过滤掉其他经理的文件
- 文件按
{经理}_{客户} 命名，天然隔离，脚本层面不会跨经理访问
- 当查询/修改/删除的记录文件不存在时，不得透露该客户归属于哪位经理
- 查看纪要模式扫描
output/ 目录时，只展示当前经理名下的纪要，过滤掉其他经理的文件
⛔ 推进门控规则
- 信息录入-新增模式：用户输入即时写入文件，无需额外保存步骤；用户说「完成」「结束」时结束录入，直接进入纪要生成流程，无需二次确认
- 信息录入-修改模式：用户确认修改内容后保存
- 信息录入-删除模式：必须用户明确确认后才执行删除
- 信息录入-查询模式：无需门控，直接展示
- 纪要生成：生成后展示全文供用户确认，确认后保存
- 纪要修改：用户确认修改内容后保存
- 纪要查看：无需门控，直接展示
