tstack takeover实战指南:AI Agent如何接手他人半成品PR并完成交付且保留署名

原创2026-10-30 18:10:151,421 阅读

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 结束后会汇报五件事:

  1. 继承了什么——接手时的状态与目标;
  2. 改了什么——为完成目标做的必要修改(不扩张范围);
  3. 如何验证——每一项改动对应的证据;
  4. 署名如何保留——author、co-author、PR 描述的致谢与原 PR 链接;
  5. 遗留决策——需要人类拍板的事项。

实战建议:让 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 从此有人接盘。

登录后查看全文
tstack