SuperAPI AI 工具集

ticket-tracker

办公与效率

查看项目

更新于 10-16 02:35

技能介绍

用途:Ticket Tracker 是 GitHub Issues 之上的实时状态机层。当请求涉及工单的当前状态(如“我的工单在哪”“看看看板”)而非新建工单时使用。它只读取和移动工单,不负责调查或提交新工单。

主要能力:每个工单只带一个 status:* 标签,状态依次为 status:backlog、status:ready、status:in-progress、status:in-review、status:done。无 status:* 标签的开放 issue 视为 backlog;done 表示已合并或关闭,关闭 issue 是终态动作。允许前进,也允许回退(如 review 打回 in-progress);除非用户明确要求,拒绝跳过多个状态的移动。

使用方式:首次在仓库中需确认标签存在,不存在则创建: gh label list --search status: | grep -q status: || { gh label create "status:backlog" -c "#cccccc" -f gh label create "status:ready" -c "#0e8a16" -f gh label create "status:in-progress" -c "#1d76db" -f gh label create "status:in-review" -c "#fbca04" -f gh label create "status:done" -c "#5319e7" -f } 展示看板时读取实时状态并按列分组,不从缓存文件渲染: gh issue list --state open --limit 200
--json number,title,labels,assignees
--jq 'sort_by(.number)' 移动工单时替换标签,确保只剩一个 status:*: gh issue edit <number>
--remove-label "status:<from>"
--add-label "status:<to>" 若当前状态未知,先执行 gh issue view <number> --json labels。移到 done 时同时 gh issue close <number>;移出 done 时 gh issue reopen <number>。编辑后重新读取并说明新位置。

适用场景:在已有工单流程中维护看板、推进状态、查看分配情况。新增工作应交给 triage-issue(缺陷)或 /to-tickets(计划工作),本技能不重复这些流程;若请求隐含创建 issue,先转交,再打初始状态标签并展示看板。

限制:依赖 GitHub CLI 与仓库标签;状态只存于 GitHub;不负责调查、提交或生成路线图;路线图卡片是功能层级,与本看板层级不同,不应互相替代。