Skip to content

docs:术语表、ADR 0002 与核心档待办(B201–B218) - #244

Merged
SnowsonZ merged 2 commits into
mainfrom
docs/glossary
Oct 23, 2026
Merged

SnowsonZ merged 2 commits into
mainfrom
docs/glossary

Conversation

@Snowson

@Snowson Snowson commented Oct 23, 2026 •

Copy link
Copy Markdown
Collaborator

内容

  • GLOSSARY.md(新增):交付、判定与评审、角色、质量与稳定四组术语。正式术语用「门禁」,不用「闸口」;用「执行方」,不用「交付者」;风险等级用 R0–R3。
  • docs/decisions/0002-core-profile-subtraction.md(新增):在 harness 上做减法,保留核心档、新增平台适配层,停放派发与可观测性;部分取代 0001 第 4 条。
  • docs/backlog.md:
    • 新增推进项 B201–B214,写明顺序与依赖;新增暂缓项 B215–B218。
    • B81 冻结,移入「暂缓」;B45 的渐进档位并入 B201。
    • 编号从 B201 起跳,是为了避开并行分支在用的 B12x–B13x:pilot 已用到 B132,docs/migrate-harness-design-docs 用了 B126。
  • AGENTS.md、README.md、README.zh-CN.md:各加一行,指向术语表和决策目录。
  • docs/maintainers.md:补两条做法。一是实现可以交给设计方会话的子代理(Sonnet/Haiku),这类 PR 按设计方 PR 处理,不要求派发运行记录;二是子代理沿用设计方的钩子,守卫拦不住它改用例,所以设计方要先单独提交验收用例,复核时用 git diff 确认用例没被改过。

合并顺序

ADR 0001 只在 docs/migrate-harness-design-docs 上(开发完成,尚未验收)。0002 里只是用文字提到 0001,没有链接,所以先合哪个都不会产生断链。等那条分支合入后,docs/decisions/ 才完整。

依据:试装实测(2026-10-23)

在 picture-book-reading 的临时克隆里装了当前 main 的引擎:

  • 安装:写入 27 个非引擎文件,共 1539 行,外加 16.9k 行引擎副本。
  • verify:补约 10 行配置后,除卫生误报(B212)外,引擎检查和 backend 测试共 44 秒通过。
  • 判级:默认配置下,所有改动都判为 R2。
  • 提交:git 守卫会拒绝在 main 上提交(见 B204)。
  • 未测:Swift 检查和 agent 钩子的实际拦截效果。

风险与验证

  • 风险等级:R2。GLOSSARY.md、docs/decisions/ 未命中路径规则,AGENTS.md 本身属于 R2;需维护者审阅。
  • 本地检查:pre-commit 与 pre-push 的 verify 均已通过,docs、hygiene 也已单独跑过。

🤖 Generated with Claude Code

- 新增 GLOSSARY.md:交付、判定与评审、角色、质量与稳定四组术语
- 新增 docs/decisions/0002-core-profile-subtraction.md:在 harness 上做减法,核心档加平台适配层,停放派发与可观测性;部分取代 0001 第 4 条
- docs/backlog.md:新增推进项 B201–B214 与暂缓项 B215–B218;B81 冻结转入暂缓,B45 的渐进档位并入 B201;编号从 B201 起,避开并行分支在用的 B12x–B13x
- AGENTS.md、README.md、README.zh-CN.md:补术语表与决策目录的入口

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added class:K5 needs-independent-review Awaiting independent review labels Oct 23, 2026
@github-actions
github-actions Bot requested a review from SnowsonZ October 23, 2026 04:48
- ADR 0002 之后,实现可由设计方会话的子代理(Sonnet 或 Haiku)在独立 worktree 里完成,按设计方 PR 处理,不要求派发运行记录
- 子代理沿用设计方钩子,守卫拦不住它改判定器;设计方先单独提交验收用例,复核时用 git diff 确认用例未被改动

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Snowson

Snowson commented Oct 23, 2026

Copy link
Copy Markdown
Collaborator Author

独立评审(试行):通过

  • 评审方:codex(gpt-6.1-sol high);设计方:claude-code;评审的提交:74a4adc8501d;用时 1.7 分钟
  • 只读评审:只看任务书、PR 描述、diff 与证据包,不看执行过程;结论供用户参考,不替代用户审批。

结论:文档改动与声明范围一致,现有规则及 CI 证据未显示合并阻碍。

没有发现。

@Snowson Snowson removed the needs-independent-review Awaiting independent review label Oct 23, 2026

@SnowsonZ SnowsonZ left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

术语表、ADR 0002(核心档做减法)、B201–B218 待办与试装实测依据,必需检查全绿,按用户决定批准合并。

@SnowsonZ
SnowsonZ merged commit 54083de into main Oct 23, 2026
9 checks passed
@SnowsonZ
SnowsonZ deleted the docs/glossary branch October 23, 2026 07:17
github-actions Bot added a commit that referenced this pull request Oct 23, 2026
@github-actions

Copy link
Copy Markdown
Contributor

合并账本已固定(合并账本与链头锚点):

  • 分支:harness-audit
  • 文件:2026/244.json @ 8126931
  • 文件 sha256:c0cf48e3e8e0d58f32e1e5e38894458b2e305a5c180f11b5fa8f0643fcbb738a
  • 链头:ci:39903118286:1:harness @ 5d17ae8732e5eeb8d3282867903401168dd45d45a715f2af80a8e450080066e5;github:244:4d76369146807e725573497cd535bf8690d113716c136fac3e9c614c97208573 @ 5fec7f2e4e15b292ae99c33e7212321db1a18f0f557beb81a5b069d1df254a81;github:244:cbb4670727df0c3ea0c42c3642b0458e24380bb56552f5a1099fdafd9e101b0c @ 6761a4baee1c7975795ac44da169cf643238deacfdb74cf90351b777e18b635c;ci:39903766014:1:judge @ e222917c10896c7226181bdcddaae25abf2dc92c1f9b8e8fade56c07d27e67b7

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants