如何在 Claude Code、Codex 和 OpenCode 之间同步提示词和技能(不再因复制粘贴而走样)
跨电脑复用指令的实用工作流:唯一的事实来源、安全安装,以及在提供商需要磁盘文件时检测偏差。
- CLI
- 0.2.17
- 预览 ref
- a2c45c8
“技能”和可复用的提示词是个好主意。
但它们通常的管理方式就没那么好了:
- 一台机器上一个文件夹
- 另一台机器上另一个文件夹
- 一堆略有不同的版本
然后你开始一个会话,却说不清它实际用的是哪套指令。
这就是偏差问题。
这份指南介绍一种让提示词和技能在 Claude Code、Codex 和 OpenCode 之间保持一致的工作流。
简要总结
- 如果你想在多台电脑上获得可复现的行为,就需要提示词和技能的唯一事实来源。
- 如果你的提供商需要磁盘上的文件,你还需要一条安装/导出路径。
- 失败模式是悄无声息的偏差(你改了一份副本,忘了另一份)。
- Happier 是一种有帮助的选择:它把库当作事实来源,可以导出/安装到提供商原生位置,并跟踪链接和摘要,从而检测偏差而不是悄悄覆盖。
问题所在
可复用的指令只有在保持一致时才有用。
一旦你有了:
- 不止一台机器,或者
- 不止一个提供商,
……复制粘贴就成了隐患。
常见做法及其权衡
- 只保留一个 gist,需要时复制粘贴:可行,但靠手动,且不一致。
- 提示词的 Git 仓库:好一些,但你仍需安装/导出到提供商原生位置。
- 每个提供商单独一个文件夹:在你想让一条规则处处适用之前都还行。
如果你第一次接触 Happier
如果你之前没见过 Happier:它是一款开源配套应用(移动端/网页/桌面),用于跨电脑运行 Claude Code、Codex 和 OpenCode 等会话。
与本指南相关的是:它提供一个统一的提示词/技能库,以及安全地导出/安装到提供商原生位置的方式。
开始设置:
- 如何在手机上使用 Happier
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord(社区与支持): https://discord.gg/W6Pb8KuHfg
可行的工作流
1) 把库当作你的事实来源
思维上的转变是:
- 不要把
.claude/skills或.opencode/skills当作你的库 - 把它们当作导出目标
2) 想要快捷的输入框指令时,使用模板
如果你想要“/review”或“/ship-check”这样的快捷方式,使用插入已保存提示词的模板(Templates)。
这比复制粘贴更好,因为它会保持同步。
3) 也使用代理自己的命令和技能
从 0.2.16 开始,在新会话的输入框中输入 / 或 $,就能看到所选代理在这台电脑、这个项目和已连接账号上已经提供的命令或技能(在支持的情况下)。选择原生技能会直接使用代理自己的副本,因此不会在你的 Happier 库中添加重复项。发现功能需要代理及其登录在这台电脑上已就绪。
4) 用系统提示词附加内容实现持久行为
当你想让一条规则适用于每个会话(或某个配置)时,使用系统提示词附加内容(System prompt additions,应用中显示为“堆栈”)。
这样你就能让“我如何审查差异”保持一致,而不用反复输入。
5) 导出/安装到提供商原生位置(复制还是符号链接)
这是大家容易卡住的实际环节。
有些工具(或团队)需要磁盘上的真实文件:
.claude/skills.opencode/skills.agents/skills.claude/commands
所以你需要一条导出路径。
在 Happier 中,你可以把提示词和技能导出到机器上的目标位置,并选择安装方式:
- 复制(Copy):在目标位置写入一份独立副本。
- 适合需要完全自包含的文件夹时。
- 权衡:更新需要手动。
- Symlink:保留一份由 Happier 管理的实体副本,并把外部目标链接到它。
- 适合想让更新变得简单时。
- 权衡:有些环境不喜欢符号链接(或者你想要一个完全可移植的文件夹)。
这对多电脑工作流之所以重要,是因为你可以让同一套技能出现在多台电脑的提供商原生位置中,而不用维护多份逐渐走样的副本。
6) 密钥和提供商令牌:不要写进技能文件
一个常见错误是把 API 密钥放进技能包里。
这能用……直到你:
- 把技能导出到另一台机器
- 分享仓库
- 把技能粘贴到 issue 里
如果某个技能需要凭据,把技能当作代码,把凭据当作密钥:
- 保持技能内容通用
- 从环境变量或已保存的密钥机制中读取凭据
- 按配置/按机器绑定密钥
(如果你在用 Happier 配置,CLI 的密钥解析顺序很重要:环境变量 → 已保存的密钥绑定 → 交互式提示。)
7) 不要悄悄覆盖:检测偏差
这里有用的是一种安静的安全性:
- 如果外部副本发生变化,Happier 会检测到摘要不匹配
- 它不会悄悄覆盖你的文件
这意味着你可以在需要时有意在本地编辑,同时仍然知道自己已经不同步。