invest-reasearch

name	invest_reasearch
description	作为单一入口的投资研究 skill，只针对单只股票或单家公司执行完整研究，从立项、证据收集、护城河与 ROIC 分析、增长与预期差、估值与风险、JSON 校验到最终决策报告一次完成。适用于判断企业质量、持续高 ROIC 能力、当前是否错误定价，以及未来 1 到 3 年合理回报率。

Invest Reasearch Skill

触发方式

/invest_reasearch <公司名称或股票代码>

总目标

围绕单一上市公司完成一次端到端投资研究。

除非用户明确要求只做中间阶段，否则不要把流程拆成额外 skill，也不要要求用户再手动运行别的命令。

最终必须回答：

1. 这是不是长期优质企业？
2. 它是否具备持续较高的 ROIC 和现金创造能力？
3. 市场当前是否存在错误定价？
4. 未来 1 到 3 年的合理回报区间大致是多少？
5. 最终投资动作是什么？

研究原则

• 先判断商业质量、行业结构和再投资空间，再看估值。
• 优先使用最新且高质量的外部来源：财报、公告、业绩会、投资者演示、交易所披露、行业数据、可靠第三方研究。
• 明确区分 事实、市场预期、推断。
• 缺少证据支撑的内容标记为 [uncertain]。
• 每个重要结论都要给出证伪条件和跟踪指标。
• 如果当前目录已有研究产物，先检查并续跑，不要机械重做。
• 在最终下结论前，读取 references/research_checklist.md 并把它作为硬约束清单。

工作流

Step 1：确认研究范围

确认或合理推断出形成投资结论所需的最小输入：

• 公司名称
• ticker、交易所、记账货币
• 希望覆盖的时间范围
• 最低可接受回报率或收益门槛

如果当前目录已经有 outline.yaml、fields.yaml、module-results/、results/ 或 report.md，先读取它们，再决定是续跑、局部刷新还是整体重做。

Step 2：生成或刷新研究计划

创建或更新 {company_slug}/outline.yaml 和 {company_slug}/fields.yaml。

outline.yaml 至少包含：

• topic
• target_company
• ticker
• research_type: invest_reasearch_stock
• core_questions
• key_variables
• source_priority
• modules
• execution

modules 应覆盖：

• industry
• moat
• financial
• growth
• expectation
• valuation
• risk
• investment_committee

execution 至少包含：

• time_range
• return_hurdle
• output_dir
• module_dir
• final_decision_options

fields.yaml 应定义以下类别：

• 研究框架
• 行业结构
• 护城河与质量
• 财务与现金流
• 增长驱动
• 市场预期
• 估值与回报
• 风险与证伪
• 最终结论

每个字段定义至少包含：

• name
• description
• detail_level

并始终保留 uncertain 字段。

Step 3：收集证据并完成模块分析

通过联网检索和原始资料阅读收集证据。若宿主支持并行助手，就按模块拆分；否则顺序执行，但保持同样的模块结构。

把模块笔记写入：

{company_slug}/module-results/
  industry.md
  moat.md
  financial.md
  growth.md
  expectation.md
  valuation.md
  risk.md

每个模块笔记都必须以这四部分收尾：

• 关键事实
• 核心解释
• 未决问题
• 证伪点

Step 4：合并结构化结果并校验

读取全部模块笔记，合并成一个结构化 JSON：

{company_slug}/results/{target_company_slug}.json

规则：

• JSON 必须和 fields.yaml 对齐
• 保留 uncertain 数组，列出尚未解决的字段
• 不要悄悄省略缺失模块
• 明确区分证据和判断

写完 JSON 后，运行与本 skill 同目录的 validate_json.py 进行校验。持续修正覆盖缺口，直到校验通过，或者可以明确说明阻塞原因。

Step 5：生成最终投资决策报告

生成 {company_slug}/report.md。只有在“后续会重复刷新同一份报告”时，才额外生成 generate_report.py；否则直接写 report.md 即可。

报告至少包含：

• 一句话核心结论
• 商业质量与护城河总结
• ROIC、现金流与增长总结
• 市场预期差
• Bear / Base / Bull 三情景表
• 关键风险与证伪点
• 跟踪清单
• 最终投资结论

最终结论只能四选一：

• 明显低估（重仓）
• 结构机会（跟踪）
• 合理估值（观望）
• 明显高估（回避）

Step 6：向用户返回结果

先给出最终投资判断，再指出保存下来的产物路径。如果把握度不足，要具体说明还缺哪类证据。

输出结构

{current_working_directory}/{company_slug}/
  outline.yaml
  fields.yaml
  module-results/
  results/{target_company_slug}.json
  generate_report.py   # 可选
  report.md