docs(ci): local-first CI standard + local gate runner - #37
Merged
Conversation
Add docs/CI.md (the CI 规范), scripts/alpha-check.sh (runs alpha-ci's three gates locally — north-star guard / typecheck / ui-mac tests — in seconds), an opt-in .githooks/pre-push, and a CLAUDE.md pointer. Principle: local-first — run the gates locally before push; CI is the enforcing backstop, not where failures first surface. Documents why only alpha-ci + sync-upstream are active (26 inherited upstream workflows disabled 2026-07-03: they need Blacksmith runners this fork lacks → queued forever = the real cause of "CI 卡/连不通"), plus a stuck-CI playbook. Additive alpha-owned files only; zero upstream edits. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jul 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
制定 CI 规范(用户要求),核心原则 本地先跑,CI 兜底。纯新增 alpha 自有文件,零改上游。
内容
docs/CI.md— CI 规范:local-first 原则、三关与 alpha-ci 的 1:1 对照、fork 只留alpha-ci+sync-upstream的原因(上游 workflow 要 Blacksmith runner 本 fork 没有→永久 queued=「CI 卡」真因)、卡住排查手册、可选 pre-push 钩子。scripts/alpha-check.sh— 一条命令跑齐 alpha-ci 三关(北极星守卫 +ext/ui-mactypecheck + ui-mac 单测),几秒出结果,push 前自检。.githooks/pre-push— 可选、默认不装(git config core.hooksPath .githooks开启),把 local-first 变强制。CLAUDE.md— 「跑起来」加一行 + 新增「CI」段指向规范。验证
bash -n语法通过;北极星守卫 git-diff 逻辑在干净 worktree 实测返回空(通过)。alpha-ci.yml。alpha-ci复核(dogfood)。🤖 Generated with Claude Code