User Guide

使用指南

接入一个仓库

1. 在 Botler 的「仓库」页面添加 GitLab 项目，确认项目地址、默认分支和 bot 权限正确。
2. 由平台注册 GitLab webhook；也可以使用对账功能补偿漏掉的事件。
3. 在项目中创建 Issue，并分配给配置的逻辑处理人或从 Botler 界面手动执行。

任务生命周期

1. Botler 接收 webhook 或对账发现 Issue，按仓库和标签优先级排队。
2. 执行器同步默认主分支、运行预检、分析需求、编写测试并实现改动。
3. 本地全量测试通过后，执行器直接提交并推送主分支。
4. GitLab CI 成功后，机器人在 Issue 追加开发摘要，移除 in-progress 并添加 bot-done。
5. 人工审阅提交、测试结果和业务效果；确认无误后人工关闭 Issue。

常见状态

• queued：已入队，等待同仓库前序任务。
• running：执行器正在处理。
• retrying：临时失败后在重试或切换备用引擎。
• bot-done：实现和 CI 已完成，等待人工验证。
• failed：已达到重试上限或遇到不可自动解决的问题，应查看任务日志和失败分类。

任务执行不应自动关闭 Issue。若自动关闭规则意外生效，需要恢复开放状态并由人工处理最终关闭。