Semantic Review Queue

更新日期：2026-06-13

本页追踪那些不能只靠生成物 freshness 检查证明完成的人工语义 review handoff。它是未来企业微信 / GitHub review 工作流接入前的本地 MVP 替身。

本地操作入口

当前在企微 / GitHub review adapter 接入前，用本地 CLI 追加 reviewer event：

bash python scripts/semantic_review_queue.py \ --append-event \ --item-id semrev-loop-engineering-currentness \ --event-type review_started \ --actor alpc91 \ --resulting-status in_progress \ --summary "开始人工 review Loop Engineering 语义口径" \ --write-doc-after-append python scripts/generate_project_progress.py

--write-doc-after-append 会刷新本页；研发进度页仍由 generate_project_progress.py 从同一事件流重新生成。

汇总

• review item 数：2
• reviewer event 数：2
• pending 数：2
• in_progress 数：0
• resolved 数：0
• blocked 数：0
• P0 数：1

队列

Item	Status	Priority	Owner	Handoff	Last Event	Source
semrev-loop-engineering-currentness 确认 Loop Engineering 页面和 LoopSpec Demo 语义口径仍一致	pending	P0	knowledge-maintainer	requires_human_review_for_semantic_staleness	review_requested by codex 2026-06-13T10:45:00Z	vault/50-outputs/loop-spec-demo-analysis.md
semrev-pr-docs-health-adapter-boundary 确认 PR/Docs Health Loop 与真实 GitHub adapter 的边界	pending	P1	engineering-maintainer	requires_real_github_pr_ci_status	review_requested by codex 2026-06-13T10:46:00Z	.github/workflows/ci.yml

明细

确认 Loop Engineering 页面和 LoopSpec Demo 语义口径仍一致

• id: semrev-loop-engineering-currentness
• 状态：pending
• 状态来源：event_log
• 优先级：P0
• 类型：semantic_staleness
• Owner：knowledge-maintainer
• 来源：LoopSpec Demo analysis：vault/50-outputs/loop-spec-demo-analysis.md
• Linked loop：knowledge-maintenance
• Handoff：requires_human_review_for_semantic_staleness
• 创建时间：2026-06-13

最后操作：

review_requested by codex at 2026-06-13T10:45:00Z：已把语义过时判断从 LoopSpec dry-run 文本转成可追踪 review item；仍需 human reviewer 判断 Loop Engineering 页面、LoopSpec Demo 和研发进度页的语义口径是否一致。

原因：

Knowledge Maintenance Loop 只能证明生成物同步，不能判断 Loop Engineering 页面、LoopSpec Demo、研发进度页中的路线口径是否仍然一致。

证据路径：

docs/knowledge/loop-engineering.md
docs/knowledge/loop-spec-demo.md
docs/project-progress.md
vault/50-outputs/loop-spec-demo-analysis.md

受影响输出：

docs/knowledge/loop-engineering.md
docs/knowledge/loop-spec-demo.md
docs/project-progress.md

验收条件：

• 确认 Context Gap Collection、Knowledge Maintenance、PR/Docs Health 三条 loop 的状态描述一致。
• 确认 handoff 条件没有被描述成已经完成的外部系统动作。
• 如果发现过时口径，先更新结构化源数据，再重新生成发布页。

确认 PR/Docs Health Loop 与真实 GitHub adapter 的边界

• id: semrev-pr-docs-health-adapter-boundary
• 状态：pending
• 状态来源：event_log
• 优先级：P1
• 类型：adapter_boundary
• Owner：engineering-maintainer
• 来源：CI workflow：.github/workflows/ci.yml
• Linked loop：pr-docs-health
• Handoff：requires_real_github_pr_ci_status
• 创建时间：2026-06-13

最后操作：

review_requested by codex at 2026-06-13T10:46:00Z：已把 PR/Docs Health Loop 的真实 GitHub adapter 边界转成可追踪 review item；仍需 reviewer 确认本地 CI gate 与真实 PR checks / review comments 的职责边界。

原因：

当前 PR/Docs Health Loop 只能检查本地 CI gate contract，不能读取真实 PR checks、review comments 或 merge conflict 状态。

证据路径：

.github/workflows/ci.yml
framework/loops/closed_loop.py
docs/knowledge/loop-spec-demo.md

受影响输出：

docs/knowledge/loop-spec-demo.md
docs/project-progress.md

验收条件：

• 确认 ready_for_handoff 表示本地契约已验证，而不是 GitHub PR 状态已完成。
• 确认后续 GitHub adapter 需要读取 PR checks、review comments 和 merge conflicts。
• 确认 CI gate contract 至少覆盖生成物 freshness、单元测试和 MkDocs strict build。

事件日志

Event	Item	Actor	Result	Summary
semrev-event-20260613-001 2026-06-13T10:45:00Z	semrev-loop-engineering-currentness	codex / local_mvp_agent	review_requested -> pending	已把语义过时判断从 LoopSpec dry-run 文本转成可追踪 review item；仍需 human reviewer 判断 Loop Engineering 页面、LoopSpec Demo 和研发进度页的语义口径是否一致。
semrev-event-20260613-002 2026-06-13T10:46:00Z	semrev-pr-docs-health-adapter-boundary	codex / local_mvp_agent	review_requested -> pending	已把 PR/Docs Health Loop 的真实 GitHub adapter 边界转成可追踪 review item；仍需 reviewer 确认本地 CI gate 与真实 PR checks / review comments 的职责边界。