---
name: gitea-start-scheduler
description: 启动定时任务（Issue 处理和 PR 审核）
---

创建两个定时任务，自动处理 Issues 和审核 PRs。

## 工作流程

### 第一步：读取配置

从环境变量读取配置：
- `GITEA_URL`: Gitea 实例地址
- `GITEA_TOKEN`: API 访问令牌
- `GITEA_OWNER`: 仓库所有者
- `GITEA_REPO`: 仓库名称（如果没有，则使用当前目录名）
- `CODE_AGENT_INTERVAL`: Code Agent 间隔（默认 5 分钟）
- `PR_AGENT_INTERVAL`: PR Agent 间隔（默认 10 分钟）

### 第二步：创建 Code Agent 定时任务

使用 CronCreate 创建定时任务，定期扫描和处理未完成的 Issues。

**定时任务逻辑**：
```
每 N 分钟执行一次：
1. 依据 .claude/commands/gitea/API-QUICK-REFERENCE.md 文档中的 Issue 操作指南获取所有打开的 Issues
2. 过滤出未处理的（没有 PR 关联）
3. 按优先级排序
4. 依据 API-QUICK-REFERENCE.md 文档检查依赖是否满足
5. 选择优先级最高的未阻塞 Issue
6. 检查是否有正在运行的子Agent
7. 如果没有，使用 Agent 工具启动子Agent处理该 Issue
8. 子Agent完成后自动退出
9. 等待下次定时任务
```

**使用 Agent 工具启动子Agent**：
```javascript
Agent({
  subagent_type: "general-purpose",
  description: `处理 Issue #{number}`,
  prompt: `你是一个 Code Agent，负责处理 Gitea Issue #{number}。

环境变量（已配置）：
- GITEA_URL: ${process.env.GITEA_URL}
- GITEA_TOKEN: ${process.env.GITEA_TOKEN}
- GITEA_OWNER: ${process.env.GITEA_OWNER}
- GITEA_REPO: ${process.env.GITEA_REPO}

工作流程：
1. 依据 .claude/commands/gitea/API-QUICK-REFERENCE.md 文档中的 Issue 操作指南获取 Issue #{number} 详情
2. 解析 Issue 描述，提取需求
3. 依据 API-QUICK-REFERENCE.md 文档检查依赖 Issue 是否已完成
4. 如果依赖未满足，报告并退出
5. 创建特性分支: feature/issue-{number}
6. 分析需要实现的功能
7. 读取现有代码结构
8. 增量式生成实现代码
   - 只实现 Issue 要求的功能
   - 不重复已有代码
   - 遵循项目代码规范
9. 生成测试代码
   - 单元测试
   - 集成测试（如果需要）
10. 运行测试
    - 如果测试失败，修复代码并重试
11. 提交代码
    git add .
    git commit -m "feat: 实现 Issue #{number}"
    git push origin feature/issue-{number}
12. 依据 API-QUICK-REFERENCE.md 文档中的 Pull Request 操作指南创建 Pull Request
    - 标题: [Issue #{number}] {Issue 标题}
    - 描述: 关联 Issue，说明实现内容
    - 标签: 继承 Issue 的标签
13. 依据 API-QUICK-REFERENCE.md 文档中的 Issue 评论操作指南在 Issue 中添加评论，说明已创建 PR

完成后报告处理结果（成功/失败/跳过）并退出。`,
  run_in_background: false  // 前台运行，完成后继续主流程
})
```

### 第三步：创建 PR Agent 定时任务

使用 CronCreate 创建定时任务，定期审核未审核的 PRs。

**定时任务逻辑**：
```
每 N 分钟执行一次：
1. 依据 .claude/commands/gitea/API-QUICK-REFERENCE.md 文档中的 Pull Request 操作指南获取所有打开的 Pull Requests
2. 过滤出未审核的
3. 对每个 PR 使用 Agent 工具启动子Agent审核
4. 子Agent完成后自动退出
5. 等待下次定时任务
```

**使用 Agent 工具启动子Agent**：
```javascript
Agent({
  subagent_type: "general-purpose",
  description: `审核 PR #{number}`,
  prompt: `你是一个 PR Agent，负责审核 Gitea PR #{number}。

环境变量（已配置）：
- GITEA_URL: ${process.env.GITEA_URL}
- GITEA_TOKEN: ${process.env.GITEA_TOKEN}
- GITEA_OWNER: ${process.env.GITEA_OWNER}
- GITEA_REPO: ${process.env.GITEA_REPO}
- AUTO_MERGE: ${process.env.AUTO_MERGE || false}

工作流程：
1. 依据 .claude/commands/gitea/API-QUICK-REFERENCE.md 文档中的 Pull Request 操作指南获取 PR #{number} 详情
   - 代码变更
   - 关联的 Issue
   - 提交历史

2. 代码质量检查
   - 代码规范（如果有 linter）
   - 代码风格一致性
   - 潜在的 bug

3. 测试检查
   - 检查是否有测试代码
   - 运行测试（如果有测试框架）
   - 验证测试覆盖率

4. 安全检查
   - 检查是否有敏感信息泄露
   - 检查是否有安全漏洞

5. 依据 API-QUICK-REFERENCE.md 文档中的 PR 审核操作指南创建审核评论
   如果发现问题：
   - 列出所有问题
   - 提供修复建议
   - 请求修改（REQUEST_CHANGES）

   如果审核通过：
   - 批准（APPROVE）
   - 根据 AUTO_MERGE 配置决定是否自动合并

6. 如果需要修改且 AUTO_MERGE=true
   - 使用 Agent 工具启动修复子Agent
   - 修复问题
   - 推送修复

完成后报告审核结果（通过/需修改/拒绝）并退出。`,
  run_in_background: false  // 前台运行，完成后继续主流程
})
```

### 第四步：显示任务状态

创建完成后，显示：
- 两个定时任务的 ID
- 下次执行时间
- 如何停止任务（/gitea-stop-scheduler）

## 配置选项

### 环境变量

创建 `.env` 文件（如果不存在）：

```bash
# Gitea 配置
GITEA_URL=http://your-gitea-url
GITEA_TOKEN=your-api-token
GITEA_OWNER=your-username
GITEA_REPO=your-repo-name  # 可选，默认使用当前目录名

