用途
setup-tracker 用于为单个代码仓库配置问题跟踪器(Issue Tracker),使 triage、to-prd、to-issues、pickup、morning-brief 这组技能在运行时知道该仓库使用哪种跟踪器,以及如何与它交互。实际配置的解析由这些技能在运行时完成。
主要能力
- 询问并记录该仓库使用 github(默认)还是 linear。
- 将偏好写入仓库 CLAUDE.md 的
## Issue tracker小节下的tracker:行;如果该小节不存在则创建,例如:
## Issue tracker
tracker: linear
- 在 GitHub 模式下:无需其他配置;技能会加载
~/.claude/skills/triage/issue-tracker-github.md,并在首次使用时初始化标准标签。 - 在 Linear 模式下:遵循“采纳而非强加”原则,从不初始化分类;先检查实际工作区并搭建映射:
- 用 list_teams、list_issue_statuses、list_issue_labels 读取当前分类体系。
- 把每个标准角色(needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix、bug、enhancement、prd)映射到已有标签、工作流状态或 Project 机制;若某角色没有对应目标,询问维护者,不创建新的分类。
- 将映射记录在仓库的 CLAUDE.md(或仓库的 docs/agents/triage-labels.md)中,供 Linear 适配器使用。
- 标出发现的重复项(例如移植标签与原生标签并存),交给维护者决定是否弃用。
- 设置 triage-disclaimer 偏好:询问维护者 AI 生成的分诊评论是否应附带免责声明
> *This was generated by AI during triage.*。默认在 Linear(共享团队空间)为开启,在 GitHub(个人跟踪器)为关闭;如需非默认值,在## Issue tracker小节下写入:
triage-disclaimer: off
未设置时,技能会采用与跟踪器对应的默认值。
- 最后向维护者确认已写入的配置。
使用方式
在仓库上下文中调用该技能,按提示选择跟踪器类型,对 Linear 选项按引导完成映射与偏好设置即可。Linear 的操作约定位于 ~/.claude/skills/triage/issue-tracker-linear.md。
适用场景
需要让问题分诊与产品需求流转类技能在特定仓库上统一使用 GitHub 或 Linear,并保持团队既有标签体系不被随意改动时。
限制
- 仅用于单仓库的跟踪器配置,具体分诊等业务逻辑由其他技能承担。
- Linear 模式下不自动创建标签、状态或分类,缺失映射需维护者决定。
- 关于安装方式、支持的平台与收费,资料暂未提供。