轻量级多 Agent 协作接力工具。
npm install -g agent-handoffagent-handoff init my-project编辑 my-project/brief.md 描述你的需求。
agent-handoff status my-projectagent-handoff next my-project将输出的 Prompt 复制到 TRAE 新 Task 中执行。
创建新的 workspace。
agent-handoff init <name> [--path <path>]参数：
<name>- workspace 名称--path, -p- 父目录路径（默认当前目录）
显示 workspace 状态。
agent-handoff status [workspace] [--json]参数：
[workspace]- workspace 路径（默认当前目录）--json, -j- JSON 格式输出
输出下一步执行指令和 prompt。
agent-handoff next [workspace] [--copy] [--no-event]参数：
[workspace]- workspace 路径（默认当前目录）--copy, -c- 复制 prompt 到剪贴板--no-event- 不写入 events.jsonl
校验 workflow 与产物结构。
agent-handoff validate [workspace]手动推进 workflow 状态，并可写入事件。
agent-handoff advance [workspace]查看或生成配置文件。
agent-handoff config [workspace]读取 workspace 下的自动化操作日志并生成报告（json/markdown/html）。
agent-handoff report [workspace] [--format markdown|json|html] [--session <id>] [--screenshots] [--output <path>]导出静态 Web Timeline Viewer（离线 HTML，可直接打开）。
agent-handoff export [workspace] --format web [--output <dir>] [--limit <n>]生成 workspace 索引，并支持 registry 管理。
agent-handoff index [workspace] [--add] [--remove <pathOrName>] [--list] [--output <file>] [--json]在多个 workspace 索引上执行搜索。
agent-handoff search <query> [--workspace <pathOrName...>] [--type <t...>] [--step <id...>] [--work-item <id...>] [--limit <n>] [--json]对两个 workspace 做基于索引的差异对比。
agent-handoff diff <left> <right> [--format text|markdown|json] [--path <p...>] [--context <n>]输出 workspace 统计信息（summary/full）。
agent-handoff stats [workspace...] [--registry] [--mode summary|full] [--format json|markdown]<workspace>/
├── workflow.yaml # 工作流定义
├── state.json # 当前状态
├── brief.md # 需求描述
├── events.jsonl # 事件日志
└── steps/
└── <nn>-<id>/
└── output.md
MIT