/build-content-websites

name: build-content-websites
description: 构建以内容实体的发布、发现、阅读、引用、修订与归档为核心的网站；适用于单篇出版物、小型静态站、出版或机构站、文档与知识库、目录与档案、CMS 内容产品及内容迁移；不用于渠道图形、组件系统本体，或以反复操作业务对象为核心的产品界面。

构建内容型网站

领域边界

当主要对象是有身份和来源的内容实体，用户价值依赖其被找到、阅读、引用或持续维护时，使用本 Skill。若删除独立内容身份与阅读发现后价值仍不受损，应重新路由；营销图片属于传播图形，组件复用属于设计系统，审批、配置或保存业务对象属于产品界面。

服从 `$visual-artifact-design` 的共享治理。本 Skill 对内容 authority、发现和出版连续性保持介质中立：先确定最终消费者与目标介质，再选择呈现、构建和验收路径。只有最终消费者是 Web 或合同交付本身是 Web 时才调用 `$build-polished-visual-frontends`；非网页媒介不能用浏览器证据冒充目标消费者，浏览器预览最多是派生检查。

合同至少包含一个人类阅读或查看的最终消费者。网页、PDF、EPUB、邮件或应用内视图可各自呈现； feed/API 只能附属于同一内容，不能替代人的最终消费。只有机器消费时退出本视觉 Skill。内容事实、 URL、媒体来源和发布历史不因介质改变。先读 [领域模式](references/patterns.md)；选工具前读 [工具能力档案](references/tool-profiles.md)。

Web 视觉送达前置 gate

最终消费者包含 Web 时，在形成视觉方向或写第一行页面代码之前调用 `$build-polished-visual-frontends`，并完成以下记录；本域不能以内容 authority、框架选择或构建成功 替代它：

1. 锁定 `identity_route` 与 `layout_route` 并写入 `REFERENCE-CONTRACT`（定义见 `$build-polished-visual-frontends`）； 两条路线各自锁定，一条不能代替另一条。保存实际来源画面和 3–6 条可观察关系， 至少覆盖宏观结构／阅读顺序、层级／密度、主对象／图像角色；模板、标杆或品牌名称不算证据。 2. 建立 `VISUAL-THESIS` 与 `MASTER-VISUAL-CONTRACT`。在写页面 DOM、布局 CSS 或改造模板版式前， 先调用 `image_generate` 产出并查看项目级主视觉母版；已有合法真实资产只有在完成同一语义工作时 才可替代。每个主要页面族在布局前填写 `page_family / opening_job / visual_role / asset_lineage / reason / final_evidence`，`visual_role` 只用 `dominant_background / integrated_visual_field / content_first` 并默认第一种，先按大背景路线完成代表帧。若实际像素显示它妨碍主要阅读或操作任务， 先检查构图、裁切与文字关系；若冲突来自任务本身，可改用 `integrated_visual_field` 或 `content_first`。 在当前页面族的 `reason` 与 `final_evidence` 中记录具体冲突、调整前后像素和主要任务改善的证据， 并更新参考合同与视觉角色声明；单个页面族的例外不得推广到全站。实现便利、生成失败、资产成本、 没有真图、未经像素验证的可读性顾虑或模型偏好不能单独成为改路线的理由。 `visual_role` 声明须与渲染返回的 `opening_visual` 读数相符。大背景建立页面族开场，不要求每个 后续区块铺图；后续用同源资产、排印、内容结构或交互延续身份，不能退回默认内容块。 3. 遇到对比、评测或选型任务，先判断读者意图属于 `decision_support / neutral_comparison / benchmark_report / editorial_analysis`，关键词本身不决定 页面形态。只有 `decision_support` 必须把场景或标准、选项、证据和边界组织成可扫描的决策结构； 推荐必须有条件，不制造无依据的总体冠军。其他子型保留其自然文类，不强加推荐或决策矩阵。 4. 先按整页定义图像角色，再按主要区块建立资产路由表： `truth_asset | standard_symbol | generated_visual | exact_graphic`。内容页无合适真图时，hero、 场景、插画、纹理、表现型 icon 与 feature pictogram 使用 `image_generate`；系列 变体默认以主视觉或家族母图作为 image edit 输入。每项资产填写 `semantic_job` 和它与背景、 排印、内容结构或交互中至少两项的关系。标准功能 icon 来自一个既有系统或成熟家族；数据、文字、坐标和拓扑由 专业库或 renderer 负责。所有生成图在 provenance 记录真实性边界；纯氛围背景只记录 provenance， 不在成品展示制作过程。只有省略说明会造成事实误认时才用内容语境内的短说明消除误认，说明后 仍会误认则不得使用。不存在手绘 SVG、CSS 装饰或最终占位图降级路线。 页头、favicon 与 og 图的标识槽位按 `$visual-artifact-design` 的既有身份盘点：主体已有标识必须用它，没有 必须设计出来；简报里"无 logo / 自制标记"之类结论不是证据，自己去出处查看像素。 5. 代表画面直接使用已经取得的真实／生成资产，并逐条对照参考合同。`generated_visual` 只有在 成功调用、查看原图、记录 lineage、进入最终文件且被产品代码引用后才算使用；生成失败是能力 缺口，不授权用 SVG、Canvas 或 CSS 模拟。 6. 建立 `DETAIL-CONTRACT`：`SURFACE-MANIFEST` 覆盖页面族、顶层区块、独特状态和视觉例外； `COMPONENT-BEHAVIOR-MAP` 按独特行为类记录示能、动作、反馈、恢复与自动遍历入口。同组件、同状态 合同和同数据规则的重复实例可共享视觉证据，但所有实际目标仍须由浏览器自动遍历。最后一次可见 修改后逐行结账，再执行替图测试和模板距离测试；整页缩略图、构建成功或少数控件通过不能代替。 来源、权利、方法和真实性边界邻近其约束的内容，不自动做成巨幅或重复横幅。色条、标题旁竖线、 局部边框和图标外框只有在稳定编码导航、状态、分组或身份语法时保留，不能用来制造“权威感”。

