文档中心 / Agent Skill
安装并使用学习地图 Skill
让常用的 AI Agent 在取得你的明确授权后，查看、创建、更新、搜索和推进学习地图。首次授权通过网站浏览器完成；不需要创建 API Token，也不应把密码、Cookie 或授权码写入 Skill 文件。
通过可信 Skill 安装渠道分发
Skill 从公开、可审查的 GitHub 仓库安装，不从本站下载或执行远程脚本。本站只负责浏览器 OAuth 与学习地图 API；长期授权仅保存在系统凭据库。
跨 Agent 安装
- 1. 安装完整目录。使用 Agent Skills CLI 将公开 GitHub 仓库中的完整 Skill 安装到当前设备已支持的 Agent。
- 2. 审查来源。安装前阅读仓库中的
SKILL.md、CLI 与依赖清单；不要让 Agent 执行来自网站的远程脚本。 - 3. 校验并验证。安装后执行 CLI 的
--help，确认命令可用。 - 4. 首次登录。执行
login或首次需要访问数据的命令，在浏览器中登录本网站并批准授权。长期授权由本机系统凭据存储管理。
可直接交给支持 Skill 的 Agent：
请使用 Agent Skills CLI 安装已发布的 learning-map-agent skill。运行：npx skills add lvyinchao/learning-map-agent-skill --skill learning-map-agent --agent '*' --yes。安装来源是公开 GitHub 仓库，请先概述将安装的文件；不要从 path.cloudexp.net 下载或执行远程脚本。安装完成后，使用已安装 Skill 引导我在 https://path.cloudexp.net 进行 OAuth 登录，并把授权仅保存到系统凭据库。最后运行 learning_map_cli.py --help 验证安装。也可以直接在终端运行：
npx skills add lvyinchao/learning-map-agent-skill --skill learning-map-agent --agent '*' --yes文件清单
发布包包含 SKILL.md、CLI 脚本、系统凭据库依赖清单和课程地图示例。安装时不要只复制单个 Markdown 文件。
授权与撤销
首次浏览器授权后，使用 logout 可撤销当前设备。不要把浏览器 Cookie、密码或任何授权值放进环境变量。
按平台使用
OpenClaw
推荐安装到当前工作区的 .agents/skills/learning-map-agent/，便于与项目一起管理；也可放入个人目录 ~/.openclaw/skills/learning-map-agent/。重新开启会话后，用自然语言描述任务或明确说“使用 learning-map-agent”。
# 在项目根目录安装后验证
python3 .agents/skills/learning-map-agent/scripts/learning_map_cli.py --help
python3 .agents/skills/learning-map-agent/scripts/learning_map_cli.py loginQoderWork
使用上方的 npx skills add 命令，或在 Skills 页面导入 GitHub 发布包。个人 Skill 的默认位置是 ~/.qoderwork/skills/learning-map-agent/。安装后用 / 选择 Skill，或直接提出创建、更新、搜索学习地图的任务。
WorkBuddy
打开 WorkBuddy 的 Skills 页面，新建或导入 Skill，并提供完整的 Skill 目录。若你的版本支持让 Agent 安装外部 Skill，直接粘贴通用安装提示；完成后在对话里请求“使用学习地图 Skill 创建或更新地图”。不同版本的菜单名称可能略有不同，请以当前 Skills 页面为准。
打开 WorkBuddy SkillsCodex 与 ChatGPT
使用上方的 npx skills add 命令可将同一版本安装到 Codex、Claude Code、Cursor 等已支持 Agent 的目录；如需单独指定，替换 --agent '*' 为具体 Agent 名称。在 ChatGPT 中，若工作区已启用 Skills，请通过 Skills 界面导入完整发布包。