Compare commits
2 Commits
6da34c4869
...
b36220b33a
| Author | SHA1 | Date | |
|---|---|---|---|
|
b36220b33a | ||
|
|
1c89cf94c6 |
157
.agents/skills/issue/SKILL.md
Normal file
157
.agents/skills/issue/SKILL.md
Normal file
@ -0,0 +1,157 @@
|
||||
---
|
||||
name: issue
|
||||
description: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。
|
||||
---
|
||||
|
||||
# Issue - 通用 Gitea Issue 查看
|
||||
|
||||
> **定位**：输入完整 Gitea 仓库 URL，快速查看 issue 列表或单条详情。默认只输出事实结果，不主动扩展成 roadmap、主题归纳或优先级分析。
|
||||
|
||||
当用户调用 `issue` skill、`/issue <repo-url>`、`$issue <repo-url>`、`/issue <repo-url> <issue-number>` 或自然语言要求“用 issue skill 查看某个 Gitea 仓库的问题”时，执行以下步骤。
|
||||
|
||||
## 1. 解析输入
|
||||
|
||||
- `repo-url` 必须是完整仓库地址，例如 `https://git.example.com/owner/repo`
|
||||
- 允许尾部带 `/` 或 `.git`，先规范化后再解析
|
||||
- 第二个位置参数如果是纯数字，视为 `issue-number`，进入详情模式
|
||||
- `--state` 仅支持 `open`、`closed`、`all`，默认 `open`
|
||||
- `--limit` 默认 `50`
|
||||
- 不支持只传 issue 编号；如果缺少仓库 URL，先提示正确用法再停止
|
||||
|
||||
规范化后，从 `repo-url` 提取：
|
||||
|
||||
- `origin`：例如 `https://git.example.com`
|
||||
- `owner`
|
||||
- `repo`
|
||||
- `repo_path`：例如 `owner/repo`
|
||||
|
||||
如果 URL 不是标准仓库地址，明确提示“仓库 URL 格式无效，需为 `https://host/owner/repo`”。
|
||||
|
||||
## 2. 检查环境变量
|
||||
|
||||
先读取环境变量 `GITEA_TOKEN`。
|
||||
|
||||
如果缺失，输出：
|
||||
|
||||
```bash
|
||||
❌ 缺少 GITEA_TOKEN
|
||||
|
||||
请先在当前 shell 或 .env 中配置：
|
||||
export GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
|
||||
然后停止，不继续请求 API。
|
||||
|
||||
## 3. 调用 Gitea API
|
||||
|
||||
不要调用仓库元信息接口，避免依赖 `read:repository` scope。仓库标题直接使用 `repo_path`。
|
||||
|
||||
### 3.1 列表模式
|
||||
|
||||
请求：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issues.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues?state=${state}&limit=${limit}"
|
||||
```
|
||||
|
||||
### 3.2 详情模式
|
||||
|
||||
先请求 issue 详情：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_detail.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}"
|
||||
```
|
||||
|
||||
再请求评论：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_comments.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}/comments"
|
||||
```
|
||||
|
||||
### 3.3 错误处理
|
||||
|
||||
根据 HTTP 状态码给出简短、直接的提示：
|
||||
|
||||
- `401`：`GITEA_TOKEN` 无效或未生效
|
||||
- `403`：token scope 不足，或当前用户无权访问该仓库/issue
|
||||
- `404`：仓库不存在，或该 issue 编号不存在
|
||||
- 其他非 `2xx`：输出状态码和响应中的 `message`
|
||||
|
||||
如果列表接口返回项里存在 `pull_request` 且非空，排除这些项，只保留 issue。
|
||||
|
||||
## 4. 格式化输出
|
||||
|
||||
优先使用 `jq` 解析 JSON；如果环境没有 `jq`，再退回模型手工整理，但输出结构保持一致。
|
||||
|
||||
### 4.1 列表模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
📋 {repo_path} Issues
|
||||
|
||||
状态: {state} | 数量: {count} | 限制: {limit}
|
||||
|
||||
| # | 标题 | 优先级 | 标签 | 状态 | 提出人 |
|
||||
|---|------|--------|------|------|--------|
|
||||
| 35 | 小红书笔记状态查询 | P:紧急 | P:紧急, 需求 | open | zhangsan |
|
||||
```
|
||||
|
||||
字段规则：
|
||||
|
||||
- `优先级`：从 labels 中提取首个匹配 `^P[:：]` 的 label，没有则填 `-`
|
||||
- `标签`：保留全部 label 原文，用 `, ` 连接；没有则填 `-`
|
||||
- `提出人`：优先显示 `user.full_name`，没有则显示 `user.login`
|
||||
- `状态`：直接显示 `open` 或 `closed`
|
||||
|
||||
如果过滤后没有任何 issue，明确输出“无符合条件的 issue”。
|
||||
|
||||
### 4.2 详情模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
## #{number} {title}
|
||||
|
||||
- 仓库: {repo_path}
|
||||
- 状态: {state}
|
||||
- 标签: {labels}
|
||||
- 提出人: {author}
|
||||
- 创建时间: {created_at}
|
||||
- 更新时间: {updated_at}
|
||||
|
||||
### 正文
|
||||
|
||||
{body 或 “无正文”}
|
||||
|
||||
### 评论
|
||||
|
||||
- {author} | {created_at} | {1-2 句摘要}
|
||||
```
|
||||
|
||||
规则：
|
||||
|
||||
- 正文为空时写“无正文”
|
||||
- 评论按时间顺序输出
|
||||
- 每条评论只保留 1-2 句摘要；不要整段照抄超长评论
|
||||
- 没有评论时明确写“无评论”
|
||||
|
||||
## 5. 行为边界
|
||||
|
||||
- 默认只做列表和单条详情，不主动做主题归纳、epic 合并、优先级建议
|
||||
- 用户后续如果要求摘要、优先级排序、相似 issue 合并，再基于已拉取的数据继续分析
|
||||
- 不要求 `GITEA_BASE_URL`
|
||||
|
||||
## 6. 用法示例
|
||||
|
||||
```bash
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge --state=all --limit=20
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge 17
|
||||
```
|
||||
157
.claude/skills/issue/SKILL.md
Normal file
157
.claude/skills/issue/SKILL.md
Normal file
@ -0,0 +1,157 @@
|
||||
---
|
||||
name: issue
|
||||
description: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。
|
||||
---
|
||||
|
||||
# Issue - 通用 Gitea Issue 查看
|
||||
|
||||
> **定位**：输入完整 Gitea 仓库 URL，快速查看 issue 列表或单条详情。默认只输出事实结果，不主动扩展成 roadmap、主题归纳或优先级分析。
|
||||
|
||||
当用户调用 `/issue <repo-url>`、`/issue <repo-url> --state=open|closed|all --limit=<N>`、`/issue <repo-url> <issue-number>`，或自然语言要求“用 issue skill 查看某个 Gitea 仓库的问题”时，执行以下步骤。
|
||||
|
||||
## 1. 解析输入
|
||||
|
||||
- `repo-url` 必须是完整仓库地址，例如 `https://git.example.com/owner/repo`
|
||||
- 允许尾部带 `/` 或 `.git`，先规范化后再解析
|
||||
- 第二个位置参数如果是纯数字，视为 `issue-number`，进入详情模式
|
||||
- `--state` 仅支持 `open`、`closed`、`all`，默认 `open`
|
||||
- `--limit` 默认 `50`
|
||||
- 不支持只传 issue 编号；如果缺少仓库 URL，先提示正确用法再停止
|
||||
|
||||
规范化后，从 `repo-url` 提取：
|
||||
|
||||
- `origin`：例如 `https://git.example.com`
|
||||
- `owner`
|
||||
- `repo`
|
||||
- `repo_path`：例如 `owner/repo`
|
||||
|
||||
如果 URL 不是标准仓库地址，明确提示“仓库 URL 格式无效，需为 `https://host/owner/repo`”。
|
||||
|
||||
## 2. 检查环境变量
|
||||
|
||||
先读取环境变量 `GITEA_TOKEN`。
|
||||
|
||||
如果缺失，输出：
|
||||
|
||||
```bash
|
||||
❌ 缺少 GITEA_TOKEN
|
||||
|
||||
请先在当前 shell 或 .env 中配置：
|
||||
export GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
|
||||
然后停止，不继续请求 API。
|
||||
|
||||
## 3. 调用 Gitea API
|
||||
|
||||
不要调用仓库元信息接口，避免依赖 `read:repository` scope。仓库标题直接使用 `repo_path`。
|
||||
|
||||
### 3.1 列表模式
|
||||
|
||||
请求：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issues.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues?state=${state}&limit=${limit}"
|
||||
```
|
||||
|
||||
### 3.2 详情模式
|
||||
|
||||
先请求 issue 详情：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_detail.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}"
|
||||
```
|
||||
|
||||
再请求评论：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_comments.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}/comments"
|
||||
```
|
||||
|
||||
### 3.3 错误处理
|
||||
|
||||
根据 HTTP 状态码给出简短、直接的提示：
|
||||
|
||||
- `401`：`GITEA_TOKEN` 无效或未生效
|
||||
- `403`：token scope 不足，或当前用户无权访问该仓库/issue
|
||||
- `404`：仓库不存在，或该 issue 编号不存在
|
||||
- 其他非 `2xx`：输出状态码和响应中的 `message`
|
||||
|
||||
如果列表接口返回项里存在 `pull_request` 且非空，排除这些项，只保留 issue。
|
||||
|
||||
## 4. 格式化输出
|
||||
|
||||
优先使用 `jq` 解析 JSON；如果环境没有 `jq`，再退回模型手工整理，但输出结构保持一致。
|
||||
|
||||
### 4.1 列表模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
📋 {repo_path} Issues
|
||||
|
||||
状态: {state} | 数量: {count} | 限制: {limit}
|
||||
|
||||
| # | 标题 | 优先级 | 标签 | 状态 | 提出人 |
|
||||
|---|------|--------|------|------|--------|
|
||||
| 35 | 小红书笔记状态查询 | P:紧急 | P:紧急, 需求 | open | zhangsan |
|
||||
```
|
||||
|
||||
字段规则：
|
||||
|
||||
- `优先级`：从 labels 中提取首个匹配 `^P[:：]` 的 label，没有则填 `-`
|
||||
- `标签`：保留全部 label 原文，用 `, ` 连接；没有则填 `-`
|
||||
- `提出人`：优先显示 `user.full_name`，没有则显示 `user.login`
|
||||
- `状态`：直接显示 `open` 或 `closed`
|
||||
|
||||
如果过滤后没有任何 issue，明确输出“无符合条件的 issue”。
|
||||
|
||||
### 4.2 详情模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
## #{number} {title}
|
||||
|
||||
- 仓库: {repo_path}
|
||||
- 状态: {state}
|
||||
- 标签: {labels}
|
||||
- 提出人: {author}
|
||||
- 创建时间: {created_at}
|
||||
- 更新时间: {updated_at}
|
||||
|
||||
### 正文
|
||||
|
||||
{body 或 “无正文”}
|
||||
|
||||
### 评论
|
||||
|
||||
- {author} | {created_at} | {1-2 句摘要}
|
||||
```
|
||||
|
||||
规则：
|
||||
|
||||
- 正文为空时写“无正文”
|
||||
- 评论按时间顺序输出
|
||||
- 每条评论只保留 1-2 句摘要；不要整段照抄超长评论
|
||||
- 没有评论时明确写“无评论”
|
||||
|
||||
## 5. 行为边界
|
||||
|
||||
- 默认只做列表和单条详情，不主动做主题归纳、epic 合并、优先级建议
|
||||
- 用户后续如果要求摘要、优先级排序、相似 issue 合并，再基于已拉取的数据继续分析
|
||||
- 不要求 `GITEA_BASE_URL`
|
||||
|
||||
## 6. 用法示例
|
||||
|
||||
```bash
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge --state=all --limit=20
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge 17
|
||||
```
|
||||
@ -28,13 +28,14 @@
|
||||
- `doc`: 渐进式文档生成器。首次只写精炼梗概（≤300字），后续通过迭代不断完善。 (file: `./.codex/skills/doc/SKILL.md`)
|
||||
- `update`: 收集用户反馈并更新最近使用的 skill。别名：`up`。 (file: `./.codex/skills/up/SKILL.md`)
|
||||
- `deploy`: Drone CI + 服务器 CD 全流程引导：从基础设施检查到生成配置文件到验证部署，交互式完成。 (file: `./.codex/skills/deploy/SKILL.md`)
|
||||
- `issue`: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。 (file: `./.codex/skills/issue/SKILL.md`)
|
||||
- `changelog`: 一键发版：生成更新日志 → commit → 打 tag，全流程自动化。 (file: `./.codex/skills/changelog/SKILL.md`)
|
||||
|
||||
### How to use skills
|
||||
|
||||
- Discovery: 以上列表就是当前项目注册给 Codex 的 skills。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `$skill-name` 或自然语言；skill 文档里出现的 `/rr`、`/go` 等 slash command 只是 Claude Code 的兼容写法。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `/rr`、`$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `/skill-name`；兼容历史 `$skill-name` 写法，也支持自然语言触发。
|
||||
- Missing/blocked: 如果某个 skill 文件不存在或无法读取，简短说明并回退到普通实现方式。
|
||||
- Context hygiene: 只按需打开 `SKILL.md`，不要一次性加载整个 skill 仓库。
|
||||
|
||||
|
||||
@ -7,7 +7,7 @@ description: 渐进式文档生成器。首次只写精炼梗概（≤300字）
|
||||
|
||||
> **核心理念**：文档是缝缝补补长出来的，不是一步到位写出来的。首次只写最重要的梗概，后续通过讨论和迭代逐步完善。
|
||||
|
||||
当用户调用 `doc` skill、`$doc`，或自然语言要求“用 doc 写文档”时，执行以下步骤：
|
||||
当用户调用 `doc` skill、`/doc`、`$doc`，或自然语言要求“用 doc 写文档”时，执行以下步骤：
|
||||
|
||||
## 1. 理解需求
|
||||
|
||||
@ -78,14 +78,14 @@ author: {作者署名}
|
||||
文档: {标题} | 版本: v1.0 | 路径: {path}
|
||||
字数: ~{N}字（首版梗概）
|
||||
|
||||
后续可以通过 $doc 继续补充完善。
|
||||
后续可以通过 /doc 继续补充完善。
|
||||
主人，用不用我沉淀 or git 提交？
|
||||
```
|
||||
|
||||
## 工作流总览
|
||||
|
||||
```text
|
||||
$doc <指令>
|
||||
/doc <指令>
|
||||
│
|
||||
├── 1. 理解需求（简短确认主题、路径、署名）
|
||||
├── 2. 快速调研（聚焦核心，不求全面）
|
||||
|
||||
161
.codex/skills/issue/SKILL.md
Normal file
161
.codex/skills/issue/SKILL.md
Normal file
@ -0,0 +1,161 @@
|
||||
---
|
||||
name: issue
|
||||
description: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。
|
||||
---
|
||||
|
||||
# Issue - 通用 Gitea Issue 查看
|
||||
|
||||
> **定位**：输入完整 Gitea 仓库 URL，快速查看 issue 列表或单条详情。默认只输出事实结果，不主动扩展成 roadmap、主题归纳或优先级分析。
|
||||
|
||||
当用户调用 `/issue <repo-url>`、`/issue <repo-url> --state=open|closed|all --limit=<N>`、`/issue <repo-url> <issue-number>`、`$issue <repo-url>`、`$issue <repo-url> --state=open|closed|all --limit=<N>`、`$issue <repo-url> <issue-number>`，或自然语言要求“用 issue skill 查看某个 Gitea 仓库的问题”时，执行以下步骤。
|
||||
|
||||
## 1. 解析输入
|
||||
|
||||
- `repo-url` 必须是完整仓库地址，例如 `https://git.example.com/owner/repo`
|
||||
- 允许尾部带 `/` 或 `.git`，先规范化后再解析
|
||||
- 第二个位置参数如果是纯数字，视为 `issue-number`，进入详情模式
|
||||
- `--state` 仅支持 `open`、`closed`、`all`，默认 `open`
|
||||
- `--limit` 默认 `50`
|
||||
- 不支持只传 issue 编号；如果缺少仓库 URL，先提示正确用法再停止
|
||||
|
||||
规范化后，从 `repo-url` 提取：
|
||||
|
||||
- `origin`：例如 `https://git.example.com`
|
||||
- `owner`
|
||||
- `repo`
|
||||
- `repo_path`：例如 `owner/repo`
|
||||
|
||||
如果 URL 不是标准仓库地址，明确提示“仓库 URL 格式无效，需为 `https://host/owner/repo`”。
|
||||
|
||||
## 2. 检查环境变量
|
||||
|
||||
先读取环境变量 `GITEA_TOKEN`。
|
||||
|
||||
如果缺失，输出：
|
||||
|
||||
```bash
|
||||
❌ 缺少 GITEA_TOKEN
|
||||
|
||||
请先在当前 shell 或 .env 中配置：
|
||||
export GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
|
||||
然后停止，不继续请求 API。
|
||||
|
||||
## 3. 调用 Gitea API
|
||||
|
||||
不要调用仓库元信息接口，避免依赖 `read:repository` scope。仓库标题直接使用 `repo_path`。
|
||||
|
||||
### 3.1 列表模式
|
||||
|
||||
请求：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issues.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues?state=${state}&limit=${limit}"
|
||||
```
|
||||
|
||||
### 3.2 详情模式
|
||||
|
||||
先请求 issue 详情：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_detail.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}"
|
||||
```
|
||||
|
||||
再请求评论：
|
||||
|
||||
```bash
|
||||
curl -sS -o /tmp/gitea_issue_comments.json -w "%{http_code}" \
|
||||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||||
"${origin}/api/v1/repos/${owner}/${repo}/issues/${issue_number}/comments"
|
||||
```
|
||||
|
||||
### 3.3 错误处理
|
||||
|
||||
根据 HTTP 状态码给出简短、直接的提示：
|
||||
|
||||
- `401`：`GITEA_TOKEN` 无效或未生效
|
||||
- `403`：token scope 不足，或当前用户无权访问该仓库/issue
|
||||
- `404`：仓库不存在，或该 issue 编号不存在
|
||||
- 其他非 `2xx`：输出状态码和响应中的 `message`
|
||||
|
||||
如果列表接口返回项里存在 `pull_request` 且非空，排除这些项，只保留 issue。
|
||||
|
||||
## 4. 格式化输出
|
||||
|
||||
优先使用 `jq` 解析 JSON；如果环境没有 `jq`，再退回模型手工整理，但输出结构保持一致。
|
||||
|
||||
### 4.1 列表模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
📋 {repo_path} Issues
|
||||
|
||||
状态: {state} | 数量: {count} | 限制: {limit}
|
||||
|
||||
| # | 标题 | 优先级 | 标签 | 状态 | 提出人 |
|
||||
|---|------|--------|------|------|--------|
|
||||
| 35 | 小红书笔记状态查询 | P:紧急 | P:紧急, 需求 | open | zhangsan |
|
||||
```
|
||||
|
||||
字段规则：
|
||||
|
||||
- `优先级`：从 labels 中提取首个匹配 `^P[:：]` 的 label，没有则填 `-`
|
||||
- `标签`：保留全部 label 原文，用 `, ` 连接；没有则填 `-`
|
||||
- `提出人`：优先显示 `user.full_name`，没有则显示 `user.login`
|
||||
- `状态`：直接显示 `open` 或 `closed`
|
||||
|
||||
如果过滤后没有任何 issue，明确输出“无符合条件的 issue”。
|
||||
|
||||
### 4.2 详情模式
|
||||
|
||||
输出结构固定为：
|
||||
|
||||
```markdown
|
||||
## #{number} {title}
|
||||
|
||||
- 仓库: {repo_path}
|
||||
- 状态: {state}
|
||||
- 标签: {labels}
|
||||
- 提出人: {author}
|
||||
- 创建时间: {created_at}
|
||||
- 更新时间: {updated_at}
|
||||
|
||||
### 正文
|
||||
|
||||
{body 或 “无正文”}
|
||||
|
||||
### 评论
|
||||
|
||||
- {author} | {created_at} | {1-2 句摘要}
|
||||
```
|
||||
|
||||
规则：
|
||||
|
||||
- 正文为空时写“无正文”
|
||||
- 评论按时间顺序输出
|
||||
- 每条评论只保留 1-2 句摘要；不要整段照抄超长评论
|
||||
- 没有评论时明确写“无评论”
|
||||
|
||||
## 5. 行为边界
|
||||
|
||||
- 默认只做列表和单条详情，不主动做主题归纳、epic 合并、优先级建议
|
||||
- 用户后续如果要求摘要、优先级排序、相似 issue 合并，再基于已拉取的数据继续分析
|
||||
- 不要求 `GITEA_BASE_URL`
|
||||
|
||||
## 6. 用法示例
|
||||
|
||||
```bash
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge --state=all --limit=20
|
||||
/issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge 17
|
||||
|
||||
$issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge
|
||||
$issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge --state=all --limit=20
|
||||
$issue https://git.internal.intelligrow.cn/intelligrow/feishu_gitea_bridge 17
|
||||
```
|
||||
6
.gitignore
vendored
6
.gitignore
vendored
@ -6,7 +6,11 @@ write-skills/
|
||||
.codex/*
|
||||
!.codex/skills/
|
||||
!.codex/skills/**
|
||||
.agents/
|
||||
.agents/*
|
||||
!.agents/skills/
|
||||
.agents/skills/*
|
||||
!.agents/skills/issue/
|
||||
!.agents/skills/issue/SKILL.md
|
||||
|
||||
# macOS
|
||||
.DS_Store
|
||||
|
||||
@ -24,13 +24,14 @@
|
||||
- `doc`: 渐进式文档生成器。首次只写精炼梗概（≤300字），后续通过迭代不断完善。 (file: `./.codex/skills/doc/SKILL.md`)
|
||||
- `update`: 收集用户反馈并更新最近使用的 skill。别名：`up`。 (file: `./.codex/skills/up/SKILL.md`)
|
||||
- `deploy`: Drone CI + 服务器 CD 全流程引导：从基础设施检查到生成配置文件到验证部署，交互式完成。 (file: `./.codex/skills/deploy/SKILL.md`)
|
||||
- `issue`: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。 (file: `./.codex/skills/issue/SKILL.md`)
|
||||
- `changelog`: 一键发版：生成更新日志 → commit → 打 tag，全流程自动化。 (file: `./.codex/skills/changelog/SKILL.md`)
|
||||
|
||||
### How to use skills
|
||||
|
||||
- Discovery: 以上列表就是当前仓库提供给 Codex 的 skills。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `$skill-name` 或自然语言；skill 文档里出现的 `/rr`、`/go` 等 slash command 只是 Claude Code 的兼容写法。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `/rr`、`$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `/skill-name`；兼容历史 `$skill-name` 写法，也支持自然语言触发。
|
||||
- Missing/blocked: 如果某个 skill 文件不存在或无法读取，简短说明并回退到普通实现方式。
|
||||
- Context hygiene: 只按需打开 `SKILL.md`，不要一次性加载整个 skill 仓库。
|
||||
|
||||
|
||||
@ -28,13 +28,14 @@
|
||||
- `doc`: 渐进式文档生成器。首次只写精炼梗概（≤300字），后续通过迭代不断完善。 (file: `./.codex/skills/doc/SKILL.md`)
|
||||
- `update`: 收集用户反馈并更新最近使用的 skill。别名：`up`。 (file: `./.codex/skills/up/SKILL.md`)
|
||||
- `deploy`: Drone CI + 服务器 CD 全流程引导：从基础设施检查到生成配置文件到验证部署，交互式完成。 (file: `./.codex/skills/deploy/SKILL.md`)
|
||||
- `issue`: 获取任意 Gitea 仓库的 issue 列表和单条详情，支持状态筛选、完整仓库 URL 输入和格式化输出。 (file: `./.codex/skills/issue/SKILL.md`)
|
||||
- `changelog`: 一键发版：生成更新日志 → commit → 打 tag，全流程自动化。 (file: `./.codex/skills/changelog/SKILL.md`)
|
||||
|
||||
### How to use skills
|
||||
|
||||
- Discovery: 以上列表就是当前项目注册给 Codex 的 skills。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `$skill-name` 或自然语言；skill 文档里出现的 `/rr`、`/go` 等 slash command 只是 Claude Code 的兼容写法。
|
||||
- Trigger rules: 如果用户显式提到 skill 名称（例如 `/rr`、`$rr`、`rr skill`、`用 rr 评审`），或任务明显匹配 skill 描述，优先使用对应 skill。
|
||||
- Codex usage: 在 Codex 中优先使用 `/skill-name`；兼容历史 `$skill-name` 写法，也支持自然语言触发。
|
||||
- Missing/blocked: 如果某个 skill 文件不存在或无法读取，简短说明并回退到普通实现方式。
|
||||
- Context hygiene: 只按需打开 `SKILL.md`，不要一次性加载整个 skill 仓库。
|
||||
|
||||
|
||||
90
README.md
90
README.md
@ -7,7 +7,7 @@
|
||||
| 平台 | 安装目录 | 触发方式 |
|
||||
|------|----------|----------|
|
||||
| Claude Code | `.claude/skills/` | `/rr`、`/wp`、`/go` 这类 slash commands |
|
||||
| Codex | `.codex/skills/` | `$rr`、`$wp`，或直接自然语言说明“用 rr skill 评审需求文档” |
|
||||
| Codex | `.codex/skills/` | `/rr`、`/wp` 这类 slash commands，或直接自然语言说明“用 rr skill 评审需求文档” |
|
||||
|
||||
> Codex 额外需要项目根目录存在 `AGENTS.md`。本仓库已提供 `AGENTS.md.template`，安装脚本在 Codex 模式下会自动生成。
|
||||
|
||||
@ -25,29 +25,32 @@ RequirementsDoc ──▶ PRD ──▶ FeatureSummary ──▶ DevelopmentPlan
|
||||
|
||||
| 类型 | Skill | Claude Code | Codex | 描述 |
|
||||
|------|-------|-------------|-------|------|
|
||||
| **Review** | `rr` | `/rr` | `$rr` | 评审 RequirementsDoc.md |
|
||||
| | `rp` | `/rp` | `$rp` | 评审 PRD.md |
|
||||
| | `rf` | `/rf` | `$rf` | 评审 FeatureSummary.md |
|
||||
| | `rd` | `/rd` | `$rd` | 评审 DevelopmentPlan.md |
|
||||
| | `ru` | `/ru` | `$ru` | 评审 UIDesign.md |
|
||||
| | `rt` | `/rt` | `$rt` | 评审 tasks.md |
|
||||
| **Write** | `wp` | `/wp` | `$wp` | 从 RequirementsDoc 生成 PRD |
|
||||
| | `wf` | `/wf` | `$wf` | 从 PRD 生成 FeatureSummary |
|
||||
| | `wd` | `/wd` | `$wd` | 从 FeatureSummary 生成 DevelopmentPlan |
|
||||
| | `wu` | `/wu` | `$wu` | 从 DevelopmentPlan 生成 UIDesign |
|
||||
| | `wt` | `/wt` | `$wt` | 从 DevelopmentPlan 生成 tasks |
|
||||
| **Modify** | `mr` | `/mr` | `$mr` | 增量修改 RequirementsDoc |
|
||||
| | `mp` | `/mp` | `$mp` | 增量修改 PRD（自动读取评审报告） |
|
||||
| | `mf` | `/mf` | `$mf` | 增量修改 FeatureSummary |
|
||||
| | `md` | `/md` | `$md` | 增量修改 DevelopmentPlan |
|
||||
| | `mu` | `/mu` | `$mu` | 增量修改 UIDesign |
|
||||
| | `mt` | `/mt` | `$mt` | 增量修改 tasks |
|
||||
| **执行** | `go` | `/go` | `$go` | 🚀 发射按钮，激进模式一口气完成开发 |
|
||||
| **辅助** | `iter` | `/iter` | `$iter` | 迭代变更入口（Bug/功能/重构） |
|
||||
| | `doc` | `/doc` | `$doc` | 渐进式文档生成器，先写梗概再迭代完善 |
|
||||
| | `update` | `/up` | `$update` 或 `$up` | Skill 升级优化 |
|
||||
| | `deploy` | `/deploy` | `$deploy` | Drone CI/CD 全流程部署引导 |
|
||||
| | `changelog` | `/changelog` | `$changelog` | 一键发版（日志 + commit + tag） |
|
||||
| **Review** | `rr` | `/rr` | `/rr` | 评审 RequirementsDoc.md |
|
||||
| | `rp` | `/rp` | `/rp` | 评审 PRD.md |
|
||||
| | `rf` | `/rf` | `/rf` | 评审 FeatureSummary.md |
|
||||
| | `rd` | `/rd` | `/rd` | 评审 DevelopmentPlan.md |
|
||||
| | `ru` | `/ru` | `/ru` | 评审 UIDesign.md |
|
||||
| | `rt` | `/rt` | `/rt` | 评审 tasks.md |
|
||||
| **Write** | `wp` | `/wp` | `/wp` | 从 RequirementsDoc 生成 PRD |
|
||||
| | `wf` | `/wf` | `/wf` | 从 PRD 生成 FeatureSummary |
|
||||
| | `wd` | `/wd` | `/wd` | 从 FeatureSummary 生成 DevelopmentPlan |
|
||||
| | `wu` | `/wu` | `/wu` | 从 DevelopmentPlan 生成 UIDesign |
|
||||
| | `wt` | `/wt` | `/wt` | 从 DevelopmentPlan 生成 tasks |
|
||||
| **Modify** | `mr` | `/mr` | `/mr` | 增量修改 RequirementsDoc |
|
||||
| | `mp` | `/mp` | `/mp` | 增量修改 PRD（自动读取评审报告） |
|
||||
| | `mf` | `/mf` | `/mf` | 增量修改 FeatureSummary |
|
||||
| | `md` | `/md` | `/md` | 增量修改 DevelopmentPlan |
|
||||
| | `mu` | `/mu` | `/mu` | 增量修改 UIDesign |
|
||||
| | `mt` | `/mt` | `/mt` | 增量修改 tasks |
|
||||
| **执行** | `go` | `/go` | `/go` | 🚀 发射按钮，激进模式一口气完成开发 |
|
||||
| **辅助** | `iter` | `/iter` | `/iter` | 迭代变更入口（Bug/功能/重构） |
|
||||
| | `doc` | `/doc` | `/doc` | 渐进式文档生成器，先写梗概再迭代完善 |
|
||||
| | `update` | `/up` | `/up` | Skill 升级优化 |
|
||||
| | `deploy` | `/deploy` | `/deploy` | Drone CI/CD 全流程部署引导 |
|
||||
| | `issue` | `/issue` | `/issue` | 通用 Gitea issue 查询（列表 + 单条详情） |
|
||||
| | `changelog` | `/changelog` | `/changelog` | 一键发版（日志 + commit + tag） |
|
||||
|
||||
> Codex 兼容历史 `$skill` 写法，但本文档统一以 `/skill` 作为主入口。
|
||||
|
||||
## 安装 & 更新
|
||||
|
||||
@ -113,11 +116,11 @@ Claude Code:
|
||||
Codex:
|
||||
|
||||
```text
|
||||
$wp
|
||||
$wf
|
||||
$wd
|
||||
$wt
|
||||
$go
|
||||
/wp
|
||||
/wf
|
||||
/wd
|
||||
/wt
|
||||
/go
|
||||
```
|
||||
|
||||
### 1->100 阶段：持续迭代
|
||||
@ -132,8 +135,8 @@ Claude Code:
|
||||
Codex:
|
||||
|
||||
```text
|
||||
$iter
|
||||
$go
|
||||
/iter
|
||||
/go
|
||||
```
|
||||
|
||||
也可以直接说自然语言，例如：
|
||||
@ -143,6 +146,31 @@ $go
|
||||
请用 wf skill 根据 PRD 生成 FeatureSummary
|
||||
请用 go skill 按 doc/tasks.md 执行未完成任务
|
||||
请用 doc skill 为认证模块写一份 300 字以内的使用说明
|
||||
请用 issue skill 查看 https://git.example.com/owner/repo 的 open issues
|
||||
```
|
||||
|
||||
### 查询 Gitea Issues
|
||||
|
||||
先配置：
|
||||
|
||||
```bash
|
||||
export GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
|
||||
Claude Code:
|
||||
|
||||
```bash
|
||||
/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
|
||||
```
|
||||
|
||||
Codex:
|
||||
|
||||
```text
|
||||
/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
|
||||
```
|
||||
|
||||
### 工作流总览
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user