什么算好，九条判据（CHECK 按代号逐条自评）：

• **J1 身份稳定可引**：每个内容实体有稳定 URL 身份，深链直达、可引用、可分享；
• **J2 阅读优先**：正文的行长、字号与层级优先于外壳；打开即读，不被巨幅壳面挡住内容；
• **J3 发现真实**：浏览、搜索与分面路径真实工作并覆盖 corpus；导航不是装饰；
• **J4 来源与时间可见**：来源、发布/更新日期与更正历史对读者可见、可信；
• **J5 单源派生**：页面、摘要、feed 与结构化数据全部由权威内容源派生，无第二事实源；
• **J6 长尾成立**：最长内容、缺值内容与极端标题在版式中不破版、不失义。
• **J7 世界先于图槽**：主视觉在布局前完成，每个主要页面族都有经任务证明的视觉角色和同源资产

关系，页面身份同时进入排印、结构和交互；

• **J8 逐区闭环**：首页以下的每个区块和每个页面族都以真实内容达到成品状态，不把正确内容直接

倾倒进默认模板，也不以精修首屏代表整站完成；

• **J9 示能兑现**：所有视觉上承诺交互的元素都有真实动作、状态和反馈；静态内容不伪装成控件。

1. 冻结领域合同

先记录 `work_mode: Create | Edit | Migrate | Diagnose | Audit`；Diagnose/Audit 对原对象和外部系统零写入。再明确：受众任务、内容子型、内容与媒体来源、目标部署、更新责任、风险、验收要求、目标 claims 和非目标。

冻结 `final_consumers`：至少一个主要人类消费者，以及适用的附属机器消费者；逐一记录目标介质、实际 renderer/client/device 及版本、入口与任务、视觉尺寸或非视觉输入条件、成功/失败状态和最终验收。内容 authority 与呈现必须分离；同一内容可以有多个消费者，但每个消费者分别声明呈现 owner、构建 hash 和证据，不能用某一媒介通过外推另一媒介。

