全面修复项目审阅发现的问题:概念编号统一、过期计数清扫、C9 守卫、双语同步、frontmatter 统一、practice/tools 补全#11
Merged
Conversation
- 六大概念编号收敛为单一权威(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]>
- 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]>
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
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.
背景
对仓库做了一次全面审阅,发现的所有实质问题恰好都落在 C1–C8 机械检查的盲区。本 PR 按优先级完全修复,并为盲区补上新传感器(C9)。
修复内容
P0 — 概念编号三套体系互相矛盾
concepts/00-overview.md=concepts/AGENTS.md对照表(1 仓库 / 2 地图 / 3 机械化 / 4 可读性 / 5 吞吐量 / 6 熵管理)00-overview.md补回遗漏的"吞吐量改变合并理念","人类掌舵"升为总纲(不占编号),每个概念补"详见 →"文件链接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/正文禁止裸写文库计数,历史提法须带时点限定词AGENTS.md、SKILL.md 的 C1–C9 描述CI — 修复"consistency / check:Expected — Waiting for status to be reported"卡合并
consistency / check,但 Actions 实际上报的 check run 名是裸 job 名check(PR 页面上的 "workflow / job" 只是显示文本)。CI 明明通过,必需检查却永远等不到上报。修复:job 显示名固定为name: "consistency / check"paths:过滤 = 不触及受控文件的 PR 永远不触发工作流 → 永远 Expected。脚本秒级跑完,直接去掉路径过滤全量执行BLOCKED变为CLEANP2 — 双语 README 同步
README.en.md补齐中文版独有的 Development Notes(九层校验 + hook + CI)与 Sponsor 两节P2 — 22 篇翻译元信息头统一
translationMethod、统一sourceCoverImage字段名works/AGENTS.md写明必备/可选字段模板,头部约定可机械校验P3 — practice / tools 承诺缺口
practice/01-ralph-demo/归档PROMPT.md、ralph.yml、wc.py(README 引用源码原样提取)、test_wc.py(按记录的 7 项测试矩阵复原,明确标注复原件),补子目录AGENTS.md;practice/AGENTS.md加实验索引tools/harnesses/ralph-orchestrator.md首篇实测工具页(主张全部锚定 practice 实测与 thinking 分析);overview 矩阵维度 6 填入实测行;auxiliary/改为"规划中"避免悬空承诺P3 — 弱链接与杂项
references/articles.md30 个条目加article-N锚点,全部#N深链改为可跳转00-overview.md加map-not-manual锚点,07-spec-as-product.md的"§2"链接可跳转;顺带修复其缺失的 H1guides-sensors的失效行号引用改为章节名引用;修 claude-code 译文外链显示文本与 href 不一致验证
bash scripts/check-consistency.sh— C1–C9 全绿(C8 按预期 SKIP)python3 -m pytest practice/01-ralph-demo/test_wc.py— 7 passed(与实验记录的测试矩阵一致)consistency / checkcheck run 以正确名称上报 SUCCESS,gh pr view 11合并状态BLOCKED→CLEAN