Skip to content

全面修复项目审阅发现的问题:概念编号统一、过期计数清扫、C9 守卫、双语同步、frontmatter 统一、practice/tools 补全#11

Merged
deusyu merged 4 commits into
mainfrom
cursor/fix-review-findings-d160
Jul 2, 2026
Merged

全面修复项目审阅发现的问题:概念编号统一、过期计数清扫、C9 守卫、双语同步、frontmatter 统一、practice/tools 补全#11
deusyu merged 4 commits into
mainfrom
cursor/fix-review-findings-d160

Conversation

@deusyu

@deusyu deusyu commented Jul 2, 2026

Copy link
Copy Markdown
Owner

背景

对仓库做了一次全面审阅,发现的所有实质问题恰好都落在 C1–C8 机械检查的盲区。本 PR 按优先级完全修复,并为盲区补上新传感器(C9)。

修复内容

P0 — 概念编号三套体系互相矛盾

  • 收敛为单一权威:README = concepts/00-overview.md = concepts/AGENTS.md 对照表(1 仓库 / 2 地图 / 3 机械化 / 4 可读性 / 5 吞吐量 / 6 熵管理)
  • 00-overview.md 补回遗漏的"吞吐量改变合并理念","人类掌舵"升为总纲(不占编号),每个概念补"详见 →"文件链接
  • 概念文件 H1 去掉与文件号冲突的自编号(如 02-mechanical-enforcement.md 原自称"概念 2",实为概念 3),改为"名称 + 编号说明"
  • 下游(thinking/references/articles.md)所有裸写"概念 N"的错位引用改为名称 + 链接

P1 — 过期计数清扫(6 处)

  • references/articles.md"21 篇编号文章"、Prompt B"约 21 篇"、feedback/ 头部"11 篇翻译 / 18 篇文章"、thinking/ 三处"8 篇 / 7 篇 / 15 篇"——改为去数字链权威源,或加"写作时点"限定词
  • works/harness-engineering-chinese-interpretation.md 加写作时点快照声明
  • 修正 cross-article-insights.md"三个学派"标题(正文实为四个)

新增 C9 传感器(防复发)

  • scripts/check-consistency.sh 新增 C9:concepts/ / thinking/ / feedback/ 正文禁止裸写文库计数,历史提法须带时点限定词
  • 已做注入测试:加一行裸计数 → C9 FAIL / exit 1;还原 → 全绿
  • 同步 README×2、根 AGENTS.md、SKILL.md 的 C1–C9 描述

CI — 修复"consistency / check:Expected — Waiting for status to be reported"卡合并

  • 根因 1(名字不匹配):分支保护要求的必需检查上下文是字面量 consistency / check,但 Actions 实际上报的 check run 名是裸 job 名 check(PR 页面上的 "workflow / job" 只是显示文本)。CI 明明通过,必需检查却永远等不到上报。修复:job 显示名固定为 name: "consistency / check"
  • 根因 2(路径过滤死锁):必需检查 + paths: 过滤 = 不触及受控文件的 PR 永远不触发工作流 → 永远 Expected。脚本秒级跑完,直接去掉路径过滤全量执行
  • 修复后本 PR 合并状态已由 BLOCKED 变为 CLEAN

P2 — 双语 README 同步

  • README.en.md 补齐中文版独有的 Development Notes(九层校验 + hook + CI)与 Sponsor 两节

P2 — 22 篇翻译元信息头统一

  • 8 篇引用块头转为 YAML frontmatter;14 篇 YAML 头补齐 translationMethod、统一 sourceCoverImage 字段名
  • works/AGENTS.md 写明必备/可选字段模板,头部约定可机械校验

P3 — practice / tools 承诺缺口

  • practice/01-ralph-demo/ 归档 PROMPT.mdralph.ymlwc.py(README 引用源码原样提取)、test_wc.py(按记录的 7 项测试矩阵复原,明确标注复原件),补子目录 AGENTS.mdpractice/AGENTS.md 加实验索引
  • tools/harnesses/ralph-orchestrator.md 首篇实测工具页(主张全部锚定 practice 实测与 thinking 分析);overview 矩阵维度 6 填入实测行;auxiliary/ 改为"规划中"避免悬空承诺

