wiki-review

name	wiki-review
description	单个 wiki 页面"格式对齐 + 过期归档"工具。把多次更新后混乱的页面对齐到 value-invest 模板的章节顺序，并把过期内容归档到「历史观察」附录。Use when user says "review 某页面"、"整理某页面"、"归档某页面的过期内容"、"某页面格式乱了"。

Wiki Review Skill

定位

针对用户指定的单个 wiki 页面，做三件事：

1. 对齐 value-invest 模板：保证多次更新后章节顺序与命名仍然统一
2. 过期内容归档：把已被替代/已触发的内容移到「历史观察」附录
3. 错误信息直接删除：被证伪的内容真删，git log 兜底（不归档进历史观察，避免附录变垃圾场）

核心原则：value-invest 模板（skills/value-invest/templates/stock-analysis.md）是 wiki 个股页面格式的 single source of truth。wiki-review 不发明新结构，只做"回归模板"。

适用范围

仅适用于个股页面（wiki/stocks/<sector>/<name>.md，且排除 wiki/stocks/价格区间总览.md 这类索引文件）。其他类型页面：

页面类型	wiki-review 行为	退出原因
个股页（wiki/stocks/<sector>/）	✅ 完整执行	—
行业/板块页（wiki/sectors/）	❌ 退出	无对应 value-invest 模板
宏观主题页（wiki/macro/）	❌ 退出	无对应模板
策略页（wiki/strategies/）	❌ 退出	无对应模板
投资日志（wiki/journal/）	❌ 退出	时间序列记录，不该被重排
索引/总览（wiki/index.md / wiki/log.md / wiki/stocks/价格区间总览.md）	❌ 退出	中央索引，由各 skill 各自维护
wiki/stocks/focus/* 软链	✅ 自动 follow 到真实路径继续执行	focus 软链指向真实个股页，应当 follow 而不是退出
基金/ETF 页（wiki/funds/）	❌ 退出	基金有独立模板，未对齐 value-invest（后续如有需要可扩展，需要新模板）

硬约束

约束	含义
不动模板内章节内容	只调整章节相对位置，不改章节内文字（重排时整段搬移）
不删除有效信息	过期但仍有信号的内容（v1 估值、已触发催化剂）归档到「历史观察」
错误信息直接删除	被证伪的内容真删，不归档（git log 兜底）。「历史观察」只放有信号的历史判断，不收垃圾
不重命名章节标题文字	但允许把页面里的旧名（如"风险因素"）统一为模板标准名（"风险提示"），见下方"命名映射表"
不动 ingest 原始数据	财报数字、历史事件、原始引用保留
不动 frontmatter（除 updated）	只更新 updated: YYYY-MM-DD 字段；frontmatter 缺失时不主动新建，只在 dry-run 标注请用户决定
不动 raw/articles/	review 只改 wiki/
不动 stock-deep-dive 输出章节	## 产品深度分析 (YYYY-MM-DD) 这类带日期的章节由 stock-deep-dive 显式要求保留历史，wiki-review 不归档不重排，整体当一个 block 移到 value-invest 之后
不扫全 wiki	用户必须指定页面路径，没指定就反问
必须 dry-run 后再执行	Step 4 输出 plan，Step 5 等用户确认后才执行

When to Use

触发（必须满足任一）：

• 用户明确说："review 某页面 / 整理某页面 / 归档某页面 / 某页面格式乱了"
• 用户读完一个页面后说"这页面太长 / 重复 / 看着乱"且明确指了页面

禁止触发：

• 用户没指定具体页面（应反问"哪个页面"）
• 用户在请求新分析或 ingest（那是 value-invest / stock-deep-dive 范畴）
• 全 wiki 扫描（不在本 skill 范围）

注：本 skill 不做"主动建议触发"——LLM 无法可靠计数页面历史触发次数，主动建议易误判。统一由用户主动调用。

Source of Truth：完整目标章节顺序

source of truth 是 skills/value-invest/templates/stock-analysis.md（章节 1-11）。完整目标顺序：

#	章节	来源
0	基本信息（H1 标题之后、首个 ## 之前的隐式段，或显式 ## 基本信息）	wiki 自有元数据
1	TL;DR	wiki 自有简短结论
2	投资结论（含价格区间四档表）	value-invest 模板第 1 章
3	合理PE推导	value-invest 模板第 2 章
4	多模型估值	value-invest 模板第 3 章
5	远期分析（如适用）	value-invest 模板第 4 章
6	利润分解与交叉验证（如适用）	value-invest 模板第 5 章
7	安全边际与买卖价	value-invest 模板第 6 章
8	核心财务数据	value-invest 模板第 7 章
9	同行对比	value-invest 模板第 8 章
10	风险提示	value-invest 模板第 9 章
11	关键关注点	value-invest 模板第 10 章
12	附：格雷厄姆参考尺	value-invest 模板第 11 章
13	业务结构 / 业务画像	wiki 自有（用户自由写的业务深度，非 stock-deep-dive 输出）
14	竞争格局 / 国际同行 / A股同行	同上
15	护城河 / 产业链	同上
16	资本运作 / 海外业务 / 子公司分拆等深度章节	同上
17	详细数据 / 资产负债表细项	同上
18	## 产品深度分析 (YYYY-MM-DD) × N	stock-deep-dive 显式输出（带日期标题）；wiki-review 当 block 整体移到此位置，保留这些章节之间的原始相对顺序（不主动改它们的排序，stock-deep-dive 自己决定是否降序），不归档不动其内容
19	相关链接	wiki 自有元数据
20	信息来源	同上
21	更新记录	同上
22	历史观察（附录）	wiki-review 自建/追加，真·最后

加粗章节（2-12）是 value-invest 模板的核心，相对顺序严格不变。其余章节按上述位置排，缺则不强加。

判定：如果页面里某章节既不属于上述列表也不在命名映射表，归类为"未识别章节"，保留在原位置不动，dry-run 中由用户决策。

章节命名映射表

页面里出现以下旧名时，统一改为右列的模板标准名：

页面旧名（候选）	模板标准名
风险因素 / 主要风险 / 风险点	风险提示
当前估值 / 估值水位 / 估值分析	多模型估值（若已含模型对比）
投资逻辑 / 看多看空	投资结论（仅当含价格区间表时映射；不含表的"看多看空"列表保留为未识别章节，dry-run 询问用户）
一句话总结 / 核心结论 / 一句话	TL;DR
跟踪信号 / 短期跟踪 / 下一步关注	关键关注点
财务亮点 / 关键财务指标 / 财务全景	核心财务数据
同业比较 / 同业对照	同行对比
价格区间与操作 / 价格锚点	投资结论（合并规则见下方"合并冲突处理"）

合并冲突处理（针对"价格区间与操作 → 投资结论"等需要合并的映射）：

• 如果目标章节（投资结论）不存在 → 直接把候选段改名为标准名
• 如果目标章节存在但无价格区间表 → 把候选段的价格区间表追加到目标章节末尾
• 如果目标章节存在且已有价格区间表（结构相同） → 用候选段更新最新数据（保留最新版），删除候选段
• 如果目标章节存在且已有价格区间表（结构不同，例如锚点档位数量不一致） → 不自动合并，dry-run 中预览两个表内容请用户决策（保留哪个/手动合并）

如果遇到映射表外的差异，dry-run 中标注"建议改名 X → Y，待用户确认"。不擅自改映射表外的章节名。

内容处理矩阵

类别	信号（必须 ALL 满足）	操作
A. 被更新版本覆盖	1) 出现 v1/v2/v3 多轮迭代痕迹（"v1 估值 X"、"v2 修订为 Y"等明示文字） 2) 主体已有最新版	归档 v1/v2，保留最新版
B. 已触发的催化剂/跟踪信号	1) 含"等 X 验证"、"等 Y 披露"等表述 2) X/Y 事件已发生（页面其他章节有对应数据）	归档整段催化剂描述
C. 被新财报覆盖的旧季度数据	1) 主体已有 2026Q1（含完整营收/净利/毛利率/现金流） 2) 页面下方仍重复 2025Q3 同维度细节	归档 Q3 ⚠️ 新季度未 cover 全部维度时不归档
D. 被证伪的错误信息	1) 页面里有显式可见的"校核 note"，包含以下关键词之一："已修正" / "已删除" / "已证伪" / "校核未通过" / "口径冲突已解决"（仅有 ⚠️ emoji 不算——⚠️ 在页面里也可能用于其他警示） 或 2) 旧错数据及其证伪源都在页面里同时出现（如旧值 + 新 verified 值同框，且文字明示替代关系） 禁止仅凭 LLM 推测某数据有问题就归类为 D	直接删除： - 错误数据本身 - 包裹这条数据的整段"校核 note"（含标题、说明、bullet 项） - ⚠️ 但保留周边非校核的有效内容（如同段还有别的真实信息，只挖掉错误部分） git log 兜底
E. 仍是当前判断的内容	最新估值、当前价格区间、最新风险等	保留在主体，按 value-invest 模板顺序排列

关键区分：

• A/B/C 是"过去的有效判断"——归档，便于回看决策演化
• D 是"过去的错误"——删除，避免附录变垃圾场，git log 已能追溯
• 「历史观察」只收 A/B/C，不收 D

安全保险：D 类判定必须有 页面内显式证据（明文标注或 verified 值同框出现）。仅凭 LLM 推测"某数字看着不对" → 降级为待用户决策项，不自动删除。

归档格式

页面末尾建立或追加 ## 历史观察（附录） 章节，归档内容用 <details> 折叠：

## 历史观察（附录）

> 本章节归档已被替代或已触发完成的内容，便于回看历史决策演化。所有内容默认折叠。

<details><summary>YYYY-MM-DD v1 估值（已被 v2 替代，原因：通用自动化毛利率年报 verified 39.42% vs 估算 30%）</summary>

[原内容]

</details>

<details><summary>YYYY-MM-DD 已触发的催化剂：Q1 季报存货验证</summary>

[原内容]

</details>

summary 字段强制格式：必须以 YYYY-MM-DD 开头，紧跟归档类型（v1 / 已触发 / 季度数据等）+ 一句话原因/替代源。例：2026-04-27 v1 估值（已被 v2 替代，原因：...）。日期前缀用于自动按事件日期排序。

追加规则：

• 如果页面已有「历史观察（附录）」章节 → 新归档项插入到引导段（如有）之后、首个已有 <details> 之前（即"最新在最上"）；如果章节内没有引导段（纯 details 列表），直接插入到首个 <details> 之前；不动已有项；保留原引导段文字不覆盖
• 如果没有 → 新建在页面真·最后位置（更新记录之后），使用本节示例中的引导段文字
• 排序口径：按 summary 开头的 YYYY-MM-DD 降序排列（不是 review 当天日期）。事件日期来自被归档内容的原始时间戳（如 v1 估值的创建日、催化剂触发日、季度数据所属季度）；如果原内容里没有可识别的日期，回退到 review 当天日期
• 本次 review 只调整本次新增项的位置，不重排已有归档项的相对顺序

⚠️ 错误信息（D 类）不在归档范围——直接删除，不放入「历史观察」。

执行流程

Step 1: 读取目标页面 + 现状评估

章节边界判定：以 ^## 开头的行作为章节起始，下一个 ^## 之前的所有内容（含子标题 ### 、表格、列表、--- 分隔符）属于该章节。frontmatter（--- 包围的 YAML）+ 文档总标题（# ）不属于任何 ## 章节。

适用范围检查：先确认页面路径符合"适用范围"——如果是非 wiki/stocks/** 路径，立即退出并告知用户"本 skill 暂不支持该路径类型"。

读取 wiki 页面（用 Read 工具一次读完整全文，作为 Step 5 用 Write 整体覆盖的基线），输出：

• 总行数
• 现有章节列表（按出现顺序，列出每个 ## 标题 + 起始行号）
• frontmatter 状态（有 / 无 / updated 字段距今天数）
• 是否已存在「历史观察（附录）」章节

早期退出条件（必须同时满足以下全部才退出）：

• 页面 < 80 行
• 且 章节顺序已对齐 value-invest 模板（无"顺序错乱"项）
• 且 无命名映射差异（章节名都是模板标准名）
• 且 页面正文搜索不到以下多版本关键词：v1 估值 / v2 修订 / 前版 / 已修正 / 已删除 / 已证伪 / 校核未通过 / 口径冲突

满足以上 → 告知"页面已对齐且无过期内容，不需要 review"，停止。否则继续。

隐式"基本信息"段处理：很多页面在 H1 标题（# 公司名 (代码)）下直接列基本信息（市场/行业/市值），没有 ## 基本信息 标题。这种"隐式段"保留在原位（H1 之后、首个 ## 之前），不动不重排。如果用户希望规范化为 ## 基本信息 标题，dry-run 中标注请用户决定。

显式与隐式基本信息共存：极少数情况页面同时有"H1 下的隐式段"和"## 基本信息 显式章节"——dry-run 中标注，建议合并到显式章节，由用户确认。

Step 2: 章节对齐 dry-run

对比页面现有章节 vs value-invest 模板顺序，输出四类差异：

类型	含义	操作
🔄 顺序错乱	章节存在但位置错	重排到目标位置
✏️ 命名差异	章节名是命名映射表里的旧名	改为映射表里的标准名
➕ 模板缺章	value-invest 模板有的章节，页面缺	不主动新建，只标注"页面缺该章节，建议跑 value-invest 补充内容"。即使用户在 dry-run 阶段说"补"，wiki-review 也不补内容（不产生新分析）——回应"请用 value-invest skill 补此章节"
❓ 未识别章节	既不在模板也不在扩展列表	保留原位，dry-run 提示用户决策

特殊处理：

• ## 产品深度分析 (YYYY-MM-DD) 章节由 stock-deep-dive 输出，不重排不归档，但在重排时把所有此类章节作为一个 block 整体放到位置 17（业务结构之后、相关链接之前）

Step 3: 过期内容识别 dry-run

按"内容处理矩阵"A/B/C/D 扫描，分两个清单：

待归档清单（A/B/C）：

#	章节	内容摘要（前 60 字）	归档类型	替代源（页面里指向哪段）

待删除清单（D，错误信息）：

#	章节	内容摘要（前 60 字）	显式证据（页面里的标注/同框 verified 值）

待用户决策清单（不确定项）：

#	章节	内容摘要	困惑点

Step 4: 输出完整 Dry-Run Plan

## Wiki Review Plan: {页面路径}

### 现状
- 行数：{n}
- 章节数：{n}
- frontmatter：{有/无} {（如有）updated 距今 {n} 天}
- 「历史观察（附录）」章节：{已存在 / 不存在}

### 章节对齐（{n} 项变动）
| 章节 | 当前位置 | 目标位置 | 操作 |

### 过期内容归档（{n} 处，A/B/C 类）
| # | 章节 | 内容摘要 | 归档类型 | 折叠 summary |

### 错误信息删除（{n} 处，D 类）
| # | 章节 | 内容摘要 | 显式证据 |

### 命名修正（{n} 项，按映射表）
| 当前名 | 改为 |

### 不动的内容
- frontmatter 字段（仅更新 `updated`；缺失时不新建，等用户决定）
- 模板章节内的文字内容
- 「信息来源」章节（完全不动）
- 「更新记录」章节内容（仅在末尾追加一行 REVIEW 日志）
- ingest 数据（财报数字、历史事件、原始引用）
- stock-deep-dive 的 `## 产品深度分析 (YYYY-MM-DD)` 章节内容

### 待用户决策
- 未识别章节 {n} 处（列表）
- 模板缺章 {n} 处（列表，是否补齐）
- 不确定的 D 类候选 {n} 处（仅 LLM 推测无显式证据，建议保留）
- 重复章节 {n} 处（如两个 `## 风险提示`，列出来由用户决定合并/保留）
- 合并冲突 {n} 处（如「投资结论」与「价格区间与操作」结构不同，列出两边表内容由用户决策）
- frontmatter 缺失：{是否新建}
- 「更新记录」章节缺失：{是否新建}

---

**请回复确认或调整**，格式建议：
- "全部按 plan 执行"
- "执行重排和归档，但不动 D 类删除"（用户可选择性放弃某类操作）
- "改 X 项：{具体调整}"

> 用户可以选择性放弃某类操作（如不删 D 类只重排），但**不能改变操作类型本身**——例如不能要求"把 D 类错误信息改为归档而不是删除"，因为这违反 skill 的硬约束（D 类必删）。如有此类要求，回应"该操作违反 wiki-review 硬约束，建议手动处理"。

等用户明确确认后才进入 Step 5。如有疑议，按用户指示调整后再次输出 plan，直到用户说"执行"。

用户拒绝 plan 时：终止 skill，输出 已取消，未对 {页面路径} 做任何修改。不留下任何半成品状态。

Step 5: 执行修改

默认用 Write 整体覆盖。仅当本次改动 ≤ 3 处独立编辑点（如只有 1-2 个命名修正、无重排）时才考虑 Edit。理由：重排涉及多章节移动，多次 Edit 中间状态易出错。

Step 5.0：二次 Read 确认

再次 Read 一次目标文件，对比 Step 1 时的快照。如有变化（用户在交互期间手动改了文件、或外部 hook 修改） → 重新做 Step 2-4 dry-run，不可基于过期快照执行。

Step 5.1：构造完整新版本页面文本（基于刚 Read 的全文）

1. 先抽取每个章节的整段内容（按章节边界规则切片）
2. 检测重复章节（如页面里有两个 ## 风险提示）→ dry-run 已询问用户，按用户决策合并/保留
3. 按"完整目标章节顺序"表拼接：

   frontmatter（更新 updated）
   → 文档 H1 大标题
   → 隐式基本信息段（如有）
   → 各 ## 章节按目标顺序（执行命名映射、A/B/C 归档移出、D 类删除、合并冲突按规则处理）
   → 历史观察附录（含本次新增 + 已有，按事件日期降序）
   

4. 在拼接到「更新记录」章节时追加 REVIEW 日志行（只列出本次实际发生的操作，操作数为 0 的部分跳过）：

   - YYYY-MM-DD REVIEW {仅列实际发生项，例如：}重排 5 章节 + 归档 2 处过期内容 + 改名 1 处章节
   

   完整候选片段：重排 X 章节 / 归档 Y 处过期内容 / 删除 Z 处错误信息 / 改名 W 处章节

Step 5.2：写入文件

用 Write 工具一次性整体覆盖原文件。

Alternative：小改动场景用 Edit（仅当 ≤ 3 处独立编辑点且无章节重排时）：

• 先做命名修正（最安全）
• 再做 D 类删除（独立段落）
• 再做 A/B/C 归档（先抽出原内容，再追加到附录，最后删除原位置）
• 章节重排不要用 Edit，必用 Write

边界处理：

• frontmatter 不存在且用户同意新建 → 按 wiki 标准格式新建：tags: [...] / updated: YYYY-MM-DD
• 「更新记录」章节不存在且用户同意新建 → 按 wiki 标准格式新建（追加在「信息来源」之后、「历史观察」之前）
• 重复章节（如两个 ## 风险提示）→ 按 dry-run 用户决策合并或保留
• 「投资结论」与「价格区间与操作」并存 → 按命名映射表"合并冲突处理"规则执行

Step 6: 收尾

• chat 输出 diff summary，只列实际发生的操作（操作数 0 的项跳过）
• 提示用户用 git diff wiki/path/to/page.md 复核

与其他 skill 的边界

skill	范围	与 wiki-review 区别
value-invest	估值分析（产生新内容）	wiki-review 只整理已有内容 + 对齐其模板
stock-deep-dive	业务深度（产生新内容，带日期独立章节）	wiki-review 不动其章节，整体作为 block 放到位置 17
periodic-review	跨多个 focus 个股的市场复盘	跨页面 vs 单页面
CLAUDE.md 里的 LINT 工作流	全 wiki 健康度扫描（未具象化为 skill）	跨页面 vs 单页面

协议：value-invest 模板是 source of truth

如果未来 value-invest 模板章节顺序/命名变化，wiki-review 应跟随，而不是相反。建议在 value-invest SKILL.md 加一行注释，提醒模板修改时同步检查 wiki-review 的"Source of Truth"章节与"命名映射表"。

输出位置

直接修改原 wiki 文件。不生成独立 report 文件。