常见问题

技能装到哪里？

默认装进所选智能体的用户级技能目录（不同智能体的位置不同）；也可以用 --dir 指定任意目录。安装过程不写入系统目录，不需要管理员权限。

会不会影响智能体原有配置？

不会改写智能体本身的配置项。需要写入配置的能力（例如把某个技能注册为本地服务）会在技能文档中说明，并在执行前展示将要写入的内容。

支持哪些智能体？

覆盖 Codex、Claude Code、Cursor、OpenCode、WorkBuddy、Windsurf、Kiro、Trae、Qwen Code、Comate、CodeBuddy、Kimi Code 等常见智能体。未收录的智能体用 --dir 指定技能目录即可。

可以离线用吗？

可以。技能本体零外部依赖（Python 3.8+ 标准库或 Node.js 18+），安装完成后核心能力离线可用；只有安装与更新需要访问包仓库。

我的数据存在哪里？

全部在本机：记忆、日志、报告都在用户指定的目录里。工具不上传原始内容，也不做跨设备同步。

怎么确认装的是哪个版本？

npx -y @yottameta/yotta-skills --list
npx -y @yottameta/yotta-skills doctor --dir <技能目录>

--list 显示清单版本与技能版本，doctor 检查本地已装技能的状态。

装错了或不想用了怎么办？

删除对应技能目录即可；也可以再次执行安装命令覆盖为指定版本。

报告里的问题需要马上处理吗？

报告是提示清单：先看级别与位置，再结合上下文判断。高风险项建议先停止使用相关技能或文件，人工确认后再处理。