| name | wiki-review |
| description | 单个 wiki 页面"格式对齐 + 过期归档"工具。把多次更新后混乱的页面对齐到 value-invest 模板的章节顺序，并把过期内容归档到「历史观察」附录。Use when user says "review 某页面"、"整理某页面"、"归档某页面的过期内容"、"某页面格式乱了"。 |
Wiki Review Skill
定位
针对用户指定的单个 wiki 页面，做三件事：
- 对齐 value-invest 模板：保证多次更新后章节顺序与命名仍然统一
- 过期内容归档：把已被替代/已触发的内容移到「历史观察」附录
- 错误信息直接删除：被证伪的内容真删，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 的全文）
- 先抽取每个章节的整段内容（按章节边界规则切片）
- 检测重复章节（如页面里有两个
## 风险提示）→ dry-run 已询问用户，按用户决策合并/保留
- 按"完整目标章节顺序"表拼接：
frontmatter（更新 updated）
→ 文档 H1 大标题
→ 隐式基本信息段（如有）
→ 各 ## 章节按目标顺序（执行命名映射、A/B/C 归档移出、D 类删除、合并冲突按规则处理）
→ 历史观察附录（含本次新增 + 已有，按事件日期降序）
- 在拼接到「更新记录」章节时追加 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 文件。
