SuperAPI AI 工具集

task-handoff

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:把一个延续任务写成一份决策完整的任务交接文件,交给全新的、独立会话执行。适用于需要稍后或在别处继续的工作;若现在就要实现已批准的计划,应使用会话内交接技能。

主要能力:从参数或上一轮对话推断未完成步骤;核对涉及仓库的说明、任务面与工作区状态,区分已完成、部分完成与剩余工作,并保留用户与并发智能体的改动;把任务归类为 implementation、investigation、research、audit 或 operations 之一,并按主要交付物选取;判断执行方式为 simple 或 complex,仅在委派能实质改善延迟、正确性或验证时才标为 complex。

产出位置:单仓库交接写入 <仓库>/.ai/task-handoffs/<名称>.md;跨两个及以上仓库才写到 ~/Desktop/.ai/task-handoffs/<名称>.md。跨仓库文件需含 ## Repository order 章节,按序列出仓库的根、角色、写入范围、前置条件、本地验证及各自的 ai-coord start 命令,并指定首个攻坚仓库作为 Codex 启动目录。文件名须匹配 ^[A-Z][A-Z0-9](_[A-Z0-9]+)[.]md$,不强制 PLAN_ 前缀。

使用方式:先在外部的草稿文件(如 $TMPDIR)中一次性写好正文,正文以单个 H1 开头,不加 YAML frontmatter,不写由工具追加的类别、执行状态与清理章节;再用校验命令预检,最后发布:

ai-handoff create --check --repo '<仓库>' [--repo '<其他仓库>' ...] [--launch-repo '<首攻仓库>'] [--before-work-skill '<codex-handoff 绝对目录>'] --category '<类别>' --task '<简述>' '<名称.md>'

发布时把 --check 换成 --draft '<草稿路径>'。工具会规范化仓库为 Git 顶层目录并去重,校验后原子写入、不覆盖已有文件,并复制生成的 Codex 命令(经 pbcopy/pbpaste 回读校验)。complex 交接需传 --before-work-skill,指向可读的 SKILL.md 所在绝对目录。非交互式 ai-coord 发现项分诊用 --no-clipboard,文件名 FINDING_<大写ID>.md,正文保留原 ID 拼写的 Source finding: 行;交互式创建后在发布成功后运行 ai-coord finding handoff '<原ID>' --path '...'。

限制:只写一份文件,绝不自行实施、编辑受跟踪文件、提交、推送、启动 Codex 或编排子智能体,也不归档交接(归档命令为 ai-handoff archive '<绝对路径>',由接收方完成后执行)。仓库集合或操作顺序不明时应先停止。成功时报告交接路径、启动仓库、类别、执行方式与 Codex 命令,且不执行该命令。