feat: add generic gitea issue-drive skills

This commit is contained in:
zfc
2026-03-12 15:53:26 +08:00
parent b36220b33a
commit 22765a2917
15 changed files with 1681 additions and 109 deletions
+46 -5
View File
@@ -47,7 +47,8 @@ RequirementsDoc ──▶ PRD ──▶ FeatureSummary ──▶ DevelopmentPlan
| | `doc` | `/doc` | `/doc` | 渐进式文档生成器,先写梗概再迭代完善 |
| | `update` | `/up` | `/up` | Skill 升级优化 |
| | `deploy` | `/deploy` | `/deploy` | Drone CI/CD 全流程部署引导 |
| | `issue` | `/issue` | `/issue` | 通用 Gitea issue 查询(列表 + 单条详情 |
| | `issue` | `/issue` | `/issue` | 通用 Gitea issue 查询(支持当前仓库自动识别 |
| | `issue-drive` | `/issue-drive` | `/issue-drive` | 通用 Gitea issue 拆单与批量创建 |
| | `changelog` | `/changelog` | `/changelog` | 一键发版(日志 + commit + tag |
> Codex 兼容历史 `$skill` 写法,但本文档统一以 `/skill` 作为主入口。
@@ -146,20 +147,26 @@ Codex:
请用 wf skill 根据 PRD 生成 FeatureSummary
请用 go skill 按 doc/tasks.md 执行未完成任务
请用 doc skill 为认证模块写一份 300 字以内的使用说明
请用 issue skill 查看 https://git.example.com/owner/repo 的 open issues
请用 issue skill 查看当前仓库的 open issues
请用 issue-drive skill 把当前 bug 拆成两张 Gitea issue
```
### 查询 Gitea Issues
先配置:
先配置环境变量
```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
/issue
/issue 7
/issue owner/repo
/issue https://git.example.com/owner/repo
/issue https://git.example.com/owner/repo --state=all --limit=20
/issue https://git.example.com/owner/repo 7
@@ -168,11 +175,43 @@ Claude Code:
Codex:
```text
/issue
/issue 7
/issue owner/repo
/issue https://git.example.com/owner/repo
/issue https://git.example.com/owner/repo --state=all --limit=20
/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
Claude Code:
```bash
/issue-drive
```
Codex:
```text
/issue-drive
```
自然语言也可以:
```text
请用 issue-drive skill 把当前仓库这个线上 bug 拆成两张 Gitea issue
请用 issue-drive skill 给 owner/repo 创建一张工程任务 issue,内容是补齐告警和回归测试
```
`issue-drive` 会优先从当前仓库 `origin` 推断目标仓库;如果你显式指定其他仓库,skill 会按用户输入创建 issue。
### 工作流总览
```
@@ -210,13 +249,15 @@ your-project/
│ ├── rr/
│ ├── rp/
│ ├── ...
── iter/
── iter/
│ └── issue-drive/
├── .claude/
│ └── skills/ # ← Claude Code Skills 安装位置
│ ├── rr/
│ ├── rp/
│ ├── ...
── iter/
── iter/
│ └── issue-drive/
├── doc/ # ← 文档输出位置
│ ├── RequirementsDoc.md
│ ├── PRD.md