选择一个主子型：单篇出版物、小型静态站、出版/机构站、文档/知识库、目录/档案或 CMS 内容产品。混合站按页面族标出从属领域，不能用“混合”跳过主对象与权威来源判断。

先声明 claim families

| Claim family | 只回答什么 | | --- | --- | | `content_identity` | 哪些实体与字段可被当前权威源支持 | | `url_lifecycle` | 哪些身份、路径、迁移和终止行为已验证 | | `discovery_behavior` | 所选发现轴上的浏览、查询、分面或关系是否成立 | | `publication_continuity` | frozen、maintained 或 governed 中哪些动作真实发生 | | `media_provenance` | 哪些原件、权利和派生变换可追溯 | | `delivery_integrity` | 当前构建在哪些最终消费者、介质、页面族或等价内容单元及目标环境成立 |

不要把其中一族的通过外推到另一族；例如搜索命中不能证明内容事实，发布成功不能证明 URL 长期稳定。

两个独立能力轴

| 轴 | 值 | 合同含义 | | --- | --- | --- | | `publication_continuity` | `frozen` | 固定版本或一次性交付；保留身份、来源和构建，不声称持续维护 | | | `maintained` | 有更新责任、修订/更正、归档和 URL 变更策略 | | | `governed` | 有真实角色、审批、权限、回滚、审计、备份与发布监控 | | `discovery_complexity` | `single` | 一个稳定入口和内容身份；不伪造集合或搜索 | | | `collection` | 多个独立实体、集合入口、浏览规则和可达路由 | | | `search` | 真实索引、查询合同、结果语境、零结果和新鲜度 | | | `faceted_relational` | 搜索之外还有受控分面、计数、分页、关系语义和状态恢复 |

两轴不是成熟度阶梯。选择满足任务的最小完整组合；升级任一轴都必须由内容规模、用户任务、编辑责任或风险触发。canonical、迁移、CMS、结构化数据、媒体权利和公开 SEO 也按 [触发条件](references/patterns.md#能力触发) 加载，不能把未知或未实现写成不适用。

2. 建立领域 authority graph

每个 concern 只能有一个权威 owner；一个版本化 bundle 可以作为不可拆分 owner。至少分开记录：

| concern | authoritative owner | 永远只是 derived 的对象 | | --- | --- | --- | | 内容事实 | 内容仓库、CMS 数据集或已接受的结构化源 | 页面、摘要、feed、结构化数据 | | URL 身份 | 稳定 ID、路由、alias/redirect/canonical 的版本化映射 | 链接、sitemap、导航缓存 | | 媒体 provenance | 原件与来源、权利、变换规则的资产清单或 DAM | 裁切、缩略图、转码和页面嵌入 | | 搜索索引 | 版本化检索合同：字段映射、分析器、权重、过滤与同步规则 | 由内容和检索合同生成的实际 index、结果缓存 | | 发布历史 | CMS revision log、VCS/release ledger 或批准的变更账本 | 页面更新时间标签、Gallery 和 Viewer 展示 | | 视觉语言 | 已接受的品牌规范、设计系统或项目 token | 介质 token 映射、computed style、截图和最终像素 | | 呈现映射 | 每种目标介质的模板、内容到介质的字段/结构映射与转换配置 | DOM、分页文件、阅读器视图及其他消费输出 |

内容源拥有事实，视觉语言 owner 决定可复用的视觉语法；呈现 owner 只消费二者，将内容映射进特定介质，不能拥有或复制另一套标题、日期、作者、关系、更正事实或视觉 token。没有视觉表面的附属消费者可为 `visual_language` 写带范围理由的 `not_applicable`；视觉消费者没有已接受的品牌或设计系统时，则以已证明的最小自定义边界建立独立、版本化的项目 token owner，不能在模板里形成隐式第二皮肤。Astro、Next、Nuxt、Eleventy 等框架只可拥有其内容模型、路由和构建 concern；它们没有可被虚构为共同品牌皮肤的原生视觉语言。索引、截图、预览、导出和 Viewer 都不能反客为主。

3. 选择并证明工具

先列能力，再比较共享 Tool Registry 与 [领域档案](references/tool-profiles.md)