@newstarzj/cann-review 3.2.0

package/INSTALL.md

@@ -0,0 +1,168 @@
+# CANN Review Skill 安装指南
+
+## 安装步骤
+
+### 1. 安装 Skill
+
+```bash
+# 从本地安装
+cd /Users/zj/.openclaw/workspace/skills/cann-review
+claw install .
+
+# 或从 ClawHub 安装（如果已发布）
+claw install cann-review
+```
+
+### 2. 配置自动审查（可选）
+
+如果你想启用定时自动审查功能，需要配置 cron 任务。
+
+#### 方法一：使用 OpenClaw Cron 工具
+
+1. **查看当前 cron 状态**
+```bash
+claw cron status
+```
+
+2. **添加定时任务**
+
+编辑 cron.yaml 文件，根据需要调整调度时间：
+
+```yaml
+auto_review:
+  schedule: "0 */2 * * *"  # 每 2 小时执行一次
+  enabled: true
+```
+
+3. **应用 cron 配置**
+
+使用 OpenClaw 的 cron 工具添加任务：
+
+```bash
+# 添加自动审查任务
+claw cron add \
+  --name "cann-auto-review" \
+  --schedule "0 */2 * * *" \
+  --skill "cann-review" \
+  --params '{"auto_mode": true, "max_reviews": 5}'
+```
+
+或者手动配置（需要管理员权限）：
+
+```bash
+# 编辑 crontab
+crontab -e
+
+# 添加以下行（每 2 小时执行一次）
+0 */2 * * * cd /Users/zj/.openclaw && claw run cann-review --auto-mode --max-reviews 5
+```
+
+#### 方法二：使用 OpenClaw Gateway Cron
+
+如果你使用 OpenClaw Gateway，可以通过 API 添加 cron 任务：
+
+```bash
+curl -X POST http://localhost:3000/api/cron/add \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "cann-auto-review",
+    "schedule": {"kind": "cron", "expr": "0 */2 * * *"},
+    "payload": {
+      "kind": "agentTurn",
+      "message": "使用 cann-review skill 审查未读 MR",
+      "params": {
+        "auto_mode": true,
+        "max_reviews": 5
+      }
+    },
+    "sessionTarget": "isolated",
+    "enabled": true
+  }'
+```
+
+### 3. 验证安装
+
+```bash
+# 测试手动审查
+claw run cann-review --pr-url "https://gitcode.com/cann/runtime/pull/472"
+
+# 测试自动审查（干运行）
+claw run cann-review --auto-mode --max-reviews 1 --dry-run
+```
+
+## 配置选项
+
+### Cron 调度表达式
+
+常用调度示例：
+
+| 表达式 | 说明 |
+|--------|------|
+| `0 */2 * * *` | 每 2 小时 |
+| `0 9,15 * * *` | 每天 9:00 和 15:00 |
+| `0 9 * * 1-5` | 周一到周五 9:00 |
+| `0 10 * * 0,6` | 周末 10:00 |
+| `*/30 * * * *` | 每 30 分钟 |
+
+### 审查参数
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `focus_areas` | all | 审查重点（memory/security/readability/all） |
+| `severity_threshold` | medium | LGTM 阈值（low/medium/high） |
+| `max_reviews` | 5 | 单次最大审查数量 |
+| `send_summary` | true | 是否发送汇总通知 |
+
+## 故障排查
+
+### 浏览器无法启动
+
+确保 OpenClaw 内置浏览器可用：
+
+```bash
+claw browser status
+claw browser start
+```
+
+### Cron 任务未执行
+
+检查 cron 日志：
+
+```bash
+# 查看 OpenClaw cron 日志
+tail -f /Users/zj/.openclaw/logs/cron.log
+
+# 或查看系统 cron 日志
+grep CRON /var/log/syslog
+```
+
+### 无法访问 GitCode
+
+确保已登录 GitCode：
+
+```bash
+# 使用浏览器登录
+claw browser open "https://gitcode.com"
+```
+
+## 卸载
+
+```bash
+# 移除 skill
+claw uninstall cann-review
+
+# 移除 cron 任务
+claw cron remove --name "cann-auto-review"
+```
+
+## 更新
+
+```bash
+# 更新 skill
+claw update cann-review
+
+# 或从源码更新
+cd /Users/zj/.openclaw/workspace/skills/cann-review
+git pull
+claw install .
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# CANN 代码审查技能
+
+自动审查 GitCode 上的 CANN 项目 PR，检查内存泄漏、安全漏洞和代码可读性。
+
+## ✨ 特性
+
+- 🔍 **全面代码审查**：内存泄漏、安全漏洞、代码可读性
+- 🚀 **基于 API**：使用 GitCode API，无需浏览器自动化，稳定可靠
+- 💬 **自动评论**：自动发布结构化审查报告
+- ✅ **LGTM 支持**：低风险 PR 自动发布 `/lgtm`
+- 🤖 **自动模式**：支持定时任务，自动审查新 PR
+
+## 📦 安装
+
+### 1. 安装技能
+
+```bash
+clawhub install cann-review
+```
+
+### 2. 配置 GitCode API Token
+
+**首次使用必须配置 Token：**
+
+```bash
+cd ~/.openclaw/workspace/skills/cann-review
+./gitcode-api.sh setup
+```
+
+按提示输入你的 GitCode API Token。
+
+<details>
+<summary>📖 如何获取 Token？</summary>
+
+1. 访问 https://gitcode.com/setting/token-classic
+2. 点击"生成新令牌"
+3. 选择权限：`api`, `write_repository`
+4. 复制生成的 Token
+
+</details>
+
+<details>
+<summary>🔧 其他配置方法</summary>
+
+**方法 2：手动配置**
+
+```bash
+cp config/gitcode.conf.example config/gitcode.conf
+nano config/gitcode.conf
+# 设置 GITCODE_API_TOKEN=your_token_here
+```
+
+**方法 3：环境变量**
+
+```bash
+export GITCODE_API_TOKEN=your_token_here
+```
+
+</details>
+
+## 🚀 使用方法
+
+### 手动审查单个 PR
+
+直接提供 PR 链接：
+
+```
+审查这个 PR: https://gitcode.com/cann/runtime/merge_requests/628
+```
+
+或使用命令：
+
+```
+cann review PR#628
+```
+
+### 自动审查模式
+
+配置定时任务，自动审查新 PR：
+
+```yaml
+# 在 OpenClaw 中配置 cron 任务
+schedule: "0 */2 * * *"  # 每 2 小时执行一次
+task: "cann-review auto"
+```
+
+## 🔧 API 辅助脚本
+
+提供了 `gitcode-api.sh` 辅助脚本：
+
+```bash
+# 获取 PR 信息
+./gitcode-api.sh get-pr cann runtime 628
+
+# 获取 PR 文件变更
+./gitcode-api.sh get-files cann runtime 628
+
+# 发布评论
+./gitcode-api.sh post-comment cann runtime 628 "LGTM!"
+
+# 列出开放的 PR
+./gitcode-api.sh list-prs cann runtime
+```
+
+## 📊 审查报告格式
+
+审查报告包括：
+
+- **审查结论**：严重性评估和建议
+- **修改概述**：变更文件和核心变更
+- **代码质量检查**：
+  - 内存安全
+  - 安全性
+  - 可读性
+  - 逻辑正确性
+- **改进建议**：具体优化建议
+- **代码亮点**：做得好的地方
+
+## ⚙️ 配置
+
+### 配置文件
+
+配置文件位于：`~/.openclaw/workspace/skills/cann-review/config/gitcode.conf`
+
+```bash
+# 查看当前配置
+cat ~/.openclaw/workspace/skills/cann-review/config/gitcode.conf
+```
+
+### 环境变量（可选）
+
+也可以通过环境变量配置：
+
+```bash
+export GITCODE_API_TOKEN=your_token_here
+export GITCODE_API_BASE=https://api.gitcode.com/api/v5  # 可选
+```
+
+### 重新配置
+
+```bash
+cd ~/.openclaw/workspace/skills/cann-review
+./gitcode-api.sh setup
+```
+
+### 审查阈值
+
+可在技能中调整发布 LGTM 的阈值：
+
+- `low`: 仅低风险发布 LGTM
+- `medium`: 低和中低风险发布 LGTM（默认）
+- `high`: 低、中、高风险都发布 LGTM（不推荐）
+
+## 🐛 故障排查
+
+### API 返回 401
+
+检查 Token 是否有效：
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN" https://api.gitcode.com/api/v5/user
+```
+
+### 无法评论已合并的 PR
+
+这是正常行为，已合并的 PR 可能禁止新评论。
+
+### API 频率限制
+
+GitCode API 限制：50次/分钟，4000次/小时。如需大量审查，添加适当延迟。
+
+## 📝 版本历史
+
+### v3.0.0 (2026-03-04)
+- 🎉 **重大更新**：全面改用 GitCode API
+- 🚀 提高稳定性和可靠性
+- 📝 简化操作流程
+
+详细版本历史见 SKILL.md
+
+## 📄 许可证
+
+内部使用
+
+## 🤝 贡献
+
+如有问题或建议，请联系维护团队。