Agent Skills
返回列表
缺失SKILL.md资料

缺失SKILL.md资料

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 安装 @org-yvge8exz/aicaigou-saas-installer。

技能介绍

解决什么问题

AI Agent 要调用爱采购的业务接口,前提是本机跑起对应的 CLI,并把配套的 cai-* skills 装到 Agent 能读取的位置。麻烦在于:npm 默认只把 skills 落到 ~/.agents/skills/,而多数 Agent 运行时只认会话当前目录下的 SKILL.md,两边路径对不上,装完等于没装。这个技能解决的就是「装得对、装到位、凭证不泄漏」这一件事。

核心能力与关键步骤

  • 步骤一:安装 CLI。在 SKILL.md 所在目录执行 npm 安装,拉起爱采购 CLI。
  • 步骤二:搬运 skills。npm 装完的文件需要从 ~/.agents/skills/ 迁到 Agent 实际读取技能的目录;目标路径 DST 取本 SKILL.md 所在目录的上一级,不要硬编码,否则换会话或换目录就会失效。
  • 步骤三:获取 Token。Agent 提示用户联系爱采购代理商拿到 API Token,拿到后再继续,不要编造,也不要跳过。
  • 步骤四:配置 Token。Token 只能留在内存态配置里,不要在对话中回显,也不要写入任何文件。
  • 步骤五:验证。执行 auth status --verify,返回 "ok": true 即配置成功;退出码 3 表示 Token 无效或已过期,需让用户找代理商重新获取。

装完后要告知用户 skills 装到了哪个目录、一共几个,重启会话后自动生效。本次对话如需立即使用,直接读 $DST/cai-shared/SKILL.md——它是所有 cai-* skill 的必读入口,含全局参数与错误处理约定。

适用边界与注意点

  • 前置环境只有 Node.js(npm),没有其它运行时依赖。
  • DST 必须相对当前 SKILL.md 路径推导,任何写死的绝对路径都视为错误实现。
  • Token 的获取依赖代理商人工介入,Agent 不能自行申请或生成;过期后也没有自动刷新机制,只能重新走一遍获取流程。
  • 升级时重复前两步即可,Token 无需重新配置;但如果 skills 目录被清理,需要整包重装。

使用场景

  • 在AI Agent项目中需调用爱采购API,需确保CLI与cai-* skills正确安装至Agent可读取的目录
  • 通过npm安装后发现skills落在~/.agents/skills/而非当前会话目录,需手动迁移并验证路径
  • 从爱采购代理商获取API Token后,需安全配置且不回显不落盘,执行auth status验证有效性
  • CLI升级后Token配置失效,需在保留现有安装基础上重新执行安装与迁移步骤

适合人员

  • 构建爱采购AI助手的开发者,需处理CLI安装与skills路径适配问题
  • 维护Agent运行时环境的运维人员,需确保技能目录结构符合Agent读取规范
  • 对接爱采购API的技术负责人,需安全处理Token获取与验证流程
  • 支持多Agent框架的团队,需标准化技能安装与升级的SOP