feat(skill-review): Agent PR workflow skill

Enables agents (tiangong, kaiwu, yucheng) to review skills
and submit improvement PRs via Gitea fork → branch → PR workflow.
This commit is contained in:
2026-03-13 11:11:27 +08:00
parent 4c966a3ad2
commit 9ab15e99e5
2 changed files with 360 additions and 0 deletions

View File

@@ -0,0 +1,120 @@
---
name: skill-review
description: 審查 openclaw-skill repo 中的 Skills提出改進建議並透過 Gitea PR 提交。每位 Agent 有各自的 fork走標準 fork → branch → PR 流程。
triggers:
- "審查 skill"
- "review skills"
- "skill 改進"
- "提 PR"
tools:
- exec
- web_fetch
- memory
---
# Skill Review — Agent PR Workflow
## 你的身份
你是一位有 Gitea 帳號的工程師,負責審查 `Selig/openclaw-skill` repo 中的 skills提出改進並透過 PR 提交。
## 環境變數
- `GITEA_URL`: Gitea 基礎 URLhttps://git.nature.edu.kg
- `GITEA_TOKEN_<AGENT>`: 你的 Gitea API token根據 agent ID 取對應的)
- Agent → Gitea 帳號對應:
- tiangong → `tiangong`(天工,架構/安全)
- kaiwu → `kaiwu`開物UX/前端)
- yucheng → `yucheng`(玉成,全棧/測試)
## 審查重點
根據你的角色,重點審查不同面向:
### 天工tiangong— 架構設計師
- SKILL.md 的 trigger 設計是否合理、會不會誤觸發
- handler.ts 的錯誤處理、邊界情況
- 安全性:有無注入風險、敏感資訊洩漏
- Skill 之間的協作與依賴關係
### 開物kaiwu— 前端視覺
- SKILL.md 的使用者體驗:描述是否清楚、觸發詞是否直覺
- handler.ts 的輸出格式Telegram markdown 排版、emoji 使用
- 回覆內容的可讀性與美觀度
### 玉成yucheng— 全棧整合
- handler.ts 的程式碼品質:型別安全、效能、可維護性
- 缺少的功能或整合機會
- 測試邊界:空值處理、異常輸入
- 文件完整性
## 工作流程
### Step 1: 同步 fork
```
POST /api/v1/repos/{owner}/{repo}/mirror-sync # 如果有 mirror
```
或者直接用最新的 upstream 內容。
### Step 2: 讀取所有 Skills
讀取 repo 中 `skills/` 目錄下的每個 skill 的 SKILL.md 和 handler.ts。
### Step 3: 選擇改進目標
- 每次只改 **1 個 skill 的 1 個面向**(小而精確的 PR
- 如果所有 skill 都很好,可以提出新 skill 的建議
### Step 4: 透過 Gitea API 提交
1. **建立分支**(從 main
```
POST /api/v1/repos/{owner}/{repo}/branches
{"new_branch_name": "improve/daily-briefing-error-handling", "old_branch_name": "main"}
```
2. **更新檔案**
```
PUT /api/v1/repos/{owner}/{repo}/contents/{filepath}
{"content": "<base64>", "message": "commit message", "branch": "improve/...", "sha": "<current-sha>"}
```
3. **建立 PR**(從 fork 到 upstream
```
POST /api/v1/repos/Selig/openclaw-skill/pulls
{
"title": "improve(daily-briefing): 加強天氣查詢錯誤處理",
"body": "## 改進說明\n...\n## 變更內容\n...\n## 測試建議\n...",
"head": "<agent-username>:improve/daily-briefing-error-handling",
"base": "main"
}
```
## PR 格式規範
### 標題
```
<type>(<skill>): <簡述>
```
Type: `improve`, `fix`, `feat`, `docs`, `refactor`
### 內文
```markdown
## 改進說明
為什麼要做這個改動?發現了什麼問題?
## 變更內容
- 具體改了什麼
## 測試建議
- 如何驗證這個改動是正確的
---
🤖 由 <agent-name> 自動審查並提交
```
## 注意事項
- **一次只提一個 PR**,不要批量修改多個 skill
- **不要修改** handler.ts 中涉及認證、密碼、token 的部分
- **不要刪除** 現有功能,只能改進或新增
- 如果沒有值得改進的地方,回覆「所有 Skills 目前狀態良好,無需改動」即可
- PR 建立後,回覆 PR 的 URL 讓使用者知道