Orb

调研开源 repo 看「可偷什么」时，用这个流程——克隆读全源、按 ROI 排清单、审视现有系统、偷抽象不偷代码、融入现有机制不做加法。Use when 用户发 GitHub 链接 + 问「可以偷师 / 借鉴什么」，或你提议要参考外部项目。

Session 收工标准 SOP——任何路径触发「收工」（reaction ✅ / 文字「收工 / wrap up / 闭包」/ cron 自动）都走同一动作链：自测 → commit（含受保护路径 override 规则）→ 清过程产物（临时 spec / debug 输出 / dry-run 文件 / 中间 patch）→ 报 commit hash + 清理清单。Use when 用户说「收工 / 闭包 / wrap up / OK 收工 / 结束这一段」，或 ✅ reaction 触发 inject 含「收工」字样。

Bug 修复 / 排查场景，连续 2 次假设或 patch 没命中根因时强制停手出 audit。Use when 同一 bug 已经试过 ≥2 次修复、症状仍在或换了形态再现、即将动「第 3 刀」时；触发关键词：「还是有这个问题」「又出现了」「同样的报错」「再试一次」「这次应该」。不适用于一次就 reproduce + 一次修好的场景。

存档目录，非可用 skill。

何时调 AskUserQuestion 工具（出 Slack Block Kit 选择卡）vs 何时直接做 / 文字反问。Use when 用户指令含「帮我看下 / 可以吗 / 你看着办 / 哪个 / 选 / 用 X 还是 Y」等歧义表达；或动作不可逆（push/删/对外发）且有多个等价方案；或同一指令有 ≥2 种合理解读且代价差异大。Skip when 自己能 grep/读文件查到、常规决策、thread 近 5 条已有就近答、cron worker。

改动开工前强制评估爆炸半径，避免「修一漏二 / 头疼医头」。Use when 改动涉及：删除文件/符号、重命名、路径迁移、接口签名变更、状态机修改、短路逻辑修正、配置 key 改名，或用户原话含「改 X / 删 X / 重命名 / 迁移 / 重构 X / 修这个 bug」+ 该 X 在多处被引用。不适用于纯新增、孤立 bugfix（无外部依赖）、文档/注释改动。

声明≠现实——任何「X 已配置 / 已声明 / 已建立」必须配 margin 量化 + detection 机制，否则把声明当现实。Use when 设计依赖外部能力的方案（vendor partnership / TTL refresh / cron schedule / health check / 配额申请 / SLA 承诺）；或评审「我们已经 X」「客户说会 X」「config 配好了」类陈述；或排查「明明配了为什么没生效」类问题。

代码任务委派三层决策——自己做 / 本 session sub-agent（Task tool）/ 外部 Codex session（spec 文件）。Use when 任何代码/调研/重构任务开工前判断谁来做，或用户说「派个 agent」「让 codex 搞」「并行跑」。

commit message 必带 lineage 锚点——若改动来自 spec / lesson / 决策原文，message 必须引用源路径。Use when 准备 git commit、用户说「提交」「commit」「频繁 commit」、或起草 commit message 时。

对外交付前 7 点审查——受众/边界/事实/措辞/语言/脱敏/可追溯性。Use when 发送邮件、提案、报告、Slack 代言消息前，或 Karry 说「对外」「发给客户」「正式发」。

任务开工前用这个 skill 评估是否需要先写 spec。触发：涉及 ≥3 模块、>30 文件改动、>10 步骤、架构级决策、或用户说「先出方案 / 先写 spec」。生成的 spec 放 workspace/specs/

Orb 的 13 条执行方法论——踩坑即记录/边界处悲观/Fail-fast/状态诚实/副作用留据/共识即持久化/收尾清理是完工必做项等，每条含触发条件和反例。Use when 面临决策点、报告任务结果、调外部 API、处理用户纠正、设计多步流程、声称完工时。

Use when about to claim a bug is "已修复 / 已改正 / fixed / resolved / 修好了" — requires producing a diff anchor (file:line showing the actual change) AND a receipt (failing repro that now passes, or log showing the original symptom is gone). 仅声明「我改了」「应该好了」「逻辑上对」不构成验收。补充 verification-before-completion 的修复场景专项门槛。

生成横向翻页网页 PPT（单 HTML 文件），含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格：① "电子杂志 × 电子墨水"（衬线 + 流体背景 + 暖色） ② "瑞士国际主义"（无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮）。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT，或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"时使用。

Open Design 渐进式设计工具索引——113 skills + 145 design systems 目录，按需加载到 workspace

通用 CLI 框架——79+ 适配器把网站/App 转为 CLI。Use when 需要把新外部服务（GitHub/Notion/Slack/X 以外）包成 CLI、或查已有适配器能力。X/Twitter 场景改走 x-twitter skill。

