Skip to content

Commit a1ae6d5

Browse files
ShanireZclaude
andcommitted
docs: 收敛为 OKF v0.2 bundle,清掉已删计划的引用
工作区把 `nxtplan.md` 移除了,本仓随之清掉指向它的引用;同时按 OKF v0.2 契约 把 `docs/` 收敛到位。 - `docs/index.md`:补上 bundle 入口 / 声明 okf_version - Baseline 副本去掉首行钉子:钉子把 YAML frontmatter 挤离第 1 行,副本在 OKF 眼里因此没有 frontmatter - wrapper 随模板重生成 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 9fee5e9 commit a1ae6d5

5 files changed

Lines changed: 20 additions & 14 deletions

File tree

docs/agents/documentation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ tags: [documentation, okf, knowledge-bundle]
66
status: stable
77
sources:
88
- id: okf-v02
9-
resource: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
9+
resource: https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md
1010
title: Open Knowledge Format v0.2 specification
1111
---
1212

@@ -67,4 +67,4 @@ OKF v0.2 consumers can read v0.1 bundles using documented fallbacks. When a v0.1
6767

6868
Do not change a bundle-root `okf_version` declaration to `"0.2"` until the bundle has been audited for the version it claims.
6969

70-
[^okf-v02]: [Open Knowledge Format v0.2 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)
70+
[^okf-v02]: [Open Knowledge Format v0.2 specification](https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md)