# 定时间隔（分钟）
CODE_AGENT_INTERVAL=5      # 默认 5 分钟
PR_AGENT_INTERVAL=10       # 默认 10 分钟

# 审核配置
AUTO_MERGE=false           # 是否自动合并审核通过的 PR
REQUIRE_REVIEW=true        # 是否需要代码审查
TEST_COVERAGE_TARGET=80    # 测试覆盖率目标
```

### 定时间隔建议

根据项目规模调整间隔：

- **小型项目** (< 10 个 Issues):
  - Code Agent: 3-5 分钟
  - PR Agent: 5-10 分钟

- **中型项目** (10-50 个 Issues):
  - Code Agent: 5-10 分钟
  - PR Agent: 10-15 分钟

- **大型项目** (> 50 个 Issues):
  - Code Agent: 10-15 分钟
  - PR Agent: 15-20 分钟

## 示例输出

```
🚀 启动定时任务
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 读取配置
  • 仓库: chen/task-manager-unity
  • Code Agent 间隔: 5 分钟
  • PR Agent 间隔: 10 分钟

✅ 创建 Code Agent 定时任务
  • ID: job-abc123
  • 间隔: */5 * * * *
  • 下次执行: 2 分钟后

✅ 创建 PR Agent 定时任务
  • ID: job-def456
  • 间隔: */10 * * * *
  • 下次执行: 7 分钟后

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⏰ 定时任务已启动！

Agent 将自动：
  • 扫描未处理的 Issues 并实现功能
  • 审核提交的 Pull Requests
  • 运行测试并确保代码质量

💡 提示：
  • 使用 /gitea-status 查看进度
  • 使用 /gitea-stop-scheduler 停止任务
  • 定时任务仅在当前会话有效（最多 3 天）

✨ 准备就绪，Agent 开始工作！
```

## 注意事项

1. **会话限制**: 定时任务仅在当前会话有效，会话结束后需要重新启动
2. **自动过期**: 定时任务最多运行 3 天，之后会自动删除
3. **子Agent模式**: 每次定时触发时启动独立的子Agent，完成后自动退出
4. **并发控制**: 同一时间只运行一个子Agent，避免冲突
5. **依赖检查**: 会自动跳过依赖未满足的 Issues
6. **错误重试**: 如果子Agent执行失败，会在下次定时任务时重试
7. **资源管理**: 子Agent完成后自动释放资源，不影响主进程
8. **手动干预**: 可以随时使用 `/gitea-process-issue` 手动处理特定 Issue

## 工作流示例

```
时间轴：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

T=0 min   启动定时任务
T=2 min   Code Agent 扫描 → 发现 Issue #2
          开始实现 Issue #2...

T=5 min   Code Agent 完成 Issue #2，创建 PR #1
          下次扫描...

T=10 min  PR Agent 审核通过 PR #1
          AUTO_MERGE=false → 等待人工合并

T=15 min  Code Agent 扫描 → 发现 Issue #3
          开始实现 Issue #3...

...以此类推
```

## 下一步

启动定时任务后：
1. 使用 `/gitea-status` 查看实时状态
2. 查看 Issues 和 PRs 的进度
3. 手动审核和合并 PRs（如果 AUTO_MERGE=false）
4. 根据需要调整定时间隔