Gitea Tea 是一个技能,用于在明确涉及 Gitea 或其 tea CLI 时,通过已安装的 tea 命令行工具管理 Gitea 资源。它不适用于通用的 Git、GitHub、gh 或注册表请求,也不会因为无关语境中出现“tea”一词而激活。
用途:该技能围绕 Gitea 的仓库、议题、拉取请求、发布和 Actions 等资源进行管理。它要求用户指定或已有仓库上下文能确定 Gitea 实例,不假设特定主机,并遵循用户或仓库的语言约定处理议题和拉取请求。
主要能力:技能提供读取和写入两类操作示例,包括列出议题、查看拉取请求详情、创建议题或 PR、添加评论、合并 PR、检查 Actions 运行等。它强调通过 tea --help 和子命令帮助解析目标、可用的子命令、别名、标志和输出格式,并自动调整示例,不要求特定 tea 版本。技能建议优先使用显式的 --login 和 --repo 选项,并在需要时通过 tea api 验证身份和仓库访问。
使用方式:技能加载后,首先读取 tea --help 及相关命令本地帮助,检测可用能力。在检出目录中检查 git remote -v,并使用 tea login list --output json 查找可用实例。匹配请求的 URL 到登录名、仓库所有者/名称和议题/PR 编号。所有示例均视为模板,需根据已安装帮助解析后再执行。写操作前需确认实际分支、本地差异和远端头,写操作后应读取受影响资源并报告 URL 和已验证状态。对于缺失的原生操作,可在 tea api 可用且满足权限时使用 API 回退,但不得因命令无法运行而放弃目标选择器、过滤器或安全条件。
适用场景:适用于明确提及 Gitea 或 tea CLI 的请求,例如管理 Gitea 议题、拉取请求、发布、Actions 或通过 tea api 进行 API 操作。也可用于在多个登录账户中匹配指定 Gitea 实例的场景。
限制:技能不替代 git commit 或 git push;tea 的认证与 Git SSH/HTTPS 认证是分开的,添加 tea 登录不会配置 Git 凭据。不要打印或嵌入秘密,保持 TLS 验证启用。若多个账户匹配且上下文无法区分,应询问使用哪个账户。对于不确定的写结果,应先检查远端状态再重试,避免重复创建或评论。API 回退需匹配服务器能力和端点权限,不能假设最新公共 API 适用。若 tea api 不可用,需报告能力缺口而非静默更改任务。