Skip to content

docs: rewrite shared-rules.md §14 + rename main→develop across家规 (Q1 方向 A) #53

Description

@bouillipx

Context

co-creator 2026-07-07 拍板 branching model 方向 A(一致到底):

"我们自己的仓,你可以把 develop 分支类比为 upstream 仓的 main"

意思是:在我们 fork 里,develop 承担通常仓库里 main 的一切职责;main 变成纯粹的 upstream 镜像(只由 sync-upstream-main workflow bot push)。

历史违规调查见 thread thread_ml0k0ppsss0znslw 的 07-06 追溯——origin/develop..origin/main 22 个 commit 全是"我们自己的代码走了 main"。

Scope

家规 (cat-cafe-skills/refs/shared-rules.md) 里所有历史上按"main = 我们的主线"设计的内容全部 rename → develop:

§14 "共享状态文件只在 main 改" → rewrite

  • 标题改:共享状态文件只在 develop 改
  • 表格:.githooks/pre-commit 非 main 拦 → 非 develop 拦
  • 规则:在 main 上改在 develop 上改
  • 相关 workflow / hook / runtime preflight 引用一并改(拆到独立 issue,见 "Related")

加"main 分支纪律"铁律

Draft text:

第N条铁律:main 分支纪律

  • main 分支禁止一切人工/自动化 PR merge
  • upstream → main:由 `sync-upstream-main.yml` workflow bot 直接 push
  • 我们所有代码(feat/fix/docs/verdict/hotfix)一律 base=develop 开 PR
  • 违反 = P0:立刻 revert + 复盘偏差根因

15+ 处 main 字面量 audit

grep 命中位置(从 shared-rules.md):

  • 第 366 行 球权规则示例 "等合进 main"
  • 第 455 行 P0 bug 处置 "直接在 main 或 worktree 修"
  • 第 506 行 Rebase 三屏 "是否 rebase 到最新 main"
  • 第 525-533 行 冲突解决示例 "猫 B 的代码 (theirs / main)"

每处都要按语义判断:改 develop / 保留 main(upstream 引用)/ 更新注释。

Acceptance

  • §14 rewrite 完成
  • "main 分支纪律"铁律加入
  • 15+ 处 main 字面量逐一 verdict + 改动
  • PR base=develop
  • 跨猫 review 通过

Related

  • pre-commit hook + shared-state-guard workflow: main→develop(另开 issue)
  • F192 publish-verdict base=main → develop(另开 issue)
  • skills origin/main audit(另开 issue)

Blocker for

上述三个 issue 都会引用本 issue 建立的家规做 audit 依据。

[宪宪/opus-4-7🐾]

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions