Add unified Gitea skill workflows

This commit is contained in:
zfc
2026-03-12 17:23:08 +08:00
parent 22765a2917
commit c27b85193f
26 changed files with 2725 additions and 48 deletions
+45 -12
View File
@@ -47,8 +47,9 @@ RequirementsDoc ──▶ PRD ──▶ FeatureSummary ──▶ DevelopmentPlan
| | `doc` | `/doc` | `/doc` | 渐进式文档生成器,先写梗概再迭代完善 |
| | `update` | `/up` | `/up` | Skill 升级优化 |
| | `deploy` | `/deploy` | `/deploy` | Drone CI/CD 全流程部署引导 |
| | `issue` | `/issue` | `/issue` | 通用 Gitea issue 查询(支持当前仓库自动识别 |
| | `issue-drive` | `/issue-drive` | `/issue-drive` | 通用 Gitea issue 拆单与批量创建 |
| | `gitea` | `/gitea` | `/gitea` | 统一 Gitea 入口(issue / push / PR |
| | `issue` | `/issue` | `/issue` | Gitea issue 只读专用入口(支持当前仓库自动识别) |
| | `issue-drive` | `/issue-drive` | `/issue-drive` | Gitea issue 拆单与批量创建专用入口 |
| | `changelog` | `/changelog` | `/changelog` | 一键发版(日志 + commit + tag |
> Codex 兼容历史 `$skill` 写法,但本文档统一以 `/skill` 作为主入口。
@@ -147,22 +148,58 @@ Codex:
请用 wf skill 根据 PRD 生成 FeatureSummary
请用 go skill 按 doc/tasks.md 执行未完成任务
请用 doc skill 为认证模块写一份 300 字以内的使用说明
请用 issue skill 看当前仓库 open issues
请用 gitea skill 看当前仓库 open issues
请用 gitea skill 给当前分支开 PR 到 main
请用 gitea skill push 当前分支到远端
请用 issue-drive skill 把当前 bug 拆成两张 Gitea issue
```
### 查询 Gitea Issues
### 统一 Gitea 入口
先配置环境变量:
```bash
export GITEA_TOKEN=your_gitea_token
export GITEA_ISSUE=your_gitea_write_token # 可选,写 issue 时优先使用
export GITEA_BASE_URL=https://git.example.com # 可选;owner/repo 简写或 SSH origin 时推荐配置
```
Claude Code:
```bash
/gitea 看当前仓库 open issues
/gitea 查 issue 7
/gitea 把这个 bug 拆成两张 issue
/gitea push
/gitea 给当前分支开 PR 到 main
/gitea 看当前仓库 open PR
/gitea 在 PR 12 留言:已完成回归
```
Codex:
```text
/gitea 看当前仓库 open issues
/gitea 查 issue 7
/gitea 把这个 bug 拆成两张 issue
/gitea push
/gitea 给当前分支开 PR 到 main
/gitea 看当前仓库 open PR
/gitea 在 PR 12 留言:已完成回归
```
说明:
- `gitea` 是统一入口,会按自然语言自动路由到 issue、issue-drive、push 或 PR
- push 默认先预检,再执行;只有明确要求 force push 时才会强推
- PR v1 只支持同仓库 list / create / comment
- 直接 `/gitea 看 issue 7``/gitea push` 时,skill 会优先从当前项目的 `git origin` 自动识别仓库
-`owner/repo` 时,需要 `GITEA_BASE_URL`
- 当前仓库 `origin` 是 SSH 地址时,建议配置 `GITEA_BASE_URL`,避免 Web/API 域名与 SSH 域名不一致
### 专用入口:查询 Gitea Issues
Claude Code:
```bash
/issue
/issue 7
@@ -183,13 +220,7 @@ Codex:
/issue https://git.example.com/owner/repo 7
```
说明:
- 直接 `/issue``/issue 7` 时,skill 会优先从当前项目的 `git origin` 自动识别仓库
-`owner/repo` 时,需要 `GITEA_BASE_URL`
- 当前仓库 `origin` 是 SSH 地址时,建议配置 `GITEA_BASE_URL`,避免 Web/API 域名与 SSH 域名不一致
### 创建 Gitea Issues
### 专用入口:创建 Gitea Issues
Claude Code:
@@ -250,6 +281,7 @@ your-project/
│ ├── rp/
│ ├── ...
│ ├── iter/
│ ├── gitea/
│ └── issue-drive/
├── .claude/
│ └── skills/ # ← Claude Code Skills 安装位置
@@ -257,6 +289,7 @@ your-project/
│ ├── rp/
│ ├── ...
│ ├── iter/
│ ├── gitea/
│ └── issue-drive/
├── doc/ # ← 文档输出位置
│ ├── RequirementsDoc.md