docs/index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,3 +41,8 @@ This directory is the canonical, current-truth OKF bundle for DP大师. It conta
4141
`agents/` records **how tooling uses this repository** (where issues live, where to find domain docs, which engineering skills are installed, and this bundle's own maintenance contract) rather than product knowledge. The authority on project-level agent constraints is always [`AGENTS.md`](../AGENTS.md); this directory only carries the details it references.
4242

4343
* [Agent Configuration](/agents/index.md) - entry point for five conventions: issue tracker and Wayfinder rules, triage-label mapping, domain-doc layout (`CONTEXT.md` / ADRs, silently skipped when absent), engineering-skill orchestration, and the OKF v0.2 maintenance contract this bundle follows.
44+
45+
# Web 治理
46+
47+
* [Web Platform Baseline 治理(工作区唯一权威)](./web-baseline.md) - 工作区权威的逐字节副本,由 `node Docs/check-baseline-copies.mjs` 守着。**不要就地改**:改工作区权威再同步全部副本。
48+
* [sitemap / Markdown 内容协商 / Accept 判据(工作区唯一权威)](./web-contracts.md) - 同上,同一道门。

docs/web-baseline.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
<!-- baseline-copy: authority=Docs/web-baseline.md sha256=10550b43b998640a27434496e284e4291f3d72de454f6698ed05906f7fd93682 -->
2-
31
---
42
type: contract
53
title: Web Platform Baseline 治理(工作区唯一权威)
@@ -13,7 +11,10 @@ tags: [baseline, browsers, compatibility, contract]
1311
> 副本与权威不一致时,那个项目的质量门**会红**。⇒ **改本文件就要重跑各项目的门并同步副本**
1412
> 不要只改一边。
1513
>
16-
> 该 hash 门是 `nxtplan.md` 阶段 4 的交付物 —— 它挡的是 §8 那条陷阱:**自洽的陈旧抄件会通过每一道门**
14+
> **本文件正文不得出现相对链接**(外部 URL 可以):它会被逐字节复制到各项目 `docs/`
15+
> 不同深度,在那里相对路径必然解不开,而只有个别项目的 bundle 测试会发现。文件名写成代码跨度即可。
16+
>
17+
> 该 hash 门挡的是这样一条陷阱:**自洽的陈旧抄件会通过每一道门** —— 副本与权威脱钩后仍然自洽,没有任何东西会因此变红。
1718
>
1819
> 参考:[Baseline](https://web.dev/baseline) · [How to use Baseline](https://web.dev/how-to-use-baseline)
1920
@@ -25,7 +26,7 @@ tags: [baseline, browsers, compatibility, contract]
2526

2627
1. 目标项目自己的产品、安全、隐私、许可和浏览器合同优先。
2728
2. 本文件统一 Baseline 分类、六字段声明、工具链接线和复核门。
28-
3. [`web-contracts.md`](web-contracts.md) 在本文件之上登记 sitemap、同 URL Markdown 内容协商与 Accept 判据,**不得复制或降低本文件的浏览器合同**
29+
3. `web-contracts.md` 在本文件之上登记 sitemap、同 URL Markdown 内容协商与 Accept 判据,**不得复制或降低本文件的浏览器合同**
2930

3031
工作区采用以下默认策略:
3132

@@ -137,5 +138,5 @@ verification: 构建检查 + Chromium/Firefox/WebKit 自动化 + RUM 复核
137138
- 公网项目至少覆盖 Chromium、Firefox 和 WebKit/Safari 等价环境的关键路径验证。
138139
- 用户脚本在实际目标页面中验证;受控环境项目在实际部署浏览器中验证。
139140
- Baseline 不负责业务功能降级、运行时 Web API polyfill 或测试覆盖;这些必须由项目分别落实。
140-
- ★ **不要在本文件登记任何技能版本号**:那类值必然过期且不会红。Modern Web Guidance 的加载时机写在 [`dev_guide.md`](dev_guide.md) 环节 4,版本从当时安装的技能现读。
141+
- ★ **不要在本文件登记任何技能版本号**:那类值必然过期且不会红。Modern Web Guidance 的加载时机写在工作区的 `Docs/dev_guide.md` 环节 4,版本从当时安装的技能现读。
141142
- 后续实施必须先读取对应项目的 `AGENTS.md` 和权威文档,并尊重项目当前脏工作树及发布约束。

docs/web-contracts.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
<!-- baseline-copy: authority=Docs/web-contracts.md sha256=9f63b5a7850c358def642253b4c1a813ce5e99eb378ed873b05d049562a43742 -->
2-
31
---
42
type: contract
53
title: Sitemap / 同 URL Markdown 协商 / Accept 判据(工作区唯一权威)
@@ -9,11 +7,13 @@ tags: [sitemap, markdown, content-negotiation, accept, contract]
97

108
# Sitemap · 同 URL Markdown 协商 · Accept 判据
119

12-
> ★★★ **本文件是唯一权威**,与 [`web-baseline.md`](web-baseline.md) 同一套 hash 门:
10+
> **本文件正文不得出现相对链接**(外部 URL 可以):它会被逐字节复制到各项目 `docs/` 的不同深度。
11+
>
12+
> ★★★ **本文件是唯一权威**,与 `web-baseline.md` 同一套 hash 门:
1313
> 启用这三块的项目在自己的 `docs/` 下持完整副本并钉住本文件的 sha256,不一致即红。
1414
>
1515
> 来源:原 `NxtAgents/modern-web-guidance-sitemap-markdown-negotiation-plan.md` 的 §3.3 / §3.4 / §6.1–6.3。
16-
> 该仓已按 `nxtplan.md` N05 移除**这三块因为 `dp.round1.cc` 线上正按它们运行而必须留下**(N10)
16+
> 该仓已移除**这三块因为 `dp.round1.cc` 线上正按它们运行而必须留下**
1717
> 原计划 §4 的八波实施包与 §5 的 PubEnv 搜索闭环**已作废**(N10);§5.3 的上线预检 10 步
1818
> 因为是 DpMaster 退出门的验收依据,已内联进 [`ShanireZ/DpMaster#6`](https://github.com/ShanireZ/DpMaster/issues/6)
1919

site/scripts/check-baseline-copy.mjs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
// baseline-copy: authority=Docs/baseline-copy-check.template.mjs sha256=ef89982d3cca5c7bf3df589eb2e6e98e1c1574feb9581df02746403b874fd85a
1+
// baseline-copy: authority=Docs/baseline-copy-check.template.mjs sha256=9f8899702d7a673e96af9c7e1db6f61c1737a97fe92f67b1c493ad322b82d092
22

33
// (无 shebang:钉子必须是第 1 行,而 shebang 只在第 1 行才有效 —— 两者不能共存。
44
// 本脚本一律以 `node scripts/check-baseline-copy.mjs` 调用。)
5-
// nxtplan §4.3:本仓 docs/ 下的 baseline 副本必须与工作区权威逐字节一致。
5+
// 本仓 docs/ 下的 baseline 副本必须与工作区权威逐字节一致。
66
//
77
// ★ 本文件是从 Docs/baseline-copy-check.template.mjs 生成的副本,**不要就地改**——
88
// 工作区的 `node Docs/check-baseline-copies.mjs` 会逐字节比对它,改了即红。
@@ -12,7 +12,7 @@
1212
// 所以找不到工作区权威时它**显式宣告跳过并退 0**,不是静默通过:
1313
// - 开发机(工作区在)→ 真判,不一致即红。
1414
// - 单仓 CI(工作区不在)→ 打一行大写 SKIP。**唯一的执法点是工作区级那条命令**,
15-
// 写在 nxtplan §6 验收判据里
15+
// 执法点是工作区级的 node Docs/check-baseline-copies.mjs
1616
// 这条取舍是 owner 2026-08-30 拍的:让「没判」看得见,比让它假装判过要好。
1717

1818
import { readFileSync, existsSync, readdirSync } from 'node:fs';

0 commit comments

Comments
 (0)