用途:在 Gitea/Forgejo 上创建拉取请求(PR)。核心命令为 tea pulls create,默认交互式,将当前分支作为 head 提交到默认分支。
主要能力与用法:可通过参数指定标题、描述、head、base、标签、指派人和里程碑,例如 tea pulls create --title "Add auth" --description "Implements JWT" --head "feature/auth" --base "main" --labels "bugfix" --assignees "sh" --milestone "v1.0"。从 fork 创建时使用 head 前缀写法:tea pulls create --head "contributor:feature-branch" --base "main"。
WIP 约定:当 Forgejo/Gitea 工作流把 WIP 标题视为草稿式 PR 时,使用普通 tea CLI,在标题前加 WIP:,如 tea pulls create --title "WIP: Feature" --head feature-branch,也可附带 --base develop。
快速模式:先 git push -u origin HEAD,再 tea pulls create --title "$(git log -1 --format=%s)" --head "$(git branch --show-current)"。
找回已创建的 PR:tea pulls create 的输出面向人类阅读。自动化需要 PR 编号或 URL 时,不要解析命令输出,改用结构化分支查询脚本 actions/pull-requests/find-by-branch.py,可用 --head "$(git branch --show-current)",或 --head "contributor:feature-branch" --base main。该脚本按匹配的每个 PR 输出一个 JSON 对象(JSONL),便于 jq 或智能体解析。
内置动作只用于补齐 CLI 缺口,见 actions/pull-requests/README.md;解析 actions/... 路径时使用本技能目录下的 actions/ 目录。当用户指明 login、remote、backend 或 repository 时,给内置动作传显式作用域参数(--login、--remote 或 --repo),否则内置动作采用 active-host-first 发现。
限制:资料未提供安装命令、鉴权配置、依赖版本及错误处理细节,暂未提供。