该技能用于通过 tea 命令行管理 Gitea/Forgejo 的 issue 标签,覆盖列出、创建、更新、删除以及将标签应用到 issue 的完整流程。
用途:帮助你在终端中集中管理仓库的 issue 标签,无需进入网页界面即可完成标签的增删改查,并可在创建或编辑 issue 时直接引用标签。
主要能力: 标签列出(list):支持简洁输出(-o simple,推荐)、JSON 输出(--output json,建议仅在配合 jq 解析时使用),以及导出到文件(--save,采用 tea 内部格式)。 标签创建(create):可指定名称与颜色(颜色需带 # 前缀,如 #d73a4a),也可附加描述;支持通过 --file labels.csv 从文件批量导入。 标签更新(update):按 ID 更新名称、颜色或描述。示例:tea labels update --id 5 --name "bugfix" --color "#d73a4a",或只更新描述。获取 ID 时可使用 tea labels list --output json | jq '.[] | {id, name, color}'。 标签删除(delete):按 ID 删除,例如 tea labels delete 5。 应用到 Issue:创建 issue 时可指定标签(tea issues create --title "Fix login" --labels "type:bug,priority:high");编辑 issue 时可添加或移除标签(tea issues edit 42 --add-labels "status:in-progress"、tea issues edit 42 --remove-labels "status:needs-triage")。
使用方式:在已配置好 tea 的终端环境中执行上述命令。注意区分两种标识方式:在 tea issues 相关命令中通过名称识别标签,而在 tea labels update/delete 中通过 ID 识别;标签名称区分大小写;颜色值必须带 # 前缀。
适用场景:需要批量维护仓库标签体系、脚本化创建或清理标签、在自动化流程中为 issue 打标签的仓库维护者或开发者。
限制与注意事项:删除标签会将其从所有 issue 和 PR 中移除;更新和删除需要先用 JSON 输出获取标签 ID;未提供关于权限、认证配置或 tea 版本要求等信息。