Skip to content

xinetzone/SpecWeave / .agents/skills/agent-task-handoff

agent-task-handoff

Verified

当用户要把一件有外部副作用的事交给 AI Agent(浏览器自动化、手机助手、桌面 Agent、外包或实习生)执行,或出现『AI 说做了却没生效』『同一任务越跑越贵』『第一次让 AI 碰陌生项目』时,必须使用此技能。五模式编排:P1 定路线(底座先行)→ P2 建地图(只讲不改)→ P3 写任务书(做什么/条件/停点/回报/红线)→ P5 控成本(步数与停点前移)→ P4 排障(分链定位);排障时反向从 P4 回到 P3。另含四张补充卡(E1 四问成技 / E2 证据先行 / E3 单产出拆分 / E4 双闸门),覆盖把重复流程写成技能、失败先取证、多段编排与不可逆动作能力层兜底。产出可验收的委托契约、步数台账与排障记录;不替代需求澄清,不替用户执行不可逆动作。

FileKindSize
SKILL.mdskill md33.7 KB
evals/evals.jsonconfig3.6 KB
references/step-ledger.mdmarkdown2.2 KB
references/task-brief-template.mdmarkdown3.6 KB
references/triage-worksheet.mdmarkdown2.7 KB

references/step-ledger.md

View on GitHub
---
title: "三段任务卡与步数台账"
source: "../SKILL.md#44-p5-控成本截图成本裁剪"
---

# 三段任务卡与步数台账

> 用于图形界面多步任务(手机 App、浏览器自动化、桌面 Agent):把成本当作任务设计的因变量。

## 一、步数估算口径

| 动作 | 计步 |
|---|---|
| 一次搜索 / 一次输入关键词 | 1 步 |
| 一次筛选 / 一次排序 | 1 步 |
| 进入一次详情页 | 1 步 |
| 一次表单填写 | 1 步 |
| 一次返回 / 翻页 | 1 步 |

估算目的不是精确预测,而是**识别哪一段占步数最多**。

## 二、三段任务卡

| 段 | 目标 | 完成标志 | 典型步数占比 | 失败后的动作 |
|---|---|---|---|---|
| 侦察 | 摸清候选范围与筛选条件 | 候选清单(名称/关键属性/价格) | 高 | 只重跑本段,不改停点 |
| 选定 | 在候选中确定目标 | 一个明确目标 + 依据 | 低 | 收紧条件后重跑侦察 |
| 决策 | 执行不可逆或有副作用的动作 | 到达停点或人工确认 | 低但代价高 | 停下,交回人工 |

分段的价值:把探索成本与不可逆成本分开,任一段失败只重跑该段。

## 三、步数台账模板

| 日期 | 任务类型 | 段 | 步数 | 重试次数 | 费用 | 验收结果 | 备注 |
|---|---|---|---|---|---|---|---|
|  |  | 侦察/选定/决策 |  |  |  | 通过/不通过 | 贵在哪一段 |

规则:

- 无账单时用步数作代理指标(费用 ≈ 步数 × 单步成本),并在备注注明「代理口径」。
- 失败重试的累计费用必须合并记录,不能只记成功那一次。
- 第二次执行同类任务时与基线比较;步数下降但验收项减少,不算优化成功。

## 四、停点前移对照

| 当前停点 | 可前移到 | 代价变化 |
|---|---|---|
| 结算页确认前 | 商品详情页 | 少 1–2 步,且完全避开下单链路 |
| 商品详情页 | 搜索结果列表页 | 少 N 步,但需要列表页已含验收字段 |
| 全文读取后总结 | 摘要/目录页判断相关性 | 少 N 步,适合大批量筛选 |

前移的前提是:**停点位置仍能满足全部回报项**。回报项不够时,先加字段再前移,不要用「少看一页」换「验收变松」。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall