跳转至

Docs Publish Review

生成时间:2026-06-14T13:34:25.743834+00:00

本页把 Docs Page Inventory 的页面分类转成发布前审查动作。它回答两个问题:改了某一类页面时应该审什么,以及真实实践问题如何进入产品 Demo 而不把私域上下文原样带出去。

研用测一体 Case 规则

真实开发中遇到的构建失败、外链失效、协作冲突、上下文不足、权限边界、搜索误召回等问题,都是 Harness 的一等样本。处理顺序必须是:先作为 Evidence 保留可追溯线索,再抽象为 Ontology 对象、规则、Skill、Workflow 或实验制品,最后通过 Runtime Projection 变成可复现的 demo、benchmark、case study 或 CI gate。

这些 case 只能保存脱敏后的问题类型、触发条件、工程后果、复现 fixture、验证命令和修复结论;不能保存敏感原文、临时链接 token、cookie、完整日志、完整 URL、完整 SHA、客户材料或无关个人信息。也就是说,Demo 来自真实实践,但发布形态必须是可审计、可复现、可打包的 sanitized fixture。

汇总

  • 页面总数:84
  • case study 审查数:3
  • generated 页面审查数:33
  • Semantic Review handoff:semrev-pr-docs-health-adapter-boundary / pending

审查动作

Review Action Count
domain_owner_review 6
framework_fact_check 33
regenerate_source_review 33
sanitization_review 3
template_scaffold_review 12

Reviewer Queue

Reviewer Count
automation-maintainer 33
domain-maintainer 6
framework-maintainer 33
security-reviewer 3
workspace-maintainer 12

Case Study Queue

Path Title Gates
docs/knowledge/github-actions-retry-policy.md GitHub Actions Retry Policy source_registry_or_generator_updated, sanitized_fixture_only
docs/knowledge/github-actions-run-ledger.md GitHub Actions Run Ledger:PR/Docs Health 运行态事件实验 source_registry_or_generator_updated, sanitized_fixture_only
docs/knowledge/real-team-context-benchmark.md Real Team Context Benchmark:真实团队问题回归集 source_registry_or_generator_updated, sanitized_fixture_only

Page Review Matrix

Path Class Actions Gates Reviewers Publish Policy
docs/collaboration/agent-workbench.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/chatops.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/development-loop.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/github-cloudflare.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/index.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/karpathy-llm-wiki.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/obsidian-vault.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/quickstart.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/repo-vault-docs-wecom.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/team-project-repo-mvp.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/collaboration/toolchain.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/index.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/agent-network.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/agent-task-skill-packages.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/agentic-engineering-ontology-reference.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/agentic-search-option-benchmark.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/agentic-search.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/architecture.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/ask-router-simulation.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/connector-callback-ledger.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/connectors-and-mcp.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/context-layer-benchmark.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/context-library-architecture.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/context-management-eval.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/context-memory-hierarchy.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/context-router-demo.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/context-router-stale-policy.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/decision-log.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/department-scenarios.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/docs-page-inventory.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/docs-pr-review-adapter.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/docs-publish-review.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/domain-router-feedback.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/domain-scope-eval.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/domain-topology.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/entrypoints-and-ui.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/evals.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/evidence-registry.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/experiment-reports.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/external-connector-action-gateway.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/framework-domain-separation.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/github-actions-retry-policy.md generated regenerate_source_review, sanitization_review source_registry_or_generator_updated, sanitized_fixture_only automation-maintainer, security-reviewer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。 必须只保留脱敏后的问题类型、触发条件、工程后果、复现入口和验证信号。
docs/knowledge/github-actions-run-ledger.md generated regenerate_source_review, sanitization_review source_registry_or_generator_updated, sanitized_fixture_only automation-maintainer, security-reviewer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。 必须只保留脱敏后的问题类型、触发条件、工程后果、复现入口和验证信号。
docs/knowledge/glossary.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/governance.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/index.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/ingestion-quality-demo.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/knowledge-card-review-flow.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/knowledge-card-tool-gateway.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/loop-engineering.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/loop-spec-demo.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/mvp-development-plan.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/no-wecom-mvp-demo.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/ontology-context-architecture.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/ontology-tool-gateway.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/opensearch-adapter.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/orgreorg-roadmap.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/permissioned-views.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/postgres-search-adapter.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/proactive-collection.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/product-thesis.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/projection-remediation.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/real-team-context-benchmark.md generated regenerate_source_review, sanitization_review source_registry_or_generator_updated, sanitized_fixture_only automation-maintainer, security-reviewer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。 必须只保留脱敏后的问题类型、触发条件、工程后果、复现入口和验证信号。
docs/knowledge/retrieval-platform-benchmark.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/risk-driven-validation.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/roadmap.md demo_domain domain_owner_review current_demo_only domain-maintainer 只服务当前 OrgReOrg Demo,不进入通用 Framework 包。
docs/knowledge/runtime-adapters.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/runtime-refresh.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/search-adapter-state-benchmark.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/search-connector-conformance.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/search-connector-contract.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/search-tool-gateway.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/semantic-review-queue.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/task-skill-feedback.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/task-skill-package-eval.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/task-skill-usage-log.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/technology-alternatives-research.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/tool-gateway-safety.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。
docs/knowledge/tool-plane.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/transformation-playbook.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/vision.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/workflow.md framework_reference framework_fact_check no_current_demo_fact framework-maintainer 可作为 Framework 文档候选,但合并或打包前要确认没有当前 OrgReOrg Demo 的私域事实。
docs/knowledge/workspace-blueprint.md template template_scaffold_review placeholder_and_no_private_fact workspace-maintainer 只能通过 workspace scaffold 渲染到新团队空间,不能把当前网站内容原样复制。
docs/project-progress.md generated regenerate_source_review source_registry_or_generator_updated automation-maintainer 不手改页面主体;先改 registry、eval、dashboard 或 loop 源数据,再重新生成。

与 PR / 发布流程的关系

  1. 先运行 python scripts/docs_page_inventory.py --check-report,确认页面分类没有漂移。
  2. 再运行 python scripts/docs_publish_review.py --check-report,确认每一类页面都有对应 review action 和 gate。
  3. generated 页面必须改源数据后再生成;template 页面必须检查占位符;framework_reference 页面必须排除当前 Demo 私域事实;demo_domain 页面只能服务当前 Demo;带 case_study 标签的页面必须做 sanitized fixture review。
  4. python scripts/docs_pr_review_adapter.py --check-report 会把 PR changed paths 映射到这些 review action,作为真实 GitHub review comments 接入前的本地 adapter contract。
  5. 当前真实 GitHub PR review comments 还未接入,所以本页先通过 Semantic Review Queue 的 semrev-pr-docs-health-adapter-boundary 做本地 handoff。后续 GitHub adapter 接入后,应把这些 action 映射成真实 PR comment、required reviewer 或 check run。