Commit Graph

6 Commits

Author SHA1 Message Date
姚章浩 bcdeb7f927 fix(adopt): 生成器插入现状表的锚点写错,且失败是静默的
上一提交(d80b30e)里那句"验证:对两种 rep 各生成一次,落到 AGENTS.md 的那行
分别正确"**是不成立的** —— 验证脚本当场 IndexError,我却先把提交信息写好了。
如实纠正,并把挖出来的真 bug 修掉:

根因:`agents_md` 用 `body.replace("## 2. 硬约束", …)` 插入现状表,
而骨架里的实际标题是 `## 1. 硬约束`。`str.replace` 找不到时**静默返回原文**,
不抛错、不警告 ⇒ 这张"接入时核实的现状"表**从来没有被插进去过**,
而工具一切正常地"成功"了。这正是正本 §3.2-3 那条:断言校验器真的作用在目标上。

改法:
- 锚点改成真实的 `## 1. 硬约束`,小节改名为 `## 0b.`(插在 §0 与 §1 之间,不改骨架编号)
- 插入前**显式断言锚点存在**,不存在就带说明退出,不再静默

验证(本次真跑):
- 对「没开保护 / 开了保护」两种 rep 各生成一次,生成物中 `| 默认分支` 那行分别正确,
  且 `## 0b.` 确在
- 反向自检:把锚点改坏 → 报错退出(而不是照常返回一个缺了现状表的文件)
2026-10-10 18:06:31 +08:00
姚章浩 d80b30ec76 fix(template): 接入器生成的 AGENTS.md 不再写死"已启用分支保护"
上一提交改了"默认不开保护"的口径,但接入器仍在生成的 AGENTS.md 里写死
「**已启用分支保护**:禁止直接推送、必须走 PR」——默认不开保护时这句就是**假话**,
而下一个人会信它。kg 的 AGENTS.md 上现在正好有这句(见下条待办)。

改成按实际读到的 protections 如实写:没保护就写"直推"。
验证:对没开保护/开了保护两种 rep 各生成一次,落到 AGENTS.md 的那行分别正确。

顺带:templates/README.md 的 AGENTS 骨架 §5 补上分支口径(默认直推 main;
需要评审才开短命分支 + PR,且那是建议不是门禁)。
2026-10-10 18:05:48 +08:00
姚章浩 b87a102e34 fix(branch): 分支与评审口径改回原稿 —— main 直推,PR 只是建议
问题:我把原稿 §1.1 的「**所有改动直接进 main**」丢掉了,另外加了三条原稿没有的
口径,还全程以"正本 §1.x"的名义引用,没标出这是我加的:
  ① §1.2「业务代码必须 PR、高风险路径必须异人评审」
  ② §1.3「main 必须设分支保护:禁直推 + 必须 PR + 必须状态检查通过」
  ③ 把分支保护列进 03 的 P0 并顺手在一个仓上开了
后果是实打实的:kg 的 main 被锁成禁直推,使用者"本地 main 攒一批再推"的习惯
被迫改成走 PR —— 被规范的名义逼着换了工作方式。

改法(按原稿口径恢复):
- §1.1 恢复「所有改动直接进 main」;需要评审时才开短命分支 + PR
- §1.2 改成「什么时候开 PR(**建议**,不是门禁)」,并写明早期版本这么错过,
  防止下一个人"顺手加严"
- §1.3 改成「分支保护:**默认不开**」,写清它容易被忽略的代价:
  「必须状态检查通过」只门控 PR 合并,**直推 main 时管不住**(CI 推完再跑)
- 03 第 1 项 → 「已定:默认不开」;05 应用机制 / 06 接入文档 / new-project.sh 同步
- scripts/adopt-existing.py:改成 **--with-protection 才动保护**(原来是 --no-protection
  才不动,默认开)——默认值反了这本身就是在替使用者做决定
- 技能 eng-standards 同步(代理真正读到的是它,不同步等于改了文档没用)

