Invest Wiki Ingest

Workflow

先确保最新发布的 runtime 已安装：先运行 python3 -m pip install -U invest-wiki-runtime。然后检查 root：运行 python3 -m invest_wiki_runtime config get-root。如果返回 missing_root_config 或 invalid_root_config，先向用户确认一个绝对路径，再运行 python3 -m invest_wiki_runtime config set-root --root /absolute/path。只有这一步完成后，才进入下面的 ingest 流程。 先做输入判定：如果用户给的是公司别名、中文名或英文简称，先规范到 canonical ticker（例如“苹果”/“apple” -> AAPL）再调用 runtime；如果明显不是公司输入而是闲聊、泛话题或无关文本，先拒绝或请改写；如果公司身份有歧义，先向用户确认。runtime CLI 反馈只作为支撑，不是最终裁决。

目标是把一批新 raw 材料可靠编进 dossier/wiki，让证据先有落点，再交给 dossier 维护或后续判断页、文章页消费。

1. 识别输入范围

• 读取本次新增的 dossier/raw/**、相关 source note、dossier/checklist.md，以及可能受影响的 event/rollup。
• 先判断这批材料是在补旧 source note、形成单个事件，还是足以影响某个长期 rollup。

2. 严格先落 source note

• 新材料先写成 source note，保留来源、时间、核心事实、最小必要归纳。
• 如果已有相邻主题的 source note，优先增量补充或新建相邻 note，不要直接跳到高层页面。

3. 决定是否升级页面

• 只补新证据、还不支撑新结构：停在 source note。
• 多条 source note 指向同一事件或披露窗口：升级到 event。
• 多个事件共同改变长期主题、模式或判断框架：在 source note 完整后再更新 rollup。

4. 同步入口与日志

• dossier/checklist.md 负责让人知道事实层材料当前建档到什么状态。
• 在当前 ingest scaffold runtime 下，dossier/index.md 仍是 wiki 导航入口；新增 source note、event、rollup 后要保证入口可追踪。

5. 判断是否需要升级到 dossier

• 这次工作如果只是“把一批材料入库并补相关页”，继续留在 ingest。
• 如果已经变成全局性的页面重组、主入口重构、跨主题系统整理，应交给 invest-wiki-dossier。
• ingest 可以触发少量 dossier 入口更新，但不负责全面改造 dossier 结构。

6. 交棒给后续技能

• ingest 结束后，right-*、invest-wiki-article 等技能再消费这些 wiki 页面。
• 不允许把 ingest 当作“直接重写最终文章”的捷径；那会绕过可追踪的 wiki 演化链路。

Recommended Next Step

• 请先确认当前输入已经指向明确公司 / ticker，或者补充公司名、ticker 和对象范围。
• 如果你要我继续，我会按本 skill 的 ingest 流程先落 source note 再决定是否升级页面。
• 在你确认前，我不会继续调用 runtime 或改写页面。

Page Escalation Cheat Sheet

• 只有单批新材料：source note。
• 单个明确事件、公告、电话会、财报窗口：source note -> event。
• 跨事件主题，比如竞争格局、单位经济、管理层行为模式：source note / event -> rollup。
• 需要系统性整理 dossier 首页、分区结构、历史导航：升级到 invest-wiki-dossier，不要继续假装是 ingest。

Common Mistakes

• 只更新 event/rollup，不补 source note。
• 写了 source note，但漏掉 dossier/checklist.md 对应的事实层核对，或漏掉当前 wiki 导航入口更新。
• 把 ingest 直接做成最终文章改写，导致 wiki 层缺失。
• 本该升级到 dossier 的大范围重组，仍在 ingest 内硬做。

Guardrails

• ingest 的边界是“新增材料入库并落 wiki 页”，不是代替 dossier 做全量重组。
• 没有 source note，不要直接写 event、rollup 或更高层结论页。
• 先核对 dossier/checklist.md，再决定是否需要补当前 wiki 导航入口；不要把旧 dossier/log.md 当成 ingest 的默认真相源。
• 不允许从 raw 直接跳到 final article、公开结论稿或其它最终成品。
• 页面升级、并页、拆页都必须服从 dossier 文件规则，而不是临时自由发挥。
• 新写入的关键 Markdown 页面默认使用中文；raw/source 摘录可以保留原始语言；但 right-business.md、right-people.md、right-price.md 是明确英文例外，继续保留 # Right Business、# Right People、# Right Price 及对应英文 contract headings（例如 ## One-sentence judgment、## Core thesis）。
• runtime CLI 反馈只作为支撑，不是最终裁决。

Resources

• references/file-rules.md：source note、event、rollup、dossier/checklist.md 与当前 wiki 导航面的更新规则。