ticket-first gate 报错文案未说明工单绑定需用户侧引用（agent 自建票无法绑定会话） #10

New Issue

2026-10-22T07:15:30+08:00

fourbroad commented

2026-10-22 07:15:30 +08:00

环境

octopus desktop，ticket-first gate 处于 block 模式
场景：agent 驱动的工单工作流（本项目规则要求 agent 先立项再动手）

行为

会话原绑定工单 #192 随 PR 合并被 agent 正常关闭后，门重新武装（符合预期）；
agent 随即通过 tea（bash 未被门拦截）创建了新工单 #221；
agent 在助手侧文本与 task 委派 prompt 中多次引用 #221 / Closes #221，绑定均未注册——task / write 持续被拦，错误文案为 "reference it by number in this session, e.g. #1234"；
实测只有用户消息中出现工单号才能完成绑定。

问题定性（low severity，UX/文档）

报错文案未说明引用必须来自用户侧（用户消息 / 父级链接 / ticket-seeded 会话），照文案字面意思（"in this session"）agent 侧引用看似应生效，实际无效——浪费多轮重试；
设计张力：遵循 ticket-first 规则的 agent 会先自查自建票，但自建票无法由 agent 绑定，每个 agent 驱动流程都会撞这堵墙，且无文档提示需要用户回执。

建议修复（不改变安全语义）

报错文案改为明确指引：「请用户在回复中包含工单号（如 #1234）以完成会话绑定」；
文档补充说明：agent 自建工单不能通过 assistant 侧引用绑定，需用户 echo 一次工单号。

不是 bug 的部分

不要求门接受 assistant 侧引用——门的人为锚定意图正确，接受自引会使票门形同虚设。

## 环境 - octopus desktop，ticket-first gate 处于 **block 模式** - 场景：agent 驱动的工单工作流（本项目规则要求 agent 先立项再动手） ## 行为 1. 会话原绑定工单 #192 随 PR 合并被 agent 正常关闭后，门重新武装（符合预期）； 2. agent 随即通过 tea（bash 未被门拦截）创建了新工单 #221； 3. agent 在**助手侧文本与 task 委派 prompt** 中多次引用 `#221` / `Closes #221`，绑定均未注册——`task` / `write` 持续被拦，错误文案为 "reference it by number in this session, e.g. #1234"； 4. 实测只有**用户消息中出现工单号**才能完成绑定。 ## 问题定性（low severity，UX/文档） - 报错文案未说明引用**必须来自用户侧**（用户消息 / 父级链接 / ticket-seeded 会话），照文案字面意思（"in this session"）agent 侧引用看似应生效，实际无效——浪费多轮重试； - 设计张力：遵循 ticket-first 规则的 agent 会先自查自建票，但自建票无法由 agent 绑定，每个 agent 驱动流程都会撞这堵墙，且无文档提示需要用户回执。 ## 建议修复（不改变安全语义） 1. 报错文案改为明确指引：「请用户在回复中包含工单号（如 #1234）以完成会话绑定」； 2. 文档补充说明：agent 自建工单不能通过 assistant 侧引用绑定，需用户 echo 一次工单号。 ## 不是 bug 的部分不要求门接受 assistant 侧引用——门的人为锚定意图正确，接受自引会使票门形同虚设。

fourbroad referenced this issue from a commit

2026-10-24 20:44:26 +08:00

[ticket-first-copy-10][iter-1] fix(session): ticket-first rejection copy states user-side binding requirement

fourbroad closed this issue

2026-10-25 07:19:43 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Octopus/octopus-release#10