平台侧:kg 的分支保护已 DELETE;7 个仓 branch_protections 全部为 []

验证:py_compile 通过;DRY-RUN 默认输出"默认不开";加 --with-protection 才出现保护计划;
正本仓已无"必须走 PR / 禁止直接推送 / 必须设分支保护"等旧措辞。
2026-10-10 18:04:21 +08:00
姚章浩 c26288b108 fix(gitignore): 补 __pycache__/ 与 *.pyc,并撤出误入库的字节码
自己违反了正本 §1.4:上一个提交把 scripts/__pycache__/*.pyc 带了进去,
而 .gitignore 里没有这条规则。这正是正本说的"只查规则在不在不够,
还要查 git ls-files 里有没有漏网的"。

修法:规则补上 + git rm --cached 撤出(保留磁盘文件)。
验证:git ls-files 里不再有 .pyc / __pycache__。
2026-10-10 16:26:24 +08:00
姚章浩 85f2471626 feat(adopt): 既有工程接入器 + 接入文档(含 PR 锁死陷阱的判定)
问题:只有"新工程生成器",没有"既有工程怎么接进来"的可复用路径;
而手工接入时最容易踩的坑是——盲目开"必须状态检查通过",会让 PR
永远等一个不会出现的检查,永远合不了。

新增:
- scripts/adopt-existing.py:体检 → 加指针(分支+PR)→ 开保护 → 打印自检命令。
  默认 DRY-RUN 不动任何东西;幂等(重复跑不改 main)。
  关键设计:状态检查是否开启由体检判定——只有"推任意分支都会跑"的工作流,
  PR 头提交才带着 (push) 状态;判定不通过就只开"禁直推+必须 PR"。
- 06-接入既有工程.md:判定表(带 7 个仓的实测结论)、一条命令、试点记录、
  手工四步、验收判据、会遇到的拒绝与处理、扩到其余仓的顺序。

试点实测(Weknora/knowledge-governance):PR #1 → CI context
build / build (push) success → mergeable=True(证明状态检查认 PR)→
合并 32b0ec58a612 → AGENTS.md 进 main;直推被 pre-receive 拒绝;
再跑 --apply 幂等,main 不变。

顺带修两个自查出来的毛病:
- ~/.git-credentials 里 LAN 主机是 URL 编码的(192.168.50.223%3a3000),
  按字面匹配会报"没有凭据"——改成解码后比对。
- runner 只在仓库级查,aiball 的 runner 挂在组织上,会误报"无 runner"。
2026-10-10 16:26:02 +08:00
姚章浩 cb5985ff9e feat(apply): 应用机制 + 新工程生成器,让规范默认生效
问题:规范此前只是文档,只有"有人去读"一个渠道 —— 实测 7 个仓 0 个有
AGENTS.md 指针、分支保护全空,起新工程时不会自动带上规范。

落地三件:
- scripts/new-project.sh:一条命令生成 9 个默认合规文件(提交闸门、CI、
  本地门禁、指针、提交规范 docs)。已端到端测过:空目录成功、非空拒绝、
  生成物 YAML 合法、无构建入口时门禁 exit 1(不静默通过)、默认分支 main。
- templates/ 收进 ci_gate.py / ci_report.py 的逐字节副本(cmp 校验通过),
  正本仓自此自包含,生成器不再依赖别的仓。
- 05-应用机制.md:写清 Hermes 的实际注入机制与两个必须避开的坑
  (每会话只加载一个上下文文件且有 20k 上限;不要把规则放 ~/.hermes/AGENTS.md
  —— 它只在 cwd 恰好是 ~/.hermes 时加载)。
- README / 03 加索引与交叉引用。

顺带修一个自己踩的坑:生成出来的 scripts/verify.sh 日志夹具只建不删,
正是正本 §3.2-5 自己写的陷阱($TMPDIR 会攒到几万条)。改成成功时删除、
失败时保留并打印路径。
2026-10-10 14:44:50 +08:00