SuperAPI AI 工具集

forward

办公与效率

查看项目

更新于 10-16 01:57

技能介绍

用途

forward 是一个面向 AI 编程会话的交接(handoff)技能,用于在结束当前会话前,为下一次会话创建上下文记录。触发方式为用户说出 "forward"、"handoff"、"wrap up",或在结束会话前主动调用。核心目标是让下一次会话能快速了解:本次做了什么、还有哪些待办、下一步该做什么。

主要能力

该技能提供多种运行模式:

  • 直接运行:创建交接文件,展示计划,等待用户批准。
  • --bg:把整个交接任务交给后台 Haiku 子代理,立即返回、不阻塞,适合会话中途快照进度或结束时不想等待的场景。
  • asap(或 now):创建交接并立即提交、推送,无需批准,跳过计划模式。
  • --only:只创建交接文件,跳过计划模式,之后提示用户运行 /plan。

交接文件内容包括:本次完成事项、未提交文件、待办项、下一步具体动作、关键文件。

此外,该技能会从待办项中提取可执行条目,过滤掉非可执行(如含 monitor、watch、track、deferred、maybe、consider,或少于 4 个词)的条目,检查是否已有相似的开放 issue(标题不区分大小写匹配),经用户确认后可选地创建 GitHub issue,并将待办项写入 outbox。

使用方式

技能内包含会话检测逻辑:通过 git 根目录计算编码后的项目路径,定位 $HOME/.claude/projects/ 下最新的 .jsonl 文件,截取会话 ID 前 8 位用于追溯。交接文件路径通过解析 vault 路径(优先读取项目根下的 ψ 目录或符号链接)得到,写入 $PSI/inbox/handoff/YYYY-MM-DD_HH-MM_slug.md。写入时始终使用解析后的绝对路径,不直接使用 ψ/ 符号链接,也不把 vault 文件加入 git。

--bg 模式会启动一个后台 Agent(模型 haiku,run_in_background: true),由子代理挖取会话 JSONL 并写交接文件,完成后打印交接文件绝对路径,不进入计划模式、不提交任何内容。文档指出 Haiku 层适合此任务,因为这是从结构化 JSONL 中提取要点而非写作。

适用场景

适用于使用 Claude Code 进行长时间编程、需要跨会话保持上下文连续性的工作流。尤其适合会话结束前交接进度、整理待办、清理陈旧的未提交工作或分支。

限制

计划模式必须依次完成 EnterPlanMode、写计划文件、ExitPlanMode 三步,缺一不可,否则用户看不到批准界面。若用户再次调用 /forward,只展示已有计划,不重建交接文件。当 gh 不可用、仓库无 GitHub 远程或 gh 认证失败时,会静默跳过 issue 创建,仅写入 outbox。绝不自动创建 issue,必须经用户批准。是否强制提交或推送取决于所选模式。

关于收费、价格、平台支持范围等信息,资料中暂未提供。