提交 6c6a9b5d 编写于 作者: K kenneth 提交者: jinguang

!1477 【WIP】add build commands and status labels

* add build commands and status labels
上级 bc8b847e
# OpenHarmony社区PR评论支持命令清单 # OpenHarmony社区Pull Request&Issue评论支持命令清单
[Pull Request评论支持命令清单](#pull-request评论支持命令清单)
[Issue评论支持命令清单](#issue评论支持命令清单)
[Pull Request标签说明](#pull-request标签说明)
[Issue标签说明](#issue标签说明)
## Pull Request评论支持命令清单
| 评论输入命令 | 是否必选 | 使用场景 | 命令触发角色 | | 评论输入命令 | 是否必选 | 使用场景 | 命令触发角色 |
| ------------ | -------- | ------------------------------------------------------------ | ------------ | | ------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| start build | **必选** | 触发编译构建测试 | PR创建人<br>committer | | start build | **必选** | 触发编译构建测试 | PR创建人<br>committer |
| stop build | 可选 | 停止编译构建测试 | PR创建人 | | stop build | 可选 | 停止编译构建测试 | PR创建人 |
| submit | 可选 | 自动合入异常时,手工触发合入,检查通过后自动合并PR<br>检查通过条件:openharmony_ci测试通过+PR允许合入 | 任何人 | | submit | 可选 | 自动合入异常时,手工触发合入,检查通过后自动合并PR<br>检查通过条件:openharmony_ci测试通过+PR允许合入 | 任何人 |
| check dco | 可选 | DCO检查失败时, 更新DCO信息后,人工触发检查DCO<br>检查通过条件:已签署DCO+PR所有提交均包含Signed-off-by信息检查通过,可参考[DCO FAQ](https://gitee.com/openharmony/docs/blob/master/zh-cn/contribute/FAQ.md)处理 | PR创建人 | | check dco | 可选 | DCO检查失败时,更新DCO信息后,人工触发检查DCO<br>检查通过条件:已签署DCO+PR所有提交均包含Signed-off-by信息且检查通过。可参考[DCO FAQ](https://gitee.com/openharmony/docs/blob/master/zh-cn/contribute/FAQ.md)处理 | PR创建人 |
| static-check | 可选 | 静态检查失败时,手工触发静态检查,仅用于单独验证,不影响最终构建结果 | PR创建人 | | static-check | 可选 | 静态检查失败时,手工触发静态检查,仅用于单独验证,不影响最终构建结果 | PR创建人 |
| assign [@gitee_id] | **必选** | committer分配检视人员,命令中如果不指定gitee_id,committer安排自己为检视人员 | committer |
| lgtm | 可选 | PR检视人员无检视意见、认可PR时,评论该命令提醒Committer该PR可以合入;如果是Committer评论该命令,可以直接合入相关的PR | 通过assign命令分配的检视人员PR检视人员<br>committer |
| check comment | 可选 | 提交检视意见后,评论该该命令提醒PR创建人修改检视意见 | PR检视人员<br>committer |
| code review | 可选 | 代码仓没有配置测试门禁时,使用该命令提醒代码仓Committer进行代码检视 | PR创建人 |
## Issue评论支持命令清单
| 评论输入命令 | 是否必选 | 使用场景 | 命令触发角色 |
| ------------- | ---- | ----------------------------------------------------------------------------------------------------------- | ---------------------- |
| close | 可选 | committer审核issue,认定为非问题、重复问题、评审不解决时,通过该命令告知issue提交人要关闭对应的issue。 | committer<br>仓库成员等审核人员 |
| check comment | 可选 | 审核人员认定issue缺少信息,评论需要补充的信息后,再评论命令,issue打回提交人补充信息。 | committer<br>仓库成员等审核人员 |
| check update | 可选 | 标签为waiting_on_author时,issue提交人补充信息后,通过评论该命令,CI Bot会把标签设置为waiting_for_assign(未分配责任人)或waiting_for_fix(已分配责任人) | issue提交人 |
## Pull Request标签说明
在PR检视审核过程中,CI Bot会为PR设置处理状态标签,用于标识处理阶段。处理阶段包含:PR提交人处理阶段,检视人员分配阶段,检视人员检视阶段,等待审核合入阶段和已合入阶段。
| 标签 | 标签说明 | 触发命令、条件 |
| ------------------ | ------------------------ | -------------------------------- |
| waiting_on_author | 需要贡献者修改检视意见、门禁未通过等。 | start build门禁失败<br>check comment |
| waiting_for_review | 等待Committer指定检视人员检视提交的PR | start build门禁成功 |
| reviewing | 已分配检视人员,处于代码检视阶段 | assign [@gitee_id]分配检视人员 |
| waiting_for_merge | 检视人员无检视意见,已同意合入。 | 检视人员评论lgtm |
| merged | PR已经合并 | 审核者合入 |
除了上述处理状态标签,PR还支持其他标签,下表是部分支持的标签:
| 标签 | 标签说明 | 触发命令、条件 |
| --------------- | ------------------ | ---------------- |
| dco检查成功/dco检查失败 | DCO签署状态标签。 | 提交PR或check dco命令 |
| XX成功/失败 | 静态、门禁、格式化检查的成功失败状态 | start build门禁 |
## Issue标签说明
在issue检视审核过程中,CI Bot会为issue设置处理状态标签,用于标识处理阶段。处理阶段包含:issue提交人处理阶段,issue责任人分配阶段,Issue责任人修复阶段和已闭环阶段。
| 标签 | 标签说明 | 触发命令、条件 |
| ------------------ | -------------------------------------------- | ----------------------------------- |
| waiting_on_author | 需要Issue 提交人修改Issue,补充信息等;<br>需要Issue 提交人确认验收 | 审核者通过close命令返回提交人修改 |
| waiting_for_assign | 需求Issue审核者分配责任人处理Issue | 提交有效Issue后,CI Bot自动@仓库Committer提醒处理 |
| waiting_for_fix | issue在修复中 | committer分配了责任人,关联了pr |
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册