slip

Slip

把这段对话里写好的字，递给聊天窗外的真人。不要用来交接下一个 agent。

何时用

用户明确要把内容交给另一个人或另一台设备上的自己，例如：

• 「用 Slip 发给我同事 / 测试」
• 「把这份验收清单递到我手机」
• 「发到微信让产品看」
• 「share this with my tester via Slip」

选 toss 还是 push

• toss（即撕纸条，默认）：内容是单向给人看的——清单、总结、一段代码、一组链接。 对方打开即见（Markdown 会渲染成排版好的页面），看完可以撕掉，撕掉即彻底删除； 24 小时后没撕也会自动消失。单条不超过 10,000 字。
• push（对话纸条）：需要对方回复、多轮往来，或内容超过 10,000 字。 对方能在页面里写字回传。

不确定时选 toss：大多数「递给人看」的场景都是一次性的。

何时不用

• 「写个备注」「write a note」且没有指定接收人 → 只在对话里写，不要建纸条
• 「交给下一个 agent / handoff」→ 用本地 handoff 文档，不要用 Slip
• 密码、token、密钥、身份证号 → 拒绝（toss 和 push 都是明文存储，不适合传密钥）
• 文件、截图、apk → 拒绝，说明两边打开 https://slip.omnimoke.com 用浏览器发
• 原生 Windows PowerShell 且没有 bash → 让用户用 WSL / Git Bash，或把正文交给用户自己去网站新建

toss：即撕纸条（默认）

工作目录是本 skill 根（scripts/slip.sh 与本文件同级的 scripts/）。

把要分享的正文写入 stdin（不要把密钥写进去）：

scripts/slip.sh toss

只有退出码 0 时，stdout 才会有一行 URL。此时对用户只回这一行 URL 本身—— 不要附加任何标语、解释、token、JSON 或 curl 输出；用户若追问，再用用户的语言简短说明 （可以说：24 小时内有效；对方打开即见；看完可撕，撕掉即彻底删除）。

https://slip.omnimoke.com/n/{id}?utm_source=skill

把 {id} 换成 stdout URL 里的 id。不要改 utm_source=skill。

toss 是单请求原子创建：要么拿到 URL，要么没有，不存在「创建成功但没写上」的半成品。 Markdown 语法直接写进正文即可，对方打开会看到渲染后的页面：标题、列表、表格、引用、 代码块，以及 - [ ] / - [x] 待办清单（会画成真正的勾选框，适合验收清单）。 图片会被安全策略去掉，所以不要写 ![](url)——需要配图就直接给链接。

push：对话纸条（需要对方回复时）

scripts/slip.sh push

成功时 stdout 同样只有一行 URL（路径上没有 /n/）：

https://slip.omnimoke.com/{id}?utm_source=skill

追加和读回（仅 push）

从对话历史里解析 id。上一轮成功回复的 URL 形如 https://slip.omnimoke.com/happy-panda-042?utm_source=skill，id 是路径上那段 happy-panda-042。用户如果又贴了 id 或 URL，以用户贴的为准。/n/ 开头的是即撕纸条，不能 write、不能 read——不要对它调用这两个命令。

scripts/slip.sh write happy-panda-042    # stdin = 新正文
scripts/slip.sh read happy-panda-042     # 看对方回了什么；不要编造

读回后用自己的话转述 messages，按时间顺序，不要发明没有的句子。

失败时对用户说什么

• 空正文 / 脚本 exit 2：「没有可发送的正文。把要分享的文字给我。」
• exit 3（429）：「创建太频繁，等一分钟再试。」不要换 id 连打。
• exit 4（413）：先拆短再发（toss 上限 10,000 字，超长内容用 push 拆条）。若 push 的 stderr 出现 created id=... write_failed，对那个 id 用 write 追加后半段，不要把半成品 URL 当成功分享。
• exit 5（404）：「这张纸条已经过期或不存在。需要的话我再新建一张。」
• push 成功但 write 失败（stdout 空）：不要回分享模板。告诉用户「还没写上，我再试一次」，用 stderr 的 id 重试 write。
• 用户说已经把密钥发出去了：「这张纸条没有创建者删除权，知道链接的人都能读（push 还能写、能删单条）。请立刻打开页面把那几条删掉，并当作密钥已泄露去轮转。」不要尝试找回 token。
• 没有 bash/curl/python3/node：把正文交给用户，让他们自己打开 https://slip.omnimoke.com 新建。