wiki-page-standards

name	wiki-page-standards
description	仅用于采用 LLM Wiki 工作流的项目：根目录存在 AGENTS.md 或 CLAUDE.md，并准备采用 raw/ 与 wiki/ 双层结构。若 raw/import.md、wiki/index.md、wiki/log.md 缺失，先初始化。凡涉及 wiki 页面、索引、日志、交叉引用、YAML frontmatter、WikiLink 时优先使用。

Wiki Page Standards

先读 AGENTS.md 或 CLAUDE.md。本 skill 是该项目所有写入型任务的公共规范层；wiki-ingest、wiki-query-synthesis、wiki-lint 默认都应回到这里校准格式。

触发条件

• 用户要求新建或更新任意 wiki/*.md
• 用户要求修正 frontmatter、文件命名、目录分类、内部链接
• 用户要求维护 wiki/index.md 或 wiki/log.md

不应触发

• 当前项目不具备 AGENTS.md / CLAUDE.md 定义的 wiki 结构
• 任务只是导入原始资料，还未进入知识页写入阶段

前置检查

1. 确认当前工作区存在 raw/、wiki/、raw/import.md、wiki/index.md、wiki/log.md
2. 确认当前任务输出对象属于正式 Wiki 页面或索引/日志
3. 若只是在导入原始资料，转去 wiki-import
4. 若任务要基于 raw/ 落库，先校验来源是完整、可追溯、已本地化资产的合法原件

若上述控制文件缺失，先初始化最小骨架，再继续：

• raw/import.md
• wiki/index.md
• wiki/log.md
• wiki/Entities/
• wiki/Concepts/
• wiki/Topics/
• wiki/Comparisons/

初始化动作模板

开始执行前，按以下顺序初始化：

1. 判断当前目标文件属于：
   • 正式 wiki 页面
   • wiki/index.md
   • wiki/log.md
2. 若是正式页面，先确认文件归属目录与页面类型。
3. 若是更新任务，先读取旧文件，避免覆盖既有结构。
4. 准备统一骨架：文件名、frontmatter、正文区块、[[WikiLink]]。

标准执行清单

• 判断页面类型与目录
• 校验命名
• 写或补 frontmatter
• 写或补正文结构
• 补 [[WikiLink]]
• 必要时更新 wiki/index.md / wiki/log.md

页面初始化模板

---
title: 页面标题
type: entity
status: active
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags:
  - 标签
sources:
  - 来源说明
---

# 页面标题

## Summary
- 要点

## Details

## Related

## Sources

索引初始化模板

# Index

## Entities

## Concepts

## Topics

## Comparisons

日志初始化模板

# Log

目录与分类

• raw/：仅存完整原始资料，不写总结，不写节选，不写模型改写。
• raw/assets/：原始资料的本地附件。
• wiki/index.md：内容导航。
• wiki/log.md：时间日志。
• wiki/Entities/：实体页。
• wiki/Concepts/：概念页。
• wiki/Topics/：专题页。
• wiki/Comparisons/：对比页。

除 index.md 与 log.md 外，不在 wiki/ 根目录散落新文件。

分类语义规则

• entity 默认只用于系统构件、产品对象、协议对象、接口对象、架构对象、运行时对象、评测对象、工具对象。
• entity 不应默认用于“公司”“团队”“作者”“机构”这类组织性主体；即便来源来自公司官方文章，也应优先沉淀其反复出现的系统对象。
• concept 用于稳定概念、方法论概念、抽象机制，不用于承载单一产品条目。
• topic 用于聚合多个概念、实体、案例的专题性综述。
• comparison 用于承载明确比较轴下的差异分析，不用于简单并列摘录。

若一篇资料主要讲某家公司如何做事，默认判断顺序是：

1. 先提取其中的系统对象，考虑写入 Entities/
2. 再提取稳定概念，考虑写入 Concepts/
3. 若重点是方法差异、组织策略差异、评测风格差异，优先写入 Topics/ 或 Comparisons/
4. 不因资料来自知名公司就自动创建公司实体页

命名规则

• 文件名保持简洁、稳定、可复用。
• 优先英文或英文下划线命名，如 Model_Context_Protocol.md。
• 禁止 notes.md、summary.md、misc.md 这类模糊名。
• 若主题已存在近义页，优先更新，不重复建页。

Frontmatter 模板

所有正式 Wiki 页面必须以完整 YAML frontmatter 开头：

---
title: 页面标题
type: entity | concept | topic | comparison
status: active
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags:
  - 标签
sources:
  - 来源说明
---

要求：

• title/type/status/created/updated/tags/sources 全部必填。
• type 仅允许 entity、concept、topic、comparison。
• 更新页面时必须同步更新 updated。

页面语义模板

Concept 页默认组织维度

## Summary
- 3 到 7 条要点。

## What It Governs

## Core Structure

## Failure Modes It Addresses

## Relationship to Other Layers

## Why It Matters

## Related

## Sources

要求：

• concept 页优先回答“它约束什么、内部由什么构成、解决什么失效模式、位于哪一层、为何重要”。
• 不把宣传口号、作者化命名、一次性框架直接当成基础概念，除非其复用性与稳定性已被多处来源支撑。

Entity 页默认组织维度

## Summary
- 3 到 7 条要点。

## What It Is

## Role in the System

## Interfaces and Control Surface

## Operational Loop or Lifecycle

## Failure Modes / Limits

## Related

## Sources

要求：

• entity 页必须明确该对象在系统中扮演什么角色，而不是只写“谁提出了它”。
• 若候选条目本质上是组织主体，应优先改写为其内部系统对象，例如 harness、benchmark、protocol、tool、runtime、judge、reward model、agent loop。

Topic 页默认组织维度

## Summary
- 3 到 7 条要点。

## Scope

## Key Objects and Concepts

## Main Patterns or Tensions

## Practical Implications

## Related

## Sources

要求：

• topic 页优先回答“这个专题覆盖什么范围、牵涉哪些核心对象与概念、主要模式或张力是什么、对实践意味着什么”。
• topic 页不是大杂烩摘录；必须有明确主题边界，且要把多个 concept / entity / 案例组织成可复用结构。

Comparison 页默认组织维度

## Summary
- 3 到 7 条要点。

## Comparison Axes

## Axis-by-Axis Analysis

## Major Divergences

## Implications

## Related

## Sources

要求：

• comparison 页必须显式给出比较轴，禁止只按公司逐段罗列材料。
• 比较轴优先采用：Harness Thesis、Control Surface、Evaluation Style、Failure Handling、Governance Style、Moat Source。

正文模板

# 页面标题

## Summary
- 3 到 7 条要点。

## Details
按小节展开事实、机制、背景、差异与结论。

## Related
- [[相关页面A]]

## Sources
- 来源说明或链接

要求：

• 标题与 title 一致。
• Related 区块优先补齐关键关联页。
• 内部页只用 [[WikiLink]]，外链才用普通 Markdown 链接。
• 通用模板是下限，不高于上方各页面类型的语义模板；若页面属于 concept、entity、topic、comparison，优先使用对应组织维度。

index 与 log

• wiki/index.md：按目录分组，每页一行说明，统一 [[WikiLink]]。
• wiki/log.md：记录成功动作，以及失败的 Import；格式统一为 ## [YYYY-MM-DD] action | title。
• 任一新增页面、结构性更新、成功导入、失败导入、沉淀型查询或 lint 修复后，都要更新对应条目。

合法源门槛

• 合法源必须是第一方真实来源的完整原始材料。
• 非法源包括但不限于：摘要版、截断版、模型改写版、二手转载、搜索引擎总结页、无法定位回第一方的黑盒跳转页。
• 若原文中含有价值图片、截图、图表、架构图等资产，必须已本地化到 raw/assets/<DocName>/，且正文引用已改为对齐相对路径。
• 若来源在 raw/import.md 中标记为 [Failed]，或无法确认完整性与可追溯性，则禁止基于该来源进行 ingest。

输出义务

• 若产生正式页面，必须满足目录、命名、frontmatter、正文结构四项约束
• 若任务包含新增页或结构变化，必须更新 wiki/index.md
• 若任务属于成功的 Import / Ingest / Query / Lint，或失败的 Import，必须更新 wiki/log.md
• 若是初始化任务，应明确列出本轮创建了哪些控制文件与目录

与其他 skills 的协作

• 导入原始资料时跳转 wiki-import。
• 将原始资料转为知识页时跳转 wiki-ingest。
• 基于已有 Wiki 产出高价值回答时跳转 wiki-query-synthesis。
• 做健康检查或批量修复时跳转 wiki-lint。