P3 — 弱链接与杂项

  • references/articles.md 30 个条目加 article-N 锚点,全部 #N 深链改为可跳转
  • 00-overview.mdmap-not-manual 锚点,07-spec-as-product.md 的"§2"链接可跳转;顺带修复其缺失的 H1
  • guides-sensors 的失效行号引用改为章节名引用;修 claude-code 译文外链显示文本与 href 不一致
  • SKILL.md 悬空的 auto-memory 引用改为内联的减熵分流约定,并补 C9 说明

验证

  • bash scripts/check-consistency.sh — C1–C9 全绿(C8 按预期 SKIP)
  • ✅ C9 注入测试:临时加裸计数行 → FAIL / exit 1,还原后全绿
  • ✅ 全仓库 245 条相对链接 + 锚点全部可解析(一次性 Python 校验脚本,未入库)
  • python3 -m pytest practice/01-ralph-demo/test_wc.py — 7 passed(与实验记录的测试矩阵一致)
  • ✅ 22 篇翻译 frontmatter 必备字段机械校验通过
  • ✅ CI 修复实测:push 后 consistency / check check run 以正确名称上报 SUCCESS,gh pr view 11 合并状态 BLOCKEDCLEAN
Open in Web Open in Cursor 

cursoragent and others added 3 commits July 2, 2026 07:25
- 六大概念编号收敛为单一权威(README = 00-overview = concepts/AGENTS.md 对照表),
  概念文件 H1 去掉与文件号冲突的自编号,下游裸写'概念 N'改为名称+链接
- 00-overview 补回'吞吐量改变合并理念'(原遗漏),'人类掌舵'升为总纲不占编号
- 修正 cross-article-insights '三个学派'标题(正文实为四个)
- 过期计数改为写作时点快照措辞(thinking×3、feedback、articles.md、Prompt B)
- check-consistency.sh 新增 C9:concepts/thinking/feedback 禁止裸写文库计数,
  历史提法须带时点限定词;同步 README×2 / AGENTS.md / SKILL.md 的 C1–C9 描述
- README.en.md 补齐 Development Notes 与 Sponsor 两节(此前仅中文版有)
- articles.md 30 个条目加 article-N 锚点,#N 深链全部指向锚点
- SKILL.md 减熵分流约定内联化(原指向仓库外 auto-memory)
- 修 claude-code 译文外链显示文本与 href 不一致

Co-authored-by: Rainman <[email protected]>
- 8 篇引用块头(baoyu-translate 早期批次)转为 YAML frontmatter
- 14 篇 YAML 头补齐 translationMethod,coverImage 统一为 sourceCoverImage,
  postmortem 作者对齐 articles.md(Anthropic 工程团队),去除 maganti 冗余 author 字段
- works/AGENTS.md 写明必备/可选字段模板;memo 备注改为正文译注
- guides-sensors 的译文行号引用改为章节名引用(行号随头部改动已失效)

Co-authored-by: Rainman <[email protected]>
- practice/01-ralph-demo 落盘 PROMPT.md / ralph.yml / wc.py(README 引用源码原样提取)
  + test_wc.py(按记录的 7 项测试矩阵复原,标注复原件)+ 子目录 AGENTS.md(来源与复验说明)
- practice/AGENTS.md 增加'已有实验'索引表;demo README 增加归档文件一节
- tools/harnesses/ralph-orchestrator.md:按工具页模板写首篇(定位/降维判断/实测边界/
  失效场景/搭配/竞品),全部主张锚定 practice 实测与 thinking 既有分析
- tools/00-overview.md 矩阵维度 6 填入 Ralph 实测行,收录列表标注 ✅;
  tools/AGENTS.md 将 auxiliary/ 改为'规划中'避免悬空承诺

Co-authored-by: Rainman <[email protected]>
@deusyu deusyu marked this pull request as ready for review July 2, 2026 07:46
- job 显示名固定为 'consistency / check':分支保护按 check run 名匹配必需检查,
  此前 job 实际上报名为 'check',与保护规则要求的 'consistency / check' 不匹配,
  导致 CI 明明通过、必需检查却一直 'Waiting for status to be reported' 阻塞合并
- 去掉 push/PR 的路径过滤:必需检查 + 路径过滤 = 不触发时永远 Expected 的死锁;
  脚本秒级跑完,直接全量执行
- README×2 / AGENTS.md 同步 CI 兜底描述,并注明'改 job 名会重新卡住所有 PR'

Co-authored-by: Rainman <[email protected]>
@deusyu deusyu merged commit db9e229 into main Jul 2, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants