145 lines
4.4 KiB
Markdown
145 lines
4.4 KiB
Markdown
---
|
||
name: gitea
|
||
description: 统一 Gitea 总入口，支持 issue 查询、issue 拆单创建、git push 和 PR 基础操作，优先从当前仓库 origin 自动识别目标仓库。
|
||
---
|
||
|
||
# Gitea - 统一入口
|
||
|
||
> **定位**：这是 Gitea 总入口。适合“看 issue”“拆 issue”“把提交 push 上去”“给当前分支开 PR”“在 PR 里留言”这类场景。
|
||
>
|
||
> `issue` 和 `issue-drive` 继续保留：`issue` 负责只读查看，`issue-drive` 负责拆单和创建工单；`gitea` 负责统一路由和 push / PR 能力。
|
||
|
||
当用户调用 `/gitea`、`$gitea`，或自然语言要求“处理 Gitea / push / PR / issue”时，按以下规则执行。
|
||
|
||
## 1. 先路由意图
|
||
|
||
先从用户输入里判断目标动作：
|
||
|
||
- 包含“看 / 查 / list / open / closed / #123 / issue”，且没有“拆 / 建 / 提 / 创建工单”语义：走 `issue`
|
||
- 包含“拆 issue / 提 issue / 创建工单 / 沉淀问题”语义：走 `issue-drive`
|
||
- 包含“push / 推送 / tag 推上去 / 推当前分支”语义：走 push 流程
|
||
- 包含“PR / pull request / 拉请求 / 合并请求 / 评论 PR”语义：走 PR 流程
|
||
|
||
如果一句话里同时包含多个动作，先按用户描述顺序执行；默认不要自作主张串更多步骤。
|
||
|
||
## 2. 环境变量
|
||
|
||
统一使用：
|
||
|
||
- `GITEA_TOKEN`：必需
|
||
- `GITEA_BASE_URL`：可选；当传 `owner/repo` 或当前仓库 `origin` 是 SSH 地址时推荐配置
|
||
|
||
如果缺少 `GITEA_TOKEN`，先提示用户配置后停止，不继续执行 API、push fallback 或 PR 操作。
|
||
|
||
## 3. Issue 路由
|
||
|
||
如果判定为只读 issue：
|
||
|
||
- 直接执行 `issue` skill 的流程
|
||
- 保持它的输入规则：当前仓库自动识别、支持 `owner/repo`、支持完整仓库 URL、支持单条 issue 编号
|
||
- 不在 `gitea` 里重复抄写 `issue` 的长说明
|
||
|
||
如果判定为 issue 拆单 / 创建：
|
||
|
||
- 直接执行 `issue-drive` 的流程
|
||
- 先整理事实和证据，再创建 issue
|
||
- 创建时统一使用 `GITEA_TOKEN`
|
||
|
||
## 4. Push 流程
|
||
|
||
Push 一律先跑预检，再决定是否执行：
|
||
|
||
```bash
|
||
# Codex
|
||
python3 .codex/skills/gitea/scripts/push_gitea.py
|
||
|
||
# Claude Code
|
||
python3 .claude/skills/gitea/scripts/push_gitea.py
|
||
```
|
||
|
||
规则：
|
||
|
||
- 默认推当前分支到同名远端分支
|
||
- `ahead=0` 时直接告诉用户“没有可推送提交”
|
||
- `dirty=true` 时明确提示“只会推送已提交内容”
|
||
- 分支 diverged 时停止，不自动 rebase，也不自动 force
|
||
- 只有用户明确要求“强推 / force push”时，才带 `--force`
|
||
|
||
真正执行时：
|
||
|
||
```bash
|
||
# Codex
|
||
python3 .codex/skills/gitea/scripts/push_gitea.py --execute
|
||
|
||
# Claude Code
|
||
python3 .claude/skills/gitea/scripts/push_gitea.py --execute
|
||
```
|
||
|
||
若用户明确要求强推：
|
||
|
||
```bash
|
||
python3 .codex/skills/gitea/scripts/push_gitea.py --execute --force
|
||
```
|
||
|
||
执行策略：
|
||
|
||
- 先尝试 `git push origin branch:branch`
|
||
- 若远端鉴权失败，再使用 `GITEA_TOKEN` 调 `/api/v1/user` 获取登录名，构造一次性 HTTPS token URL 进行 fallback
|
||
- 不改写本地 `origin`
|
||
|
||
## 5. PR 流程
|
||
|
||
PR 只做三件事：`list`、`create`、`comment`。
|
||
|
||
### 5.1 看 PR
|
||
|
||
```bash
|
||
# Codex
|
||
python3 .codex/skills/gitea/scripts/pr_gitea.py list --state=open --limit=20
|
||
```
|
||
|
||
### 5.2 开 PR
|
||
|
||
```bash
|
||
# Codex
|
||
python3 .codex/skills/gitea/scripts/pr_gitea.py create --base main --title "标题" --body "正文"
|
||
```
|
||
|
||
规则：
|
||
|
||
- `head` 默认当前分支
|
||
- `base` 默认远端默认分支；识别不到时再显式传 `--base`
|
||
- 如果当前分支还没推送到远端，脚本会先走 push 流程，再创建 PR
|
||
- v1 只支持同仓库 PR，不处理 fork 间 PR
|
||
|
||
### 5.3 在 PR 里留言
|
||
|
||
```bash
|
||
# Codex
|
||
python3 .codex/skills/gitea/scripts/pr_gitea.py comment 12 --body "已完成回归"
|
||
```
|
||
|
||
规则：
|
||
|
||
- PR 评论走 issue comment API，因为 Gitea PR 底层复用 issue 线程
|
||
|
||
## 6. 输出要求
|
||
|
||
- issue 查询：沿用 `issue` skill 的固定 Markdown 输出
|
||
- issue 创建：沿用 `issue-drive` 的创建结果输出
|
||
- push：输出预检 JSON 或执行结果 JSON，至少包含 `status`、`branch`、`ahead/behind`、是否执行、执行方式
|
||
- PR：输出 PR 列表或单条创建 / 评论结果 JSON，至少包含编号、标题、URL、状态
|
||
|
||
## 7. 用法示例
|
||
|
||
```bash
|
||
/gitea 看当前仓库 open issues
|
||
/gitea 查 issue 17
|
||
/gitea 把这个 bug 拆成两张 issue
|
||
/gitea push
|
||
/gitea 推送当前分支到远端
|
||
/gitea 给当前分支开 PR 到 main
|
||
/gitea 看当前仓库 open PR
|
||
/gitea 在 PR 12 留言：已完成回归
|
||
```
|