把一个 Issue 交给 T3 Code,交付要落到哪一步
T3 Code v0.1.11 把 Issues 页面、任务线程和 PR 放到一起;用可复制的任务说明区分关联、实现、审查与持续监看,避免把有链接当成已完成。

T3 Code v0.1.11 新增的 Issues 页面,让你在工作台里看问题描述、评论、关联 PR,并把问题挂到线程上。要让 Agent 接手修复,还需要写清复现条件、改动范围和完成标准;关联 Issue、创建 PR、监看检查和允许合并,是不同的动作。
本文于 2026 年 11 月 21 日核对 v0.1.11 公告与该版本的源码管理文档。下面提供可复用的交接流程;没有替真实仓库创建、评论或合并 Issue/PR,也没有验证全套托管平台集成。
Issues 页面能看见哪些项目
从侧栏工具入口或命令面板 Open issues 打开。文档列出 GitHub、GitLab、Azure DevOps 和 Forgejo 项目,按跟踪平台账号分组。可以按开关状态、与你的关系、平台和项目筛选,用 Views 保存搜索、筛选与排序。组底部的 Load more 才会继续读取更早条目;列表不是整个账号所有历史的完整证明。
Linear 需要在 Settings → Source control & issues 配置 API Key,再为项目选择对应团队。它不应被理解为“仓库能连 GitHub,Linear 就自动有权限”。
打开一条 Issue,面板可展示描述、评论、状态变化、关联 PR、标签和负责人。是否能编辑、关闭或重新打开,取决于平台与账号权限。通过不属于该仓库的项目读取的 Issue 显示为只读;远程连接写入跟踪平台还需要 source-control:write scope。
发给 Agent 之前,把问题写成可验收的任务
先读后续评论:原帖可能缺少触发条件,维护者也可能已经缩小范围。让 Agent 从“用户说导出乱码”直接跳到改整个导出模块,很容易扩大任务。
可以把下面模板补成真实项目资料。它是普通任务说明,不是 T3 的配置文件:
处理 Issue:<完整 Issue URL>
目标:让 CSV 导出的中文在约定读取方式下保持正确。
复现:<样例数据、操作步骤、预期和当前结果>
起点:<仓库、目标分支或必要的未发布提交>
范围:先定位编码与响应头;不顺带重写导出接口。
验收:用同一份公开样例验证表头、中文、行数与读取方式,
运行仓库已有的相关检查,报告实际结果。
交付:关联 Issue,列出修改、验证、剩余问题与提交号;
如创建 PR,说明目标分支、PR URL 和当前 head。
权限:本次可以在任务分支实现并创建草稿 PR;合并由我决定。
最后一行应按你的真实授权修改,模板不会替你授予操作权限。第一次接手陌生问题,先要求定位与计划也可以;已经明确允许实现时,不必让 Agent 每个可逆步骤都停下来等一句“继续”。
给任务独立改动目录时,参考Worktree 与起始分支的选择。如果它依赖另一条尚未合并的变更,说明需要哪些提交,比只说“基于最新代码”更准确。
把链接挂到线程,方便之后核对
在 Issue 面板里选 Link to this thread;线程侧栏的 Issue 标记可打开 Linked items,一起查看问题与 PR。Agent 也有 link_issue 工具。关联的价值是保留上下文入口,不能据此认为实现已符合原问题。
PR 可以用 Link pull request、Linked items 或对话链接的菜单关联。一个线程可包含多个 PR。检查关联时同时核对仓库、目标分支和每个 PR 的 head;名字相近的另一个仓库,并不是当前修复的交付物。
准备审查时,至少看三种材料:原问题的触发条件是否被覆盖、差异是否留在约定范围、检查是否针对当前 head。截图和“测试通过”的一句话不足以替代对应输入、命令和结果。需要在另一台机器看改动页面时,可用远程浏览器与端口转发确认查看的是这份代码。
“帮我盯着 PR”会持续到什么时候
文档把关联 PR与监看 PR分开。明确要求 watch、monitor 或 babysit 后,Agent 可用 watch_pull_request 注册服务器监看;线程活跃期间,服务器按约两分钟间隔检查状态,在失败、审查变化、冲突等事件时唤醒 Agent。
这不等于每两分钟调用一次模型,也不等于无人值守自动合并。只请求监看时,检查结束后可能仍要你决定下一步;如果明确要求“某人批准后合并”,任务才包含这个后续动作,并且仍受平台规则约束。
| 状态或动作 | 应如何理解 |
|---|---|
| PR 已关联 | 线程记住了这条交付物 |
| 正在监看 | 服务器跟踪变化,符合条件时唤醒 Agent |
| 检查通过 | 对应 head 的检查完成;还要核对审查和合并条件 |
| 线程 Settle / Archive / Stop | 监看会结束,之后需要重新安排 |
| PR 重新打开 | 需要重新注册监看 |
还有退出条件:连续只有评论的唤醒、连续读取失败也会结束监看;限流则暂停。子任务不能自行监看 PR,由委派它的主线程负责。因此把“子 Agent 写完代码”与“主线程接管 PR 后续”写进交付说明会更稳妥。
T3 的原生合并工具还会核对 Agent 最后读过的提交:其后若有人推送,合并会被拒绝。遇到这种情况先重新读差异和检查,不能把旧批准笼统套到新内容。
最后留下一份能接手的交付记录
一份实用记录可以只有几行:Issue URL、仓库与分支、当前 head、PR URL、实际验证命令及结果、尚未满足的条件、谁负责下一步。监看在运行时也写明;只在本地提交,就明确没有推送或部署。
若任务需要等 CI 事件再触发,继续看T3 定时与 Webhook 任务,避免为一个 PR 同时堆几套重复唤醒。实现与审查用到了不同模型时,按Usage 与实际账单范围核对调用,不能用 PR 数量推算费用。


