soul 用于在当前仓库中引用另一 Oracle 的身份资料、技能和经验。它读取原仓库中的身份文件,为技能建立相对符号链接,并提供经验文档标题索引;原仓库继续作为这些资料的来源。
主要流程
先按用户提供的路径或名称定位 Oracle,再查看身份文件、技能清单和预计链接变化。确认后建立链接,将链接记录到 .claude/souls/<name>.json,并把相应路径加入本地 .git/info/exclude。已有同名技能会提示读取原路径,不再建立重复链接。
使用边界
借来的技能仍从原仓库读取,涉及原仓库相对路径的命令需在正确位置运行;当前仓库的规则优先。发现目标路径已经被 Git 跟踪时,应先停止并向维护者说明。移除时仅删除清单中仍指向该 Oracle 的符号链接,不删除真实目录。移除链接也不能清除对话里已读取的身份信息,切换身份时应说明这一限制。
以上介绍依据本条目已保存的英文原文整理。原文和安装身份保留;本次未执行其中的命令,未实测第三方项目。