docs(ci): document protected status contexts

.gitea/workflows/ci.yml

@@ -1,3 +1,7 @@
+# Keep workflow name stable.
+# Branch protection and external CI references rely on:
+# - CI / verify (push)
+# - CI / verify (pull_request)
 name: CI
 
 on:
@@ -9,6 +13,7 @@ on:
 
 jobs:
   verify:
+    # Keep job id stable. Renaming it changes the status context.
     runs-on: ubuntu-latest
     env:
       WORKSPACE_DIR: ${{ github.workspace }}/repo

.github/workflows/ci.yml

@@ -1,3 +1,7 @@
+# Keep workflow name stable.
+# Branch protection and external CI references rely on:
+# - CI / verify (push)
+# - CI / verify (pull_request)
 name: CI
 
 on:
@@ -12,6 +16,7 @@ permissions:
 
 jobs:
   verify:
+    # Keep job id stable. Renaming it changes the status context.
     runs-on: ubuntu-latest
     timeout-minutes: 20
 

CONTRIBUTING.md

@@ -58,6 +58,7 @@ chore(scope): summary
 - 新接口是否有明确的错误码和测试
 - 平台适配是否仍然只停留在边缘层
 - callback / outbox / dead letter 是否可追踪、可重放
+- `.github/workflows/ci.yml` 与 `.gitea/workflows/ci.yml` 的 `name: CI` 和 `jobs.verify` 是否保持稳定，避免破坏受保护状态上下文
 
 ## 参考文档
 

README.md

@@ -130,6 +130,8 @@ go vet ./...
   GitHub 执行 `go test ./... -count=1`、`go test -race ./...`、`go vet ./...`、Gate 脚本语法检查；
   Gitea/TKSea 因共享测试库约束，执行 `go test ./... -count=1 -p 1`、`go test -race ./... -p 1`、`go vet ./...`、Gate 脚本语法检查
 - GitHub 使用 [`.github/workflows/ci.yml`](.github/workflows/ci.yml)，Gitea/TKSea 使用 [`.gitea/workflows/ci.yml`](.gitea/workflows/ci.yml)
+- `workflow` 名称和 `verify` job 名称属于受保护契约。当前分支保护依赖这两个状态上下文：
+  `CI / verify (push)`、`CI / verify (pull_request)`；不要随意改名
 - 本地默认共享 PostgreSQL 测试库，所以本地验证命令统一使用 `-p 1` 串行执行，避免跨包并发污染测试表
 - 变更配置契约时，必须同步更新：
   - `docs/CONFIG_CONTRACT_BASELINE.md`