Reaction quick-reply 信号统一协议——✅/👉/🚀/🔄/✋/👀 六个 reaction（以及对应文字打「收工 / 继续 / 派吧 / 换条思路 / 先停一下 / 展开看看」）触发后的语义解读 + 动作链。✅ 收工含完整 SOP（自测 → commit → 清过程产物 → 报告）。Use when reaction inject 触发 / 用户文字命中其中关键词 / 多步任务自评估走收尾 / cron 自动 wrap-up。🔥 rerun 不在此 skill 范围（adapter 硬编码）。

真相源单一律——意图 / 逻辑 / 状态三层都禁止「真相源数量 > 1」，否则必 drift。Use when 设计新模块/新流程时面对一个概念有多处可能维护其状态、值或定义；或排查 drift 类 bug（A 处和 B 处不一致）；或重构时合并散点逻辑/共享 worker 创建/状态机生命周期对齐时。

Slack 按钮点击 (block_action) 的确定性路由协议——新建审批卡按钮时必须在 `profiles/<your-profile>/scripts/handlers/` 下放同名 handler 脚本，adapter 按 action_id 直接执行（零 LLM、零 worker fork）。Use when 需要新建带按钮的 Slack 卡片、修改 handler 脚本、或排查按钮点击无响应。

Slack Web API curl 命令参考——发/更/删消息、thread reply、reactions.add、文件上传 v2、读 thread、频道/用户查询、Block Kit 选型、token 提取、URL→ts 转换、常见坑全集。Use when 查 API 命令语法/参数、排查 `invalid_blocks`/`not_in_channel`/`missing_scope`/消息只剩首行/attachment 静默丢失、或需要 `reactions.add`/`files.getUploadURLExternal`/`chat.getPermalink` 的具体 curl 示例。

Slack 频道结构化输出规范 + Web API 写法——标题主消息、Block Kit thread、6 档 markdown、跨调用 anchor、curl/token/读写消息命令。Use when 准备向非 DM 频道推送 cron 报告/审批卡/反思/周报/持仓/书签/调研，或需要用 Slack API 读写消息、管理 thread、发送 Block Kit/attachment、更新并回读验证。

非琐碎任务开工前显式化「我的解读 / 隐含假设 / 已知 tradeoff / 倾向方案」让 Karry 拦截；收工时同等显式化「这次牺牲了什么 / 高风险点要不要派 attacker 二次攻击」。Use when 任务 ≥3 步、含歧义解读、涉及 tradeoff、用户指令模糊有多种合理解读，或非琐碎任务即将收尾出结论。短指令作用层判定走 terse-intent-classifier。

短指令作用层判定协议——对 ≤15 字、含指代词或动词型短指令（改/删/切/跑/停/加）或元问句（更优雅/更好/有没有办法）的输入，先判层再动手。Use when 用户消息 ≤15 字且含「这个/那个/上面/刚才/它」指代，或形如「改一下」「删掉它」「跑一下」「有没有更优雅的方法」「切回 X」这类省略了对象或意图的短输入。

长 thread 切题后的对象重定协议——thread 历史 ≥5 条且检测到切题信号时，回复前必做「用户最后显式问题对象 vs 待发回复对象」一致性校验，不一致则改写或反问。Use when Slack thread 历史 ≥5 条且当前用户消息出现切题信号（主题词突变、问句指向新实体、时间线跳跃、出现「另外」「话说」「回到 X」「换个话题」等切题语，或 ≥3 turn 后用户显式问题对象与最近 assistant 回复对象不同）。

状态放行三层阶梯（attempted / observed / confirmed）—— 汇报任务、API、命令、消息或外部动作状态时强制分层，避免把"动作已发起"误写成"结果已达成"。Use when 准备写「任务已完成」「API 返回成功」「exit code 0」「用户已收到」「ok:true」类状态汇报；或在 cron 报告 / Slack 回报 / project status / receipt 中表达完成度时。

第三方 API / SDK 集成开工前，强制先列参数 checklist 并对照官方文档逐项验证（名称 / 类型 / 必填 / 默认 / 上限），通过后再编码——不是「写完再调通」。Use when 新接 vendor API/SDK（Slack / LongPort / freee / LLM API 等）、既有集成追加新 endpoint 或新字段、用户说「调通某接口」「接入 X」「集成 X」。

对外合作文档（交付文档 / POC 文档 / Solution Doc / 提案书）必须为每个「需对方执行」的动作写清具体操作入口（URL / 工单系统 / 脚本路径 / 联系人 + 联系方式 / 步骤编号）。Use when 给客户、vendor、合作方写交付文档、POC 文档、Solution Doc、提案书；或检视已有对外文档是否抽象到无法执行。