atomgit-comment

name	atomgit-comment
description	AtomGit PR/Issue 评论助手 - 获取信息、分析内容、回复评论
version	2.0.0

AtomGit 评论助手

响应 AtomGit PR/Issue 评论，自动分析并回复。

核心功能

1. 获取 PR/Issue 信息

通过 AtomGit API 获取：

• PR 详情（标题、描述、diff）
• Issue 详情（标题、描述、标签）
• 评论上下文

2. 分析内容

根据评论类型智能分析：

• PR 评论 → 代码审查建议
• Issue 评论 → 问题诊断
• @提及 → 回答技术问题

3. 回复评论

通过 AtomGit API 提交回复：

• PR 审查建议
• Issue 解决方案
• 技术解答

配置

环境变量

# AtomGit API Token（必需）
export ATOMGIT_TOKEN="your-private-token"

API 端点

# 基础 URL
ATOMGIT_API="https://api.atomgit.com/api/v5"

# 获取 PR 信息
curl -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  "$ATOMGIT_API/repos/{owner}/{repo}/pulls/{number}"

# 获取 PR diff
curl -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  "$ATOMGIT_API/repos/{owner}/{repo}/pulls/{number}/files"

# 获取 Issue 信息
curl -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  "$ATOMGIT_API/repos/{owner}/{repo}/issues/{number}"

# 提交 PR 评论
curl -X POST \
  -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  -H "Content-Type: application/json" \
  "$ATOMGIT_API/repos/{owner}/{repo}/pulls/{number}/comments" \
  -d '{"body":"评论内容"}'

# 提交 Issue 评论
curl -X POST \
  -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  -H "Content-Type: application/json" \
  "$ATOMGIT_API/repos/{owner}/{repo}/issues/{number}/comments" \
  -d '{"body":"评论内容"}'

工作流程

1. 接收评论事件

从 webhook 或其他触发器接收评论事件

2. 获取上下文信息

根据评论类型获取：

• PR 评论 → 获取 PR 详情 + diff
• Issue 评论 → 获取 Issue 详情 + 标签

3. 分析评论内容

理解评论意图：

• 问题咨询 → 提供解答
• 代码审查请求 → 分析 diff 并提供建议
• Bug 报告 → 诊断问题
• 功能请求 → 提供实现建议

4. 生成回复

根据分析结果生成：

• 清晰、准确的中文回复
• 代码示例（如需要）
• 相关文档链接（如有）

5. 提交回复

通过 AtomGit API 提交评论

使用示例

示例 1： PR 代码审查

触发：有人在 PR 中评论 "@bot 请帮我审查这段代码"

流程：

1. 获取 PR #123 的详情
2. 获取 PR #123 的 diff
3. 分析代码变更
4. 生成审查建议
5. 提交评论到 PR #123

回复示例：

## 代码审查建议

### 1. 内存泄漏风险 (main.c:45)
```c
char *buffer = malloc(1024);
// 缺少 free(buffer)

建议：添加 free(buffer) 释放内存

2. 更好的错误处理

建议添加更详细的错误日志...

---

### 示例 2： Issue 问题诊断

**触发**：有人在 Issue 中评论 "@bot 这个 bug 怎么复现?"

**流程**：
1. 获取 Issue #456 的详情
2. 分析 Issue 标签和描述
3. 诊断问题原因
4. 提供复现步骤
5. 提交评论到 Issue #456

**回复示例**：

问题诊断

根据 Issue 描述，这个问题可能是由于：

复现步骤

1. 在配置文件中设置 timeout=0
2. 启动服务 ./service start
3. 等待 10 秒后观察日志

建议修复

检查 config.c:123 的超时配置...

---

## 错误处理

### API 限流
如果遇到 429 错误（限流），等待 60 秒后重试

### 权限错误
如果遇到 403 错误（权限不足），记录日志并跳过

### 网络错误
如果遇到网络错误，重试 3 次（间隔 5 秒）

## 最佳实践

1. **明确触发条件**
   - 只响应明确的请求（如 @提及）
   - 不主动发起评论

2. **保持简洁**
   - 回复要简洁、准确
   - 避免过长的大段文字

3. **提供价值**
   - 提供具体、可操作的建议
   - 包含代码示例或文档链接

4. **尊重上下文**
   - 理解 PR/Issue 的完整上下文
   - 考虑之前的评论历史

## 参考资源

- [AtomGit API 文档](https://docs.atomgit.com/docs/apis/)
- [openEuler PR 审查技能](~/.openclaw/skills/openeuler-pr-review/SKILL.md)