使用指南
自造工具与技能
做熟了的事,ta 自己写成工具;工具留在这具身体上,说明书(技能文档)随灵魂同步,到了新身体照着再做一遍。
#它是什么
同一件事做过几次、步骤稳定、以后还会用,ta 会把它写成自己的工具。之后它和内置工具一样出现在 ta 的工具表里,一步调用。做梦时 ta 也会回顾最近做过的事,看看有没有值得沉淀的。
每个自造工具分成两半:
| 放在哪 | 同步吗 | |
|---|---|---|
| 工具本身(可执行的脚本) | 这具身体的家目录 tools/<名字>/ | 不同步,只属于这具身体 |
说明书(技能文档 SKILL.md) | 灵魂仓库 skills/<名字>/ | 随灵魂同步到所有身体 |
图表加载中…
#为什么这样分
不同身体的环境不一样:手机上是 Termux,电脑上是完整的 Linux,命令和路径都不同。直接把脚本复制过去,多半跑不起来。所以只同步意图——用途、参数、思路、依赖、怎么验证、踩过的坑——实现由 ta 在每具身体上按说明书自己做。
ta 在一具新身体上醒来,看到灵魂里有说明书、这里却还没有对应的工具,就会知道可以照着做一个。
说明书采用 Agent Skills 开放格式,装了灵魂桥的 Hermes、OpenClaw 也能直接读。
#你能控制什么
- 造工具默认每次询问:工具是之后会被执行的代码,所以新建、改写都会先请你批准。可以在 控制 → 能力授权 里改成允许或禁止。
- 调用按「执行命令」检查:工具声明的类别不能放宽闸门。
- 在沙箱里运行:和 ta 的其他命令一样,看不到基座的密钥目录;超时整组停掉;每次调用都写审计。
- 控制 → 工具:查看这具身体上的工具,停用、启用或删除(可以连说明书一起删)。手机上不编辑代码。
#实现细节
工具的文件格式(tool.json + tool.sh / tool.mjs)、校验规则与闸门见源码仓库的 ARCHITECTURE.md §5.2;技能文档的格式见灵魂仓库规范。