From 93d19b0b41ecde526624043dc3e57fc1b81d879b Mon Sep 17 00:00:00 2001 From: Axiomoth Date: Thu, 8 Oct 2026 16:34:58 +0700 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E6=89=8B=E5=8A=A8=20?= =?UTF-8?q?PR=20=E6=A8=A1=E6=9D=BF=E4=B8=8E=20AI=20=E4=BD=BF=E7=94=A8?= =?UTF-8?q?=E5=A3=B0=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Axiomoth --- .github/pull_request_template.md | 74 +++++++++++++++++++++++++++++--- 1 file changed, 68 insertions(+), 6 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 703edb8..11d0230 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,12 +1,74 @@ +**创建 PR 前，请删除本提示段。** + +向本仓库推送工作分支后，请等待 SPLRAD Steward 自动创建或更新 PR；确认机器人故障且没有对应 PR 时，再手动补建。 + +通过 fork 贡献时，请自行创建 PR。 + +手动创建 PR 时，请填写下列内容并删除填写提示；不适用的栏目填写“无”。 + -## PR 创建说明 -**推送到本仓库的工作分支后，PR 由 SPLRAD Steward 自动创建或更新，无需手动操作。** +## 摘要 + +用一两句话说明本次修改及预期效果。 + +变更类型：缺陷修复 / 新功能 / 重构 / 性能优化 / 文档 / 测试 / 构建与依赖 / 其他。 + +## 变更原因 + +说明要解决的问题、发生场景或需求背景。 + +修复缺陷时，说明原有行为、预期行为及复现方式；较大的设计调整请补充方案选择和主要取舍。 + +## 主要改动 + +- +- + +## 关联事项 + +填写相关 Issue、讨论或其他 PR 的编号或链接，并说明关系。 + +- **完整解决：** 使用 `Closes #议题编号`，表示合并到默认分支后关闭该议题。 +- **部分解决或仅相关：** 使用普通编号或链接，说明完成范围及剩余问题。 + +## 验证结果 + +- **验证环境：** 相关系统、运行时及依赖版本。 +- **验证步骤：** 执行的命令、测试或手动操作，便于审查者复现。 +- **实际结果：** 通过、失败或发现的问题，可附检查和日志链接。 +- **未验证事项：** 未覆盖的场景及原因。 + +## 影响分析 + +说明适用的影响： + +- 受影响的功能、模块及使用者。 +- 接口、配置、数据格式或行为的兼容性变化。 +- 新增或调整的依赖、权限、外部服务及费用。 +- 对安全、隐私、性能或资源占用的影响。 +- 已知风险、限制和暂未解决的问题。 + +## 发布与迁移 + +说明适用的发布要求： + +- 面向使用者的变化，以及文档或发布说明的更新位置。 +- 升级需要的配置、数据迁移、操作顺序或停机安排。 +- 需要先完成的其他 PR、版本或外部变更。 + +## 回退方式 + +说明恢复步骤、备份要求，以及数据或其他不可逆变化带来的恢复限制。 + +## AI 使用声明 + +- 本次贡献未使用 AI 编程助手。 +- 本次贡献使用了 AI 编程助手，人类进行了审查。 +- 本次贡献完全由 AI 编程助手代理生成，没有人类参与。 -- **机器人故障时：** 确认该分支尚无对应 PR 后，可手动补建。 -- **通过 fork 贡献时：** 请从自己的 fork 向本仓库发起 PR。 +## 补充材料 -**AI 编码助手：** 向本仓库推送后，应检查对应 PR 和自动化状态，默认等待机器人处理。故障补建或从 fork 发起 PR，均须有用户明确授权；提交或推送授权不包含创建 PR。 +填写其他需要审查者了解的背景、待讨论问题，以及必要的截图、日志或设计材料链接。 -手动创建 PR 时，请填写标题和变更说明，并保留受管注释标记。Steward 后续更新会重新生成标题和正文；需要保留的补充信息请写在 PR 评论中。