From 693d24e03ee05175b1fe72996505ba7f4522b703 Mon Sep 17 00:00:00 2001 From: Axiomoth Date: Wed, 7 Oct 2026 08:33:55 +0700 Subject: [PATCH 1/3] =?UTF-8?q?docs(pr):=20=E8=AF=B4=E6=98=8E=E8=87=AA?= =?UTF-8?q?=E5=8A=A8=E5=88=9B=E5=BB=BA=E4=B8=8E=E6=89=8B=E5=8A=A8=E8=A1=A5?= =?UTF-8?q?=E5=BB=BA=E6=9D=A1=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Axiomoth --- .github/pull_request_template.md | 11 ++++++++++- AGENTS.md | 4 ++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index a1f7290..bab0c3d 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,3 +1,12 @@ -等待SPLRAD Steward根据当前提交和代码差异生成标题与正文。 +## PR 创建说明 + +**推送到本仓库的工作分支后，PR 由 SPLRAD Steward 自动创建或更新，无需手动操作。** + +- **机器人故障时：** 确认该分支尚无对应 PR 后，可手动补建。 +- **通过 fork 贡献时：** 请从自己的 fork 向本仓库发起 PR。 + +**AI 编码助手：** 向本仓库推送后，应检查对应 PR 和自动化状态，默认等待机器人处理。故障补建或从 fork 发起 PR，均须有用户明确授权；提交或推送授权不包含创建 PR。 + +手动创建 PR 时，请填写标题和变更说明，并保留模板中的受管注释标记。 diff --git a/AGENTS.md b/AGENTS.md index c2da7c7..fea5b09 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,6 +10,10 @@ - 只报告当前差异中有直接证据、会造成实际后果或违反明确仓库合同的问题。不得把人工智能审查、局部环境或未运行的测试表述为持续集成通过、批准或可以合并。 Safe path: 说明受影响的行为和最小安全修正路径；证据不足时不发表评论。 +### common.pr-creation +- 向本仓库的工作分支完成获授权的推送后，检查对应 PR，默认由 SPLRAD Steward 创建或更新。尚无对应 PR 时，检查自动化状态：正在运行则等待，状态不明则如实说明。只有确认机器人故障、无法自动创建时，才可按用户授权补建。通过 fork 贡献时，从贡献者的 fork 向本仓库发起 PR，无需等待机器人创建。 + Safe path: AI 代为创建或补建 PR，须有用户对该仓库和分支的明确授权。提交或推送授权不包含创建 PR；已有的有效授权无需重复询问。创建前检查是否已有对应 PR；创建时填写标题和变更说明，保留模板受管标记；创建后回读结果，核对来源分支和目标分支。此规则适用于交互式编码助手，Steward 按既有配置执行自动化。 + ### common.review-language-zh - 审查标题、摘要和行内意见以简体中文为主；技术术语、代码标识和平台固定字段保留原文，其他内容可按表达需要使用英文。 Safe path: 代码标识、文件路径、命令、日志原文、严重级别标签和平台固定字段保持原文；每条发现说明位置、实际影响和最小安全修正方向。 From 376eb4006d85fc901d7db5a522a5bb8612c643c8 Mon Sep 17 00:00:00 2001 From: Axiomoth Date: Wed, 7 Oct 2026 08:38:02 +0700 Subject: [PATCH 2/3] =?UTF-8?q?fix(docs):=20=E7=94=B1=E4=B8=AD=E5=A4=AE?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=E4=BB=BB=E5=8A=A1=E6=9B=B4=E6=96=B0=E7=94=9F?= =?UTF-8?q?=E6=88=90=E6=8C=87=E5=BC=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Axiomoth --- AGENTS.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index fea5b09..c2da7c7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,10 +10,6 @@ - 只报告当前差异中有直接证据、会造成实际后果或违反明确仓库合同的问题。不得把人工智能审查、局部环境或未运行的测试表述为持续集成通过、批准或可以合并。 Safe path: 说明受影响的行为和最小安全修正路径；证据不足时不发表评论。 -### common.pr-creation -- 向本仓库的工作分支完成获授权的推送后，检查对应 PR，默认由 SPLRAD Steward 创建或更新。尚无对应 PR 时，检查自动化状态：正在运行则等待，状态不明则如实说明。只有确认机器人故障、无法自动创建时，才可按用户授权补建。通过 fork 贡献时，从贡献者的 fork 向本仓库发起 PR，无需等待机器人创建。 - Safe path: AI 代为创建或补建 PR，须有用户对该仓库和分支的明确授权。提交或推送授权不包含创建 PR；已有的有效授权无需重复询问。创建前检查是否已有对应 PR；创建时填写标题和变更说明，保留模板受管标记；创建后回读结果，核对来源分支和目标分支。此规则适用于交互式编码助手，Steward 按既有配置执行自动化。 - ### common.review-language-zh - 审查标题、摘要和行内意见以简体中文为主；技术术语、代码标识和平台固定字段保留原文，其他内容可按表达需要使用英文。 Safe path: 代码标识、文件路径、命令、日志原文、严重级别标签和平台固定字段保持原文；每条发现说明位置、实际影响和最小安全修正方向。 From 261dc538c1264a22e9734dd87518605ebdf52505 Mon Sep 17 00:00:00 2001 From: Axiomoth Date: Wed, 7 Oct 2026 08:42:08 +0700 Subject: [PATCH 3/3] =?UTF-8?q?docs(pr):=20=E4=BF=AE=E6=AD=A3=E6=AD=A3?= =?UTF-8?q?=E6=96=87=E6=9B=B4=E6=96=B0=E4=B8=8E=E4=B8=AD=E5=A4=AE=E8=A7=84?= =?UTF-8?q?=E5=88=99=E5=90=8C=E6=AD=A5=E8=AF=B4=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 | 2 +- README.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index bab0c3d..703edb8 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -8,5 +8,5 @@ **AI 编码助手：** 向本仓库推送后，应检查对应 PR 和自动化状态，默认等待机器人处理。故障补建或从 fork 发起 PR，均须有用户明确授权；提交或推送授权不包含创建 PR。 -手动创建 PR 时，请填写标题和变更说明，并保留模板中的受管注释标记。 +手动创建 PR 时，请填写标题和变更说明，并保留受管注释标记。Steward 后续更新会重新生成标题和正文；需要保留的补充信息请写在 PR 评论中。 diff --git a/README.md b/README.md index 016c380..a83489a 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ ### 拉取请求模板 -`.github/pull_request_template.md` 提供组织默认模板。模板为 Steward 生成的标题与正文预留了受管区域，同时保留“人工补充”位置，用来填写自动摘要没有覆盖但审查者必须知道的信息。 +`.github/pull_request_template.md` 是创建 PR 页面使用的组织默认模板，说明自动创建、故障补建和 fork 贡献的流程。Steward 后续更新会重新生成标题和正文；需要保留的补充信息请写在 PR 评论中。 项目确有不同需求时，可以在项目仓库内提供自己的模板；否则应沿用这里的通用版本，避免重复维护。 @@ -29,9 +29,9 @@ ### Copilot 代码审查说明 -`.github/copilot-instructions.md` 规定审查主体使用简体中文，并统一阻断问题、建议问题和最终结论的格式。该文件由 Steward 的公共配置生成并同步，不是独立的规则源。 +`AGENTS.md` 保存共享规则，`.github/copilot-instructions.md` 保存 Copilot 平台补充说明。两个文件均由 Steward 的中央规则生成和同步。 -需要调整通用审查规则时，应修改 `splrad/steward` 中的 [`config/copilot/common.md`](https://github.com/splrad/steward/blob/main/config/copilot/common.md)，通过 Steward 校验后再同步到受管仓库。直接改动生成文件，后续同步时会被中央配置纠正。 +需要调整通用规则时，应修改 `splrad/steward` 中的 [`config/review/rules.json`](https://github.com/splrad/steward/blob/main/config/review/rules.json)。中央规则合并并成功部署后，由同步工作流更新受管仓库中的生成文件。规则尚未生效时，生成文件保持与当前中央策略一致。 ## 与 Steward 的分工