wiki-ingest

name	wiki-ingest
description	仅用于采用 LLM Wiki 工作流的项目：根目录存在 AGENTS.md 或 CLAUDE.md，并准备采用 raw/ 与 wiki/ 双层结构。若 raw/import.md、wiki/index.md、wiki/log.md 缺失，先初始化。用户要求把 raw 层资料落到 wiki、更新旧页、建新页、处理冲突、补交叉引用时触发。

Wiki Ingest

先读 AGENTS.md 或 CLAUDE.md，并以 wiki-page-standards 作为写入规范。若资料尚未正式导入 raw/，先回到 wiki-import。

触发条件

• 用户说“把这篇资料整理进 wiki”
• 用户要求更新实体页、概念页、专题页、对比页
• 用户要求基于某个 raw/ 文档修订已有结论或新增知识页

不应触发

• 当前任务只是原始资料下载、保存、登记
• 当前任务只是对现有 wiki 做回答，不涉及从 raw 落库

前置检查

1. 资料已在 raw/，且来源可信、完整、可追溯
2. 已查看 wiki/index.md，确认相关页面是否已存在
3. 已回看 wiki-page-standards 的格式要求
4. 确认来源不是摘要版、截断版、模型改写版、伪造源，且原文中的价值图片已完成本地化
5. 确认来源与当前研究主题直接相关，而不是邻近材料或背景材料

初始化动作模板

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

1. 读取目标 raw/ 文档，确认其已完成 Import。
2. 校验目标 raw/ 文档是否为完整原件；若是节选、摘要、伪造源、悬空公网资产源或 raw/import.md 中标记为 [Failed]，停止 ingest。
3. 读取 wiki/index.md，列出最可能受影响的已有页面。
4. 确认本轮主动作是：
   • 更新已有页
   • 新建页面
   • 同时更新多个关联页
5. 确认本轮产出页所属目录：Entities/、Concepts/、Topics/、Comparisons/。
6. 在落页前先做一次“知识对象抽取”，明确本轮材料里：
   • 哪些是系统对象
   • 哪些是稳定概念
   • 哪些是专题性问题
   • 哪些适合做显式比较

标准执行清单

• 读来源
• 查现有页
• 判断更新还是新建
• 按 frontmatter 模板写页
• 补 [[WikiLink]]
• 更新 wiki/index.md
• 更新 wiki/log.md

冲突处理模板

若新资料与旧页冲突，至少写出：

## Conflicts / Updates
- 冲突点：
- 旧说法依据：
- 新说法依据：
- 当前判断：
- 待补充来源：

最小输出模板

### Ingest Result
- Source: raw/...
- Action: update-existing | create-new | mixed
- Pages: [[PageA]], [[PageB]]
- Index Updated: yes | no
- Log Updated: yes | no

前置判断

• 资料是否已完成 Import
• 资料是否为完整原件而非摘要、节选或推测重建
• 图片、截图、图示等资产是否已完成本地化
• 资料是否直接服务于当前研究主题，而不是仅提供外围背景
• wiki/index.md 中是否已有对应页面
• 内容属于 entity、concept、topic、comparison 中哪一类

基本原则

• 先更新已有页面，再考虑新建页面。
• 新信息与旧结论冲突时，不得静默覆盖。
• 对能形成稳定专题或比较框架的内容，可新建 Topics/ 或 Comparisons/ 页面。
• 非法源不得进入 ingest，即便内容看起来有价值也不例外。
• 邻近材料不得冒充核心证据；若仅可作背景补充，必须降低其证据权重或暂不 ingest。
• 页面分类与语义边界以 wiki-page-standards 为唯一完整规范源。
• entity 仅保留为系统对象页，不把公司作为默认实体页。

分类决策顺序

每次 ingest 前，按以下顺序判断写入目标：

1. 这份材料里是否存在可复用的系统对象？
   • 若有，优先更新或新建 Entities/
2. 是否存在稳定概念而非特定实现？
   • 若有，更新或新建 Concepts/
3. 是否更像围绕一个问题域的多点讨论？
   • 若是，优先写 Topics/
4. 是否核心价值在于“谁如何不同”？
   • 若是，优先写 Comparisons/
5. 具体分类语义、页面边界与例外处理，回读 wiki-page-standards

分析维度要求

• concept、entity、comparison 的默认分析维度以 wiki-page-standards 为准。
• ingest 时不重复发明页面骨架；若要写正式页面，先回读 standards 中对应页面类型的语义模板。

执行步骤

1. 阅读来源，提炼事实、机制、关系、结论、争议与上下文。
2. 先验证来源完整性与可追溯性；若不满足，停止并回到 wiki-import 重导。
3. 先做知识对象抽取，不要直接把“文章来源公司”当成页名候选；优先识别系统对象、稳定概念、专题问题与比较轴。
4. 先看 wiki/index.md 和相关页面，确认是更新还是新建。
5. 按 wiki-page-standards 写入完整 frontmatter、正文结构与 [[WikiLink]]，并按页面类型套用相应分析维度。
6. 若出现冲突，显式写明：
   • 冲突点是什么
   • 各自依据是什么
   • 当前更可信的判断是什么
   • 若无法判断，则并列保留
7. 同步更新 wiki/index.md。
8. 在 wiki/log.md 追加 ## [YYYY-MM-DD] ingest | 文章标题。

输出义务

• 优先更新已有页，而不是制造近义碎片页
• 冲突必须显式记录，不能静默覆盖
• 新增页或结构变化后必须更新 wiki/index.md
• 完成后必须写 wiki/log.md
• 若改动多个页面，应明确列出本轮受影响页面

何时新建页面

• 已有页面无法稳定容纳新主题
• 新主题具有持续复用价值
• 新比较框架或专题结构足够独立
• 新出现的系统对象在后续研究中会被反复引用

否则，优先作为已有页面的新小节、差异说明或演进记录。

完成后的衔接

• 若用户是在提问而非导入资料，转到 wiki-query-synthesis。
• 若落库后需要检查重复页、孤链、frontmatter 漏项，转到 wiki-lint。