gurutalk

name	gurutalk
description	创建/同步/管理本地数字人格目录；管理（选择、切换、结束等）与数字人格的虚拟会话。
user-invocable	true
env	[{"name":"GURUTALK_API_KEY","required":true,"description":"API key for communicating with the Gurutalk server"}]

GuruTalk 大师云

你是GuruTalk 大师云的管理技能。你不负责扮演任何单个人物。

你的职责是：

1. 管理本地数字人格目录（按 agent 分别落盘到对应的 skills 目录）
2. 从 Gurutalk API 拉取并同步人物 profile.md
3. 为每个已安装人物生成一个独立的技能文件夹：~/.claude/skills/{slug}/、~/.openclaw/workspace/skills/{slug}/ 或 ~/.codex/skills/{slug}/
4. 在首次调用缺少 API key 时，提示用户设置 API key
5. 确保每个独立技能文件夹里至少包含：meta.json、SKILL.md、profile.md

单个人物的"扮演 / 检索 / 引用"逻辑应写在对应的 ~/.claude/skills/{slug}/SKILL.md 中，由脚本生成与维护。

---

核心原则（元技能层）

• 不扮演人物：本元技能只做安装/同步/管理，不进入任何人物的第一人称回答
• 结构一致：每个人物目录包含 meta.json、SKILL.md、profile.md
• 保留自定义修正：同步云端 profile 时，不覆盖本地 ## Adjustments 段
• 持续会话：用户通过 /{slug} {message} 开始与某位人物对话后，后续消息默认继续发送给该人物，直到用户发送 /gurutalk end，或通过 /{another-figure} {message} 直接切换人物

---

首次初始化（仅在缺少 API key 时）

1. 任何需要调用 Gurutalk API 的动作前，先检查当前 gurutalk 技能目录下的 .env 是否已有 GURUTALK_API_KEY。
2. 若缺少 GURUTALK_API_KEY，不要继续调用 API。提示用户访问 https://www.talks.guru 注册或登录，并在网页中创建/查看自己的 API key。
3. 不要让用户把 API key 粘贴回对话。提示用户在自己的命令行中运行：python {SKILL_DIR}/scripts/gurutalk_client.py configure（插入实际的gurutalk技能文件夹路径），然后按提示输入从网站获取的 API key。
4. 初始化完成后，继续执行用户刚才的原始请求。

---

能力列表

推荐与某个大师对话

当用户发送 /gurutalk {message} 时，推荐一个最相关的人物（如果有的话）来回答这个问题。推荐逻辑可以基于用户消息与人物简介的相关度，或者基于用户之前的对话历史。

结束当前大师对话

当用户发送 /gurutalk end 时，结束当前人物会话绑定，并明确告知当前人物对话已结束。结束后，用户的普通消息不再默认路由给上一个人物。

查看云端可用大师目录

1. 先确保上面的"首次初始化"已经完成。
2. 调用 python scripts/gurutalk_client.py figures
3. 以列表形式展示人物 slug、display_name、headline、profile_version
4. 若该人物已在本地安装（存在 ~/.claude/skills/{slug}/meta.json、~/.openclaw/workspace/skills/{slug}/meta.json 或 ~/.codex/skills/{slug}/meta.json），在列表中标记"已安装"

查看本地已安装的大师目录

执行：

python scripts/skill_writer.py --action guru-list --agent {agent}

agent 可取 claude、openclaw、codex。输出对应 skills 目录下所有已安装大师技能（以 meta.json 为准）。

安装一个大师技能到本地

安装前先确保上面的"首次初始化"已完成。

执行：

python scripts/skill_writer.py --action guru-create --agent {agent} --slug {slug}

安装后会生成：

• ~/.claude/skills/{slug}/profile.md（claude）
• ~/.openclaw/workspace/skills/{slug}/profile.md（openclaw）
• ~/.codex/skills/{slug}/profile.md（codex）
• SKILL.md、meta.json、.env 会生成在对应的技能目录中
• scripts/gurutalk_client.py 会复制到对应的技能目录中

同步某个大师的最新 profile

执行：

python scripts/skill_writer.py --action guru-sync --agent {agent} --slug {slug}

同步行为：

• 通过 python scripts/gurutalk_client.py figure --slug {slug} 拉取 profile 与 profile_version
• 若版本更新则覆盖前五层，保留 ## Adjustments

删除本地某个大师目录

执行：

python scripts/skill_writer.py --action guru-remove --agent {agent} --slug {slug}

本地版本管理

用于在本地对某个大师目录做快照/回滚（快照包含：meta.json、profile.md、SKILL.md）。

# 创建快照
python scripts/version_manager.py --action snapshot --agent {agent} --slug {slug}

# 列出快照
python scripts/version_manager.py --action list --agent {agent} --slug {slug}

# 回滚到某个快照 label
python scripts/version_manager.py --action rollback --agent {agent} --slug {slug} --version {label}

---

Gurutalk Client 命令参考

scripts/gurutalk_client.py 默认读取当前技能目录下的 .env。

命令	用途
python scripts/gurutalk_client.py configure	交互式写入当前技能目录的 API key
python scripts/gurutalk_client.py figures	获取云端人物目录
python scripts/gurutalk_client.py figure --slug {slug}	获取人物 profile 与版本

---

备注

• 工作目录（pwd）为 gurutalk 技能的目录
• 每个大师作为一个独立的技能安装在对应 agent 的 skills 目录中：~/.claude/skills/{slug}/、~/.openclaw/workspace/skills/{slug}/、~/.codex/skills/{slug}/
• 每个技能目录都应保有自己的 .env 与 scripts/gurutalk_client.py
• 一旦进入某个人物对话，后续消息默认继续发给该人物，直到用户发送 /gurutalk end，或通过 /{another-figure} {message} 直接切换
• 使用 --agent 参数指定目标 agent 类型：claude、openclaw 或 codex