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