docs: document direct push path for docs changes

This commit is contained in:
Codex
2026-05-28 10:39:33 +08:00
parent 1d0f690dc4
commit 912d6251a1
3 changed files with 11 additions and 7 deletions
+6 -2
View File
@@ -21,13 +21,17 @@
- D601 发布和 rollout 工作区是 `/home/ubuntu/workspace/hwlab`
- 不要清理、reset 或复用无关 runner worktree 作为发布真相。
## 分支和 PR 工作流
## 分支和交付工作流
- 单纯文档、CLI/helper 轻量变更默认直接提交并 push 到 `origin/G14`,不开 PR;这类变更仍要先从最新 `origin/G14` 创建独立 worktree,提交前审查 diff,只提交当前任务相关文件。
- 业务代码、运行面、发布链路、Secret、权限、数据迁移、PROD、重启服务、CI/CD 控制面高风险变更或其他影响 runtime truth 的变更默认走 PR 工作流。
- 用户或指挥官给出最新交付纠偏时,以最新要求为准,删除旧断言或旧门禁,不用 feature flag、legacy mode 或双路径长期并存绕开最新要求。
- 从最新 `origin/main` 创建短分支。
- 不要直推 `main`
- 不要修改 PROD。
- 除非任务明确授权,不要重启服务。
-`pikasTech/HWLAB:main` 创建 PR。
- 需要 PR 时`pikasTech/HWLAB:main` 创建 PR。
- runner 默认不合并自己的 PR;用户或指挥官可以对单个 PR 明确授权 runner 自合并。
- 自合并前必须同时满足:PR 为 `MERGEABLE/CLEAN` 或等价无冲突状态;required checks 没有失败;D601/CI 或指定运行态验证证据已贴到 PR/issue;变更不涉及 PROD、Secret、权限提升、数据迁移或未授权重启;runner 在最终评论中列出提交 SHA、验证命令和回滚边界。
- 当前 GitHub 写入仍优先走 UniDesk CLI 或 repo-owned GitHub 路径;若当前 CLI 不支持 merge,必须使用可审计的授权路径,不能用无记录的本地绕行来规避审计。