tstack takeover实战指南:AI Agent如何接手他人半成品PR并完成交付且保留署名
tstack takeover实战指南:AI Agent如何接手他人半成品PR并完成交付且保留署名
tstack 是一个面向 Claude Code 和 Codex 的 AI Agent 技能(Skills)合集,其中的 takeover 技能可以帮你解决一个真实痛点:同事或前任 Agent 留下的半成品 PR、分支、会话线程烂尾了,谁来接盘?takeover 能接手这些未完成的工作,沿着原始目标把它做完、验证、提交 PR 并看护到合并——同时完整保留原作者的 Git 署名和贡献者信用。本指南带你从零安装到实战,跑通整套 AI Agent PR 接手交付流程。
什么是 takeover:AI Agent 的"接盘侠"
takover 一句话定位:接手别人(或别的 Agent)的 PR、分支或 Agent 会话线程,完成原始目标,并保留原作者署名。
它的核心行为规则(源自 skills/takeover/SKILL.md):
- 接手的是目标,不是实现:先读懂原始 PR 想解决什么问题,不要因为"别的 Agent 已经写了"就盲目辩护或照搬实现;
- 交接物只是上下文,不是证据:交接说明、旧线程里的结论都要对照当前代码和最新 head 重新核实;
- 署名优先:保留 Git author 和 co-author trailer,在 PR 描述中致谢原始贡献者,并链接原 PR;
- 有边界:未经授权不合并、不关闭原始 PR,不改写他人工作。
为什么需要 takeover:半成品 PR 的三大困境
🧩 目标散落在旧对话里:Agent 线程中断后,真正的意图藏在多轮聊天记录中,新会话无从下手。 ⚖️ 署名容易丢:squash 合并、force push 之后,原始作者信息常常悄悄消失。 🔀 分支早已过期:主分支前进后,旧 PR 可能冲突、过时,甚至方向已错,机械 rebase 会把错误实现"翻新"。
tstack 的其他技能各司其职,而 takeover 把它们串成一条完整交付链路,依赖关系如下:
takeover会调用modernize、file-pr、babysit-pr和leaving-pr-comments,安装时请一并安装这些技能。
一键安装:两分钟上手 tstack
git clone https://gitcode.com/gh_mirrors/tst/tstack
cp -R tstack/skills/* ~/.claude/skills/ # Claude Code
cp -R tstack/skills/* ~/.codex/skills/ # Codex
前置要求(见 README.md):
- 已认证的 GitHub CLI(
gh),用于操作 PR; python3,供babysit-pr的 pr-wait 脚本使用;- 技能文件本身是"起点",建议在
CLAUDE.md或AGENTS.md里写入你的个性化配置。
takeover 实战:六步交付流程
第 1 步:读懂半成品——把交接物当上下文
takover 会读取源 PR(或分支、线程)的标题、描述、关联 issue、提交历史、review 意见以及用户后续的纠正,定位到实际代码和当前 head,连未提交的改动一并清点。
关键原则:把交接当作上下文,而不是证明。旧线程里说"修好了"不等于真的修好了。
第 2 步:保留署名——交接的"信用保险"
这是 takeover 最有价值的行为之一:
- 替换 PR 场景下,把原始 commit 导入新分支,自己的修复单独追加,不覆盖无关工作;
- 保留 Git authorship 与已有的 co-author trailer;
- PR 描述中写明原始贡献者,并链接原 PR;
- 若最终 squash 合并,在合并提交中用已验证的身份信息(而非猜邮箱)保留人类作者的署名。
⚠️ 注意:模型署名("Created with X in Y")不能替代人类贡献者署名,这一点在 skills/file-pr/SKILL.md 中同样被强调。
第 3 步:modernize 更新分支——先判断该不该继续
takeover 会调用 modernize 技能,把续作更新到目标基线和当前架构。modernize 的精髓是"现代化的是想法,不只是分支",它会给出三种处置建议:
| 处置 | 含义 | 动作 |
|---|---|---|
| MODERNIZE | 目标仍有用,实现形态正确 | rebase、解冲突、测试后更新分支 |
| REWORK | 目标有用,但实现方向已错 | 说明最小重写方案,停下等确认 |
| CLOSE | PR 已被取代或方向性错误 | 给出具体证据,不浪费时间 rebase |
即使 Git 报告无冲突,也不代表 PR 仍然合理——它还会检查:主分支是否已解决了同样的问题?API 或架构边界是否已变化?落库后是否会恢复旧行为或造成两套实现并存?
第 4 步:独立验证——绿了 mock 测试不算数
takover 要求独立复现原始故障并验证真实工作流:
- 按仓库自身的测试规范和权限执行检查;
- "绿色 mock 测试不能证明用户体验可用"——UI 和运行时行为要真正跑起来看;
- 无法验证的部分必须如实报告,而不是制造虚假的信心。
第 5 步:file-pr 提交 PR——用问题开场,而非改动清单
skills/file-pr/SKILL.md 对 PR 文案有一条很有用的规范:标题要说明为什么重要,而不是罗列改了什么。
- ❌
perf(server): negotiate permessage-deflate on the websocket - ✅
perf(server): cut websocket frame size by 70%+ with gzipping
描述部分先讲用户视角的问题,再简短说明方案,结尾附上模型与 harness 的署名行。
第 6 步:babysit-pr 看护——从创建到合并不停摆
skills/babysit-pr/SKILL.md 提供统一的看护脚本 pr-wait:
pr-wait <pr> [--repo owner/name] [--until ready|green|any-change]
它每发生一次真实事件输出一行(check 失败、新评论、review bot 完成、base 分支移动、PR 变为 BEHIND/DIRTY……),退出码 0 表示达到就绪条件。Agent 会在看护期间修复真实问题,对误报则用文字说明理由后再驳回——所有以用户身份发出的评论都会由 leaving-pr-comments 技能统一加上"🤖 某模型代表某用户发言"的标注,做到代发言透明可辨。
交付报告:takeover 的收尾清单
按照 skills/takeover/SKILL.md 的约定,takeover 结束后会汇报五件事:
- 继承了什么——接手时的状态与目标;
- 改了什么——为完成目标做的必要修改(不扩张范围);
- 如何验证——每一项改动对应的证据;
- 署名如何保留——author、co-author、PR 描述的致谢与原 PR 链接;
- 遗留决策——需要人类拍板的事项。
实战建议:让 takeover 发挥最大价值
💡 触发方式:直接对 Agent 说 "take over",或描述"帮我接手这个 PR/分支/线程"即可命中该技能。
💡 明确授权边界:合并、关闭原 PR 等操作只有在明确授权后才会执行,这正好把"破坏性动作"留给了人类。
💡 自定义你的技能:技能文件是起点而非终点,个人偏好(如评审用的模型组合)放进 CLAUDE.md / AGENTS.md,更新技能也不会丢失配置。
💡 组合使用:想让 Agent 全权闭环(改代码→证明→提 PR→看护→合并),可进一步使用 full-send(见 skills/full-send/SKILL.md);full-stop 则停在"PR 就绪待你合并"。
总结
tstack 的 takeover 把"接手半成品"这件又脏又累的事标准化了:读懂原始目标 → 保留署名 → modernize 判断去留 → 独立验证 → file-pr 规范提交 → babysit-pr 看护到就绪。对新手而言,最值得带走的两条经验是:交接物是上下文不是证据,以及模型署名不能替代贡献者署名——前者保证质量,后者保证体面。把这两个原则装进你的 Agent 工作流,烂尾 PR 从此有人接盘。