用途:在 CawPlan 中定位需要 UX 跟进的工单,或汇总某产品 UX 成员的设计完成情况。
背景:工单的 ux 值有 NOT_REQUIRED、PENDING、READY,只有 PENDING 需要 UX 跟进。查询需用 cawplan tickets search(poll 不返回 ux),并传 --excluded_status_categories COMPLETE,CANCELED,因为工单关闭后 UX 仍可能为 PENDING。UX 查询需完整时间窗:--start_date 2000-01-01 --end_date <today>。分页时在 page_num * page_size < total 期间递增 page_num,以 total 作为结束信号。
入口路由:具体产品+版本走 A;具体产品无版本走 A 并询问是特定版本还是全部版本;高优先级或无版本走 B;团队/产品线走 C;某产品 UX 成员完成情况走 D。
A:先 cawplan products list --search,再 cawplan versions list <product_id>,产品名须精确或唯一匹配,否则列出候选询问。查询命令:cawplan tickets search --version_ids <version_id> --ux PENDING --excluded_status_categories COMPLETE,CANCELED --start_date 2000-01-01 --end_date <today> --page_size 100 --page_num 1,全部版本改用 --product_ids。
B:cawplan tickets search --priority CRITICAL,HIGH --ux PENDING --excluded_status_categories COMPLETE,CANCELED --start_date 2000-01-01 --end_date <today> --page_size 100 --page_num 1,可加产品/版本;结果按 CRITICAL → HIGH 排序。
C:先用 cawplan product-lines list --page_size 100 客户端匹配团队名,再 cawplan tickets search --product_line_ids <product_line_id> --ux PENDING --excluded_status_categories COMPLETE,CANCELED --start_date 2000-01-01 --end_date <today>,按优先级排序。
D:解析产品并读取 members.designers 名单,取 user_id 与显示名;无设计师则报告并停止。候选查询用 --ux PENDING,READY,加 --updated_start_date 与 --updated_end_date,且不加终态排除。对每个候选取 cawplan tickets history <product_id> <version_id> <ticket_id>,仅保留 changed_fields.ux 变为 READY、created_at 在窗口内、且 user_id 属于设计师名单的历史条目。按工单去重取最新事件,按操作者分组计数。
输出:每行显示 ID、标题、类型、优先级、产品/版本、负责人;B/C 按优先级降序;说明搜索窗口与排除终态;无匹配需明说。D 显示每位设计师的 UX-Ready 工单数与清单、窗口、所用产品名,并说明基于历史核实的 ux → READY 事件。
限制:产品/团队需精确或唯一匹配;不得用最接近名称;更新者必须是设计师;不以当前 ux 为 READY 或非设计师操作计数。参考 references/CAWPLAN_OPEN_API.md。