SuperAPI AI 工具集

handoff

智能体与模型

查看项目

更新于 10-16 09:30

技能介绍

用途:把正在进行的 Codex 工作迁移到全新线程,不携带旧对话记录,同时为下一线程留下足够的持久上下文。仅在用户显式调用 $handoff 时使用。

主要能力:确认转移目标;捕获当前执行上下文,包括工作目录、仓库根目录、当前分支(git rev-parse --abbrev-ref HEAD)、git status --short 中有意义的变更文件,以及环境暴露的模型与推理强度;保留用户约束、已确认决策、阻塞项、验证结果和待解决问题;创建或更新交接文件;构建自包含的全新线程提示词;在工具可用时创建线程。

使用方式:若用户只要提示词,则不创建线程;若看不到线程创建工具,先搜索 create_thread,再退回手动提示词;优先使用全新 create_thread 流程而非 fork,除非用户明确要求复制线程历史。仓库内实现工作优先使用仓库本地交接文件,先检查 plans/、docs/plans/、.pi/plans/、现有 PLAN*.md 等约定;无约定时在仓库根目录使用 PLAN-<SPECIFIC-SLUG>.md;已有相关交接文件则更新而非重复创建。交接文件建议包含 Purpose、Current state、Next implementation slice、Files to inspect first、Validation、Fresh-thread prompt,通常约 80-140 行。创建线程时使用 Codex 应用线程工具而非 shell 命令,先调用 list_projects 选择匹配项目,再用 create_thread 指定项目与本地环境;除非用户明确要求,否则省略 model 与 reasoning 覆盖参数。

限制:无匹配项目时改为提供手动提示词,不创建无关的无项目线程;提示词应要求新线程先读交接文件、运行 git status --short、仅检查列出的文件,并从下一步实现切片继续;除非用户要求,不得暂存、提交、推送或创建 PR。最终回复应简短,报告交接文件路径与创建的线程,或提供精确的续接提示词,不做对话回顾。