用途:factory-tickets 是软件工厂的只读个人工作清单引擎,为用户提供即时、实时、可执行的活跃队列概览,按“下一步动作”而非抽象状态分类。它直接对接外部工单跟踪器与 PR 托管平台(GitHub、GitLab、Linear、Jira),通过平台无关的集成层(factory-mission/references/tracker-integration.md)工作。
适用时机:会话开始时或规划当天工作时,用于确认接下来需要关注的事项;识别哪些 PR 可合并、受阻或等待评审反馈;发现未分配、未受阻(spec-gated)且可执行的工单。不适用:修改工单状态、负责人或正文(严格只读);执行或实现任务(应使用 factory-mission)。
主要能力与流程:1)发现当前跟踪器提供方与凭据,识别已认证用户登录名,将搜索限制为本人创建的 PR 与分配给本人的工单(或显式指定的其他登录名)。2)双权限分页查询:不逐项轮询,而是对 PR 与 Issue 各执行一次分页搜索,一次拉取全部活跃集合,包含草稿状态、评审决定、未解决线程、具名检查状态、可合并性,以及标题、描述、状态、标签、里程碑和关联项目元数据。3)平台无关的匹配证据:仅在有明确证据时关联 PR 与工单,如跟踪器建立的关闭链接、分支名含工单号、PR 标题显式命名工单号;无证据则留空,绝不凭文本提及猜测。4)按下一步动作分类:每个条目归入唯一优先级分区,包括“活跃 PR(轮到我)”(合并、处理评审反馈、修复具名失败检查、回复 N 个评论线程、完成草稿)、“活跃 PR(轮到对方)”(等待评审、等待 CI)、“已合并但工单仍开启”(验证后关闭)、“现在可领取(待办)”(spec-gated、agent-can-execute 且无 PR 认领,为空时显式显示 none)、“等待他人”(存在未解决 blocked-by 依赖并指明阻塞工单)。Epic 与父工单放入附录,显示子项数量与进度,不混入活跃任务列表。
限制与安全约束:严格只读,无法编辑、评论、创建或修改任何工单、标签、负责人或看板字段,不含 gh 或 glab 写命令;无缓存,每次运行实时拉取;不做汇总猜测,不将已取消或跳过的作业报告为失败,而是读取并命名确切的失败上下文;若用户请求含查询解析器无法识别的词,不丢弃,而是在表格下方“Unparsed Terms”区列出,让用户知晓被忽略的内容。