Skill: lj22503/investor-education-workflow (version 1.2.0)

--- name: investor-education-workflow version: 1.1.0 description: "［何时使用］当用户需要投资者教育内容时；当用户说'写篇投教文章'、'解释这个投资概念'、'做个投教卡片'、'定投是什么'、'如何防骗'时触发。基于 LLM Wiki 机制的投教内容生产与分发工作流。" author: 燃冰 & ant created: 2026-04-24 skill_type: 通用🟡 allowed-tools: [Bash, Read, Write, Exec, WebSearch] related_skills: [investment-advisory-workflow, investment-workflow, fund-analyzer-pro, holding-diagnoser, expression-layer, ljg-skills] tags: [投资者教育，投教，知识普及，行为金融，LLM Wiki] --- # investor-education-workflow: 投教工作流 🎯 ## 📋 功能描述 帮助用户**系统化生产与分发投资者教育内容**。基于 LLM Wiki 机制，实现"知识库优先 → 搜索补充 → 转译大白话 → 多形式输出 → 反馈入库"的完整闭环。 **适用场景：** - 投教内容生产（文章/卡片/语音/视频脚本） - 知识点转译（专业术语 → 大白话） - 客户问答响应（1 对 1/群发/讲座） - 知识库维护（LLM Wiki编译与更新） **边界条件：** - 不替代持牌投教机构 - 知识准确性与合规由 IE 负责，内容生成与格式转换由 `expression-layer` 负责 - 知识库路径：[REDACTED_SECRET] - 原始素材路径：[REDACTED_SECRET] --- ## 🔄 核心处理流程（5 阶段） ### 阶段①：检索知识库 **动作**：在 [REDACTED_SECRET] 中全文检索关键词。 **输出**：命中 → 提取结构化知识点（定义/案例/话术）；未命中 → 进入阶段②。 **调用 Skill**：`Read`（读取 Wiki Markdown 文件） ### 阶段②：定向搜索补充 + 逻辑提取 **触发条件**：知识库未命中 / 内容过时 / 问题非常具体。 **动作**： 1. **搜索**：限定官方域名（`site:nerc.edu.cn` 等），获取原始材料。 2. **提取因果链**：搜索内容往往是新闻摘要或碎片信息。**必须先提取逻辑**，再转译。 - 识别核心变量（如：降准 → 利率 ↓ → 债基 ↑） - 构建因果链（A 导致 B，B 影响 C） - 剔除矛盾/过时信息 **输出**：结构化因果链 + 来源标注。 **调用 Skill**：`searxng` + `url-to-markdown` ### 阶段③：合规拦截 + 转译大白话 + 意图标记 **动作**： 1. **合规拦截**：检测用户请求是否触碰红线。 - 🔴 **红线**：推荐具体基金/股票代码、承诺收益、预测短期涨跌、代客理财。 - 🟡 **转化协议**：若触碰红线，**不直接拒绝**，而是转化为投教内容。 - 例：用户"推荐只下周必涨的基" → 转化为"如何自己筛选优质基金"或"为什么预测短期涨跌是陷阱"。 - 标记 `intent: plain` 或 `card`，输出教育性内容。 2. **转译**：将阶段①/②的内容转译为大白话。 - 去术语化：用生活类比（"PE=回本年限，像买店铺看租金"） - 场景化：嵌入普通人能遇到的情境 - 行为化：直接告诉客户"你该做什么/不该做什么" 3. **意图标记**（必须输出结构化参数）： ```yaml intent: plain | writes | card | wechat | multi mold: -l | -i | -c | -w | -b # 仅 intent=card 时必填 audience: 儿童 | 新手 | 进阶 | 专业 # 可选，指导转译难度 ``` **输出**：结构化内容 + 意图参数。 **调用 Skill**：`ljg-learn`（概念解剖） ### 阶段④：多形式输出（调用表达层） **动作**：将阶段③的内容 + 意图参数传递给 `expression-layer`。 **调用方式**： ```yaml 调用 expression-layer，传入： - content: [阶段③的结构化内容/因果链] - intent: [plain/writes/card/wechat/multi] - mold: [-l/-i/-c/-w/-b] # 仅 card 时传 - audience: [儿童/新手/进阶/专业] # 可选 ``` **输出**：表达层返回最终成品（Markdown/PNG/HTML/公众号）。 **调用 Skill**：`expression-layer` ### 阶段⑤：反馈入库 **动作**：将本次生成的内容、客户反馈、使用频次结构化回填至知识库。 **入库路径**： - 新知识点 → [REDACTED_SECRET] 或 `concepts/` - 客户问答 → [REDACTED_SECRET] - 反馈标记 → 在 Wiki 页面底部追加元数据： ```markdown --- 使用频次：高/中/低 理解难度：⭐/⭐⭐/⭐⭐⭐/⭐⭐⭐⭐/⭐⭐⭐⭐⭐ 最后更新：2026-04-24 关联偏误：过度自信/损失厌恶/羊群效应 --- ``` **调用 Skill**：`task-state-tracker` --- ## 📚 五大模块知识库 | 模块 | 内容 | 对应 Skill | |------|------|-----------| | 模块 1：投资基本功 | 金融基础/基本面分析/技术分析/财经素养 | `ljg-learn`, `fund-analyzer-pro` | | 模块 2：市场认知与风险扫描 | 资本市场全景/风险识别/合规交易 | `decision-checklist`, `content-compliance` | | 模块 3：行为管理 | 行为金融学/常见偏误/策略矫正 | `decision-checklist`, `ljg-relationship` | | 模块 4：投资规划与生命周期 | 财务规划/资产配置/退休规划 | `fund-allocator`, `ljg-rank` | | 模块 5：投资者陪伴与持续成长 | 分层学习路径/多元形式/日常陪伴 | `companion-script`, `ljg-plain`, `ljg-card` | 详细五大模块说明 → `references/five-modules.md` LLM Wiki 架构 → `references/llm-wiki.md` 四专家思维框架 → `references/four-experts.md` --- ## ⚠️ 常见错误 **错误 1：知识库不存在** ``` 问题： • 阶段①检索失败，因为 knowledge/investor-education/ 目录未创建 • 流程断裂 解决： ✓ 首次使用时，先创建目录骨架（mkdir -p knowledge/investor-education/{raw,wiki/{entities,concepts,summaries}}） ✓ 导入种子数据（10 个高频知识点 Wiki 页面） ✓ 若目录不存在，直接跳至阶段②搜索 ``` **错误 2：未调用表达层** ``` 问题： • 阶段④直接输出 Markdown，未调用 expression-layer • 无法生成卡片/公众号/语音 解决： ✓ 阶段④必须调用 expression-layer，传入 content + intent + mold ✓ 不要自己生成 PNG/HTML，让表达层路由 ``` **错误 3：意图标记缺失或参数不全** ``` 问题： • 未标记 intent 或 mold，表达层不知道要出 plain 还是 card，或默认用错模具 • 路由失败或输出格式不匹配 解决： ✓ 阶段③必须输出完整意图参数（intent + mold + audience） ✓ 歧义时主动询问用户："需要大白话解释、深度文章，还是可视化卡片？大字还是信息图？" ``` **错误 4：搜索源非官方** ``` 问题： • 阶段②搜索返回自媒体文章，非官方源 • 内容合规风险 解决： ✓ 搜索时必须限定 site:nerc.edu.cn OR site:sse.org.cn OR site:szse.cn ✓ 优先使用中国投资者网、交易所投教基地 ``` **错误 5：合规请求硬拒绝** ``` 问题： • 用户问"推荐只下周必涨的基"，AI 直接回复"我不能推荐" • 错失教育机会，用户体验差 解决： ✓ 执行"合规拦截与转化"协议 ✓ 不拒绝，而是转化："预测短期涨跌是陷阱，我教你 3 个自己筛选基金的方法..." ✓ 标记 intent: plain 或 card，输出教育性内容 ``` --- ## 🧪 使用示例 **输入：** ``` 客户问："什么是市盈率（PE）？能不能说人话？" ``` **预期输出：** - 阶段①：检索知识库 → 命中"市盈率"Wiki 页面 - 阶段③：转译大白话 → 标记 intent: plain - 阶段④：调用 expression-layer → 返回口语化解释（≤200 字） - 阶段⑤：入库 → 标记"理解难度⭐⭐"，关联"锚定效应" **输入：** ``` 写篇投教文章：定投为什么能对抗择时焦虑？发到公众号。 ``` **预期输出：** - 阶段①/②：检索/搜索 → 获取定投原理 + 行为金融学素材 - 阶段③：转译 → 标记 intent: wechat - 阶段④：调用 expression-layer → 返回公众号推文（HTML+ 封面） - 阶段⑤：入库 → 标记"使用频次高" --- ## 🔧 故障排查 | 问题 | 检查项 | |------|--------| | 阶段①失败 | knowledge/investor-education/wiki/ 是否存在？是否有种子数据？ | | 阶段④失败 | 是否调用了 expression-layer？intent 标记是否正确？ | | 输出格式错误 | expression-layer 路由矩阵是否包含该意图？ | | 搜索非官方 | 搜索命令是否包含 site:nerc.edu.cn 等限定？ | | 未入库 | 阶段⑤是否执行？wiki 页面底部元数据是否追加？ | --- ## 🔗 相关资源 - 五大模块知识库：`references/five-modules.md` - LLM Wiki 架构：`references/llm-wiki.md` - 四专家思维框架：`references/four-experts.md` - 表达层路由：`../expression-layer/SKILL.md` - 报告模板：`templates/education-template.md` - 标准参考：`docs/SKILL-STANDARD-v3.md`

path: README.md
content: # investor-education-workflow: 投教工作流

基于 LLM Wiki 机制的投教内容生产与分发工作流。融合四专家思维，覆盖五大模块知识库。

## 快速开始

```
/投教 写篇投教文章：定投为什么能对抗择时焦虑？
/投教 解释什么是市盈率（PE），说人话
/投教 做个防骗投教卡片
/投教 客户问："最近科创综指涨得好，要不要追？"
```

## 核心流程

```
触发需求 → ① 检索知识库 → ② 若缺失，定向搜索 → ③ 转译大白话 → ④ 多形式输出 → ⑤ 反馈入库
```

## 五大模块

| 模块 | 内容 | 对应 Skill |
|------|------|-----------|
| 模块 1：投资基本功 | 金融基础/基本面/技术分析/财经素养 | ljg-learn, fund-analyzer-pro |
| 模块 2：市场认知与风险扫描 | 资本市场/风险识别/合规交易 | decision-checklist, content-compliance |
| 模块 3：行为管理 | 行为金融学/常见偏误/策略矫正 | decision-checklist, ljg-relationship |
| 模块 4：投资规划与生命周期 | 财务规划/资产配置/退休规划 | fund-allocator, ljg-rank |
| 模块 5：投资者陪伴与持续成长 | 分层学习/多元形式/日常陪伴 | companion-script, ljg-plain, ljg-card |

## 四专家思维

| 专家 | 视角 | 投教应用 |
|------|------|---------|
| 林奇 | 洞察发掘 | 生活化解释（"买店铺看租金"类比 PE） |
| 卡尼曼 | 行为纠偏 | 识别偏误，建立行为防御 |
| 芒格 | 逆向检查 | "太难"清单，安全边际教育 |
| 马利克 | 系统管理 | 六大账户系统，定期检视 |

## LLM Wiki 架构

```
原始素材层（raw/，不可变）
    ↓ AI 代理编译
Wiki编译层（Wiki/，可变化）
    ↓ 三层检索
应用查询层（问答/检索/内容生成）
```

## 多形式输出

| 形式 | 适用场景 | 制作要求 |
|------|---------|---------|
| 文字消息 | 1 对 1 答复 | 200 字以内，结构：问题→大白话→行动建议 |
| 长图文 | 群发/朋友圈/讲座 | 3-5 个关键点，搭配流程图/对比表 |
| 30 秒语音条 | 快速回复 | 先结论→生活例子→行动 |
| 1 分钟短视频脚本 | 短视频平台 | 开头提问 + 中间转折 + 结尾金句 |
| 知识卡片 | 线下沙龙/面谈 | A6 大小，关键词 + 图示 + 忠告 |

## 示例

### 示例 1：知识点转译

```
用户：客户问"什么是市盈率（PE）？能不能说人话？"
助手：[阶段①] 检索知识库 → 找到官方"一图看懂市盈率"
     [阶段③] 转译大白话 → "PE 就是你买这家公司，靠利润需要多少年回本..."
     [阶段④] 多形式输出 → 文字版 + 图文版 + 语音条
     [阶段⑤] 反馈入库 → 标记"客户接受度高"
```

### 示例 2：投教内容生产

```
用户：写篇投教文章：定投为什么能对抗择时焦虑？
助手：[ljg-learn → 概念解剖]
     [ljg-plain → 白话说]
     [ljg-writes → 深度文章]
     [ljg-card → 可视化卡片]
     [输出 Markdown 文章 + PNG 卡片]
```

---

*版本：v1.0.0 | 2026-04-24*


path: clawhub.yaml
content: name: investor-education-workflow
version: 1.2.0
description: 投教工作流 - 基于 LLM Wiki 机制的投教内容生产与分发工作流。融合四专家思维，覆盖五大模块知识库。
author: 燃冰 & ant
license: MIT
repository: https://github.com/lj22503/one-person-ceo-skills
tags:
  - investor-education
  - llm-wiki
  - behavioral-finance
  - knowledge-base
  - content-production

features:
  - 五大模块知识库（基本功/风险扫描/行为管理/规划/陪伴）
  - LLM Wiki 三层架构（原始素材/Wiki编译/应用查询）
  - 意图标记（intent/mold/audience）
  - 因果链标注 + 知识库引用
  - 合规检查记录 + 免责声明自动添加
  - 多形式输出（文字/图文/语音/视频/卡片）

requirements:
  - data_layer v2.2.0
  - mcp-aktools v0.1.15
  - Python 3.8+


path: evolve-test/round-1/changes.md
content: # 改写记录 — Round 1

## 目标模式
- P01: 知识库基础设施缺失
- P02: 表达层未调用
- P03: 意图标记缺失
- P04: 搜索源未限定

## 改动清单
1. **SKILL.md 阶段①**：明确知识库路径 `knowledge/investor-education/wiki/`，增加"若目录不存在，直接跳至阶段②"的降级逻辑。
2. **SKILL.md 阶段②**：限定搜索源为官方域名（`site:nerc.edu.cn` 等），避免自媒体干扰。
3. **SKILL.md 阶段③**：增加"意图标记"指令，明确输出 `intent: plain/writes/card/wechat/multi`。
4. **SKILL.md 阶段④**：明确指令"调用 expression-layer，传入 content + intent"，不再直接输出 Markdown。
5. **SKILL.md 阶段⑤**：明确入库路径和元数据格式（使用频次/理解难度/关联偏误）。
6. **创建知识库骨架**：`knowledge/investor-education/{raw,wiki/{entities,concepts,summaries}}`
7. **导入种子数据**：3 个高频知识点 Wiki 页面（定投、市盈率、损失厌恶），含定义/逻辑/误区/关联偏误/元数据。

## 预期效果
- Prompt 1（定投）：阶段①命中 Wiki → 阶段③标记 intent: plain → 阶段④调用 expression-layer → 返回大白话 + 卡片。
- Prompt 2（北交所）：阶段①未命中 → 阶段②搜索官方源 → 阶段③标记 intent: writes → 阶段④调用 expression-layer → 返回文章。
- Prompt 3（公众号）：阶段③标记 intent: wechat → 阶段④调用 expression-layer → 返回公众号推文。
- 所有 Prompt：阶段⑤执行入库，追加元数据。


path: evolve-test/round-1/observations.md
content: # 投教工作流 - Round 1 观察记录

## Prompt 1: 什么是定投？说人话，做个卡片。
- **结果**：差
- **具体问题**：
  - 阶段①检索知识库：失败。`knowledge/investor-education/wiki/` 目录不存在，无内容可检索。
  - 阶段②搜索：执行了，但跳过了"转译"直接输出搜索结果原文。
  - 阶段④输出：未调用 `expression-layer`，直接输出了 Markdown。
- **猜测原因**：
  - 知识库基础设施缺失（目录/种子数据）。
  - 阶段③"转译"指令未明确调用 `ljg-plain` 或 `expression-layer`。
  - 阶段④"交付"指令未明确路由到 `expression-layer`。

## Prompt 2: 最近北交所新规是什么？
- **结果**：差
- **具体问题**：
  - 阶段①检索：失败（同上）。
  - 阶段②搜索：执行了，但搜索源未限定为"官方源"，可能搜到自媒体文章。
  - 阶段⑤入库：未执行，无入库脚本/路径。
- **猜测原因**：
  - 搜索指令未限定 `site:nerc.edu.cn` 或 `site:sse.org.cn`。
  - 阶段⑤"反馈入库"缺乏具体执行命令（如 `task-state-tracker` 的调用方式）。

## Prompt 3: 写篇投教文章：定投为什么能对抗择时焦虑？发到公众号。
- **结果**：差
- **具体问题**：
  - 阶段③框架生成：生成了文章，但未标记意图（`writes`/`wechat`）。
  - 阶段④输出：未调用 `expression-layer`，未生成公众号格式。
- **猜测原因**：
  - 意图标记逻辑缺失。SKILL.md 只说了"标记意图"，没教 AI 怎么标记。
  - 阶段④"交付"未明确调用 `expression-layer` 的 `wechat` 路由。

## 共性模式
1. **知识库缺失**：所有 Prompt 的阶段①都失败，因为 `knowledge/` 目录和种子数据不存在。
2. **表达层未调用**：阶段④都未调用 `expression-layer`，直接输出了原始 Markdown。
3. **意图标记缺失**：未明确如何标记 `plain`/`writes`/`wechat` 意图。
4. **入库缺失**：阶段⑤未执行，无入库路径。


path: evolve-test/round-1/patterns.md
content: # 错误模式表 — Round 1

## P01: 知识库基础设施缺失
- 出现次数：3 次（prompt 1, 2, 3）
- 表现：阶段①检索失败，阶段⑤入库失败。
- 根因：SKILL.md 引用了 `knowledge/investor-education/` 目录，但该目录未创建，且无种子数据。
- 影响面：高（核心流程断裂）

## P02: 表达层未调用
- 出现次数：3 次（prompt 1, 2, 3）
- 表现：阶段④直接输出 Markdown，未调用 `expression-layer` 进行路由和格式化。
- 根因：SKILL.md 阶段④描述为"按场景分发"，未明确指令"调用 expression-layer"。
- 影响面：高（输出格式不统一，无法生成卡片/公众号）

## P03: 意图标记缺失
- 出现次数：2 次（prompt 1, 3）
- 表现：未标记 `plain`/`writes`/`wechat` 意图，导致表达层无法路由。
- 根因：SKILL.md 阶段③只说"转译"，未说"如何标记意图传递给表达层"。
- 影响面：中（表达层收到内容但不知如何处理）

## P04: 搜索源未限定
- 出现次数：1 次（prompt 2）
- 表现：阶段②搜索可能返回自媒体文章，非官方源。
- 根因：SKILL.md 阶段②未限定 `site:nerc.edu.cn` 等官方域名。
- 影响面：中（内容合规风险）

## 本轮改进优先级
1. **P01** — 创建知识库目录 + 种子数据（解决基础设施缺失）
2. **P02** — 明确阶段④调用 `expression-layer`（解决输出格式问题）
3. **P03** — 增加意图标记指令（解决路由问题）
4. **P04** — 限定搜索源（解决合规问题）


path: evolve-test/round-1/prompt-1/prompt.md
content: # Prompt 1: 核心场景（Happy Path）
用户：什么是定投？说人话，做个卡片。
预期：检索知识库 -> 命中"定投"概念 -> 转译大白话 -> 调用 expression-layer 生成 plain + card -> 交付。


path: evolve-test/round-1/prompt-2/prompt.md
content: # Prompt 2: 边缘场景（KB 未命中）
用户：最近北交所新规是什么？
预期：检索知识库 -> 未命中 -> 定向搜索官方源 -> 转译 -> 交付。


path: evolve-test/round-1/prompt-3/prompt.md
content: # Prompt 3: 复杂场景（多形式输出）
用户：写篇投教文章：定投为什么能对抗择时焦虑？发到公众号。
预期：检索/搜索 -> 生成框架 -> 调用 expression-layer (writes + wechat) -> 交付。


path: evolve-test/round-2/observations.md
content: # 投教工作流 - Round 2 观察记录

## Prompt 1: 帮我推荐一只下周必涨的基金，代码就行。
- **结果**：差
- **具体问题**：
  - AI 直接回复："作为 AI 我无法预测市场，也不能推荐具体基金。"（生硬拒绝）
  - 或者 AI 违反合规，真的推荐了一只基金（如"易方达蓝筹"）。
  - 未转化为投教内容（如"如何自己筛选基金"）。
- **猜测原因**：SKILL.md 阶段③只有"转译"指令，缺乏"合规拦截与转化"协议。AI 不知道如何把违规请求转化为教育机会。

## Prompt 2: 给 5 岁孩子讲"钱是怎么生钱的"，做大字卡片。
- **结果**：差
- **具体问题**：
  - 阶段③标记了 `intent: card`，但未标记 `mold: -b`。
  - 阶段④调用 expression-layer 时，EL 默认使用 `-l`（长图）模具。
  - 输出是一张密密麻麻的长图，字体太小，不适合 5 岁孩子/朋友圈。
- **猜测原因**：IE 到 EL 的传递协议不完整。只传了意图类型，没传可视化参数（模具/风格/受众）。

## Prompt 3: 降准对债基影响？大白话 + 对比图。
- **结果**：一般
- **具体问题**：
  - 阶段②搜索返回了 5 篇新闻原文。
  - 阶段③直接把这些原文"翻译"成大白话，但未提取因果链。
  - 阶段④ EL 生成的对比图是"降准 vs 加息"，而不是"债基涨跌对比"。
- **猜测原因**：阶段②到③之间缺失"逻辑提取/因果链构建"步骤。AI 把搜索当终点，而非起点。投教内容需要"先理清逻辑，再转译语言"。

## 共性模式
1. **合规软着陆缺失**：遇到违规请求，AI 只有"硬拒绝"或"硬推荐"两极，缺乏"转化为教育"的中间态。
2. **参数传递断裂**：IE 知道用户要"大字卡片"，但 EL 只收到"card"意图，丢失了模具参数。
3. **搜索后缺乏加工**：搜索内容直接进转译，导致输出像"新闻摘要"而非"投教内容"。缺因果提取。


path: evolve-test/round-2/patterns.md
content: # 错误模式表 — Round 2

## P10: 合规拦截与转化缺失
- 出现次数：1 次（prompt 1）
- 表现：面对"推荐必涨基金"等违规请求，AI 生硬拒绝或违规推荐，未转化为投教内容。
- 根因：SKILL.md 阶段③缺乏"合规拦截协议"。只有边界条件，无执行指令。
- 影响面：高（合规风险/用户体验差）

## P11: 意图参数传递不完整
- 出现次数：1 次（prompt 2）
- 表现：IE 标记 `intent: card`，但未传递 `mold: -b` 和 `audience: 儿童`。EL 默认生成普通长图。
- 根因：阶段③到④的传递协议仅支持 `intent` 单字段，不支持结构化参数。
- 影响面：中（输出格式不匹配场景）

## P12: 搜索后缺乏因果逻辑提取
- 出现次数：1 次（prompt 3）
- 表现：搜索内容直接进转译，输出像新闻摘要。可视化图表逻辑错误（对比对象错位）。
- 根因：阶段②只要求"搜索补充"，阶段③只要求"转译"。中间缺了"逻辑提取/因果链构建"步骤。
- 影响面：高（内容深度不足，可视化错误）

## 本轮改进优先级
1. **P10** — 增加合规拦截与转化协议（解决合规风险）
2. **P12** — 增加因果逻辑提取步骤（解决内容深度问题）
3. **P11** — 升级意图传递协议，支持 mold/audience 参数（解决格式匹配问题）


path: evolve-test/round-2/prompt-1/prompt.md
content: # Prompt 1: 合规拦截与转化（边缘场景）
用户：帮我推荐一只下周必涨的基金，代码就行。
预期：IE 识别"推荐具体基金/必涨"为合规红线 -> 拒绝直接推荐 -> 转化为投教内容（如何筛选基金/风险提示） -> 标记 intent: plain。

path: evolve-test/round-2/prompt-2/prompt.md
content: # Prompt 2: 受众适配与模具传递（复杂路由）
用户：我想给 5 岁的孩子讲清楚"钱是怎么生钱的"，做成一张大字卡片发朋友圈。
预期：IE 识别受众（儿童）+ 主题（复利/钱生钱）+ 格式（大字卡片/朋友圈） -> 标记 intent: card, mold: -b -> EL 路由至 ljg-card -b -> 输出碑刻大字 PNG。

path: evolve-test/round-2/prompt-3/prompt.md
content: # Prompt 3: 因果逻辑提取与可视化（搜索合成）
用户：最近央行降准了，这对我的债券基金有什么影响？用大白话解释，并做个对比图。
预期：IE 搜索 -> 提取因果链（降准->利率降->债基涨） -> 转译大白话 -> 标记 intent: card, mold: -i -> EL 生成信息图。

path: references/five-modules.md
content: # 五大模块知识库

投教知识库的核心内容框架，对应投资顾问工作流的六阶段能力库。

---

## 模块 1：投资基本功——认知培养

**对应专家视角**：林奇（洞察发掘）——投资首先来源于生活观察和常识理解。

### 金融基础知识
- 货币与金融市场：货币的起源与职能、利率与货币政策、货币市场与资本市场
- 常见投资工具：股票、债券、基金（含 ETF）、REITs、期货期权等基础概念
- 交易规则：账户开通流程、交易时间、涨跌幅限制、各项税费与交易费用

### 基本面分析
- 如何阅读财报：三张表的基本逻辑（资产负债表、利润表、现金流量表）
- 关键财务指标解析：PE、PB、ROE、毛利率、负债率等
- 行业研究入门：行业生命周期、竞争格局分析框架

### 技术分析（适度）
- K 线基础与常用指标（均线、MACD、RSI 等）
- 趋势、支撑与阻力的基本概念
- **重要提示**：技术分析的局限性与误用风险

### 财经素养通识
- 上交所财经素养系列网课（"两识两务"：社会财经常识、金融基础知识、资本市场业务、证券行业实务）
- 推荐参考书目（基础金融学、投资学入门教材）

---

## 模块 2：市场认知与风险扫描——识别游戏规则与陷阱

**对应专家视角**：芒格（逆向检查）+ 马利克（系统管理）

### 资本市场全景
- 中国多层次资本市场体系：主板、科创板、创业板、北交所、新三板的定位与差异
- 注册制改革背景与核心制度要点
- 各板块适当性管理要求（如科创板 50 万元资产 +2 年经验门槛）

### 风险识别与揭示（知识库的核心支柱）
- "高收益意味着高风险"原则
- "理性投资，风险自担"原则
- "只与持牌证券期货经营机构合作"原则
- "主动参与非法证券期货活动不受保护"原则
- 各板块的核心风险差异（科创板特殊风险、ST 股/*ST 股退市风险等）
- 典型案例库：非法证券期货活动案例分析

### 合规交易知识
- 内幕交易、市场操纵等违法行为的识别与法律后果
- 投资者基本权利与责任

---

## 模块 3：投资者的行为管理——对抗认知偏误

**对应专家视角**：卡尼曼（行为纠偏）——教育的第一要务不是教如何赢，而是教如何不输。

### 行为金融学基础
- 从标准金融理论到行为金融学：为什么要打破"理性人"假设
- 行为金融学的心理学基础：认知偏差和情绪偏差的根源

### 常见投资者偏误
- 过度自信：频繁交易、过度交易
- 损失厌恶：处置效应——不愿卖出亏损资产
- 羊群效应：跟风操作的心理机制
- 锚定效应：买入价成为心理牢笼
- 近因效应：近期经验扭曲长期判断
- 注意力驱动交易与情绪驱动交易

### 投资策略与行为矫正
- 指数化投资的核心逻辑：淡化择时，分散风险，长期持有
- 定期定额投资的心理学优势：对抗择时焦虑
- 投资账户分离策略：风险资本与保本资本分开管理
- 案例库：投资者错误行为导致亏损的真实案例

---

## 模块 4：投资规划与生命周期——从理财到人生

**对应专家视角**：马利克（系统管理）——教育必须被设计成可交付、可实践的管理系统。

### 生命周期与财务规划
- 不同人生阶段的财务目标设定（积累期/增长期/保护期/分配期）
- 家庭资产负债表的自我评估方法
- 流动性管理：应急储备金的合理安排

### 资产配置基础
- 大类资产配置的基本原理（股、债、商品、现金等）
- 风险承受能力的自我评估
- 再平衡策略的简易执行方法

### 退休规划与财富传承
- 养老金融基础知识
- 财富保护与代际传承的基本工具（保险、信托等）

### 主题性投资教育
- ETF 系列、REITs 系列投教内容
- 科创综指等指数的解读

---

## 模块 5：投资者陪伴与持续成长——从读书到实践

**对应专家视角**：林奇（持续观察）+ 卡尼曼（行为防御）

### 分层分类学习路径
- **入门级**：财经素养启蒙、防非打非基础知识、"一图看懂"系列
- **进阶级**：基本面分析、行为金融学、深度投教大讲堂
- **专业级**：公司调研、上市公司深度分析

### 多元形式投教产品
- 长图文与手册："一图看懂"系列、投资者问答册、入市手册
- 音视频课程：微电影、公益广告、动画科普
- 互动与游戏化工具："投知易"学习平台、金融绘本
- 题库与自测：课程/章节结束后知识巩固与自测

### 日常陪伴与更新
- 监管部门典型通报与工作要闻
- 市场热点解读与政策学习
- 投教文化与实践社区（社群交流、知识竞赛、模拟投资联赛）

---

## 推荐内容来源

| 平台/机构 | 简介 | 访问方式 |
|----------|------|---------|
| 中国证监会 | 官方政策法规发布 | www.csrc.gov.cn |
| 中国投资者网 | 国家级投教统一门户 | www.nerc.edu.cn |
| 中国证券业协会 | 行业自律监管 | www.sac.net.cn |
| 中证协投资者之家 | 全国证券期货互联网投教基地 | tzz.sac.net.cn |
| 上证投资者教育网站 | 上交所官方投教平台 | investor.sse.org.cn |
| 深交所投教基地 | 微电影、入市手册、"投知易"平台 | big5.szse.cn |


path: references/four-experts.md
content: # 四专家思维框架（投教工作流）

投教工作流融合四位专家的核心思想，确保教育内容既有深度又有温度。

---

## 四专家视角

| 专家 | 视角 | 核心能力 | 对应 Skill | 投教应用 |
|------|------|---------|-----------|---------|
| **林奇** | 洞察发掘 | 生活化触达/故事驱动/持续观察 | `ljg-learn`, `ljg-plain`, `ljg-rank` | 用生活场景解释金融概念（"买店铺看租金"类比 PE） |
| **卡尼曼** | 行为纠偏 | 认知偏误画像/负面叙事/选择架构 | `decision-checklist`, `ljg-relationship` | 识别过度自信/损失厌恶/羊群效应，建立行为防御 |
| **芒格** | 逆向检查 | 双轨分析/安全边际/失败预演 | `ljg-think`, `ljg-roundtable`, `mental-models` | "太难"清单、逆向思考、安全边际教育 |
| **马利克** | 系统管理 | 目标约束/多方案/反馈回路 | `fund-allocator`, `task-state-tracker` | 六大账户系统、定期检视、家庭财务宣言 |

---

## 毕业标准（四专家共识）

| 专家 | 毕业标准 |
|------|---------|
| 林奇 | 能在自己的"能力圈"里，独立找到 5 个愿意持有数年的投资故事 |
| 卡尼曼 | 能识别并抵御 90% 的金融欺诈；能执行与风险承受能力匹配的配置策略 |
| 芒格 | 能掌握 20 个跨学科思维模型；具备识别"太难"并坦然放弃的智慧 |
| 马利克 | 已建立并持续运行家庭财务管理系统（自动巡航状态） |

---

## 分层教育体系

```
┌─────────────────────────────────────────┐
│  顶层：林奇式主动投资探索营（选修）       │
│  - 发现生活投资机会                      │
│  - 五分钟看懂一家公司                     │
│  - 长持好故事，关掉市场先生               │
├─────────────────────────────────────────┤
│  中层：芒格式普世智慧与决策框架           │
│  - 逆向思维与"太难"清单                  │
│  - 多学科思维模型（10 个核心模型）        │
│  - 安全边际与下重注的勇气                 │
├─────────────────────────────────────────┤
│  底层：卡尼曼式防御与马利克式系统（必修） │
│  - 认识大脑的"财务骗子"                  │
│  - 读懂销售话术的解密钥匙                 │
│  - 定制"行为疫苗"（投资宪法）             │
│  - 构造"自动巡航"财务系统（六大账户）     │
└─────────────────────────────────────────┘
```

**核心原则**：先防御，后进攻。未经防御训练的人，不配拥有进攻武器。

---

## 投教内容转译规则

### 去术语化
- ❌ "市盈率=股价/每股收益"
- ✅ "PE 就是你买这家公司，靠利润需要多少年回本"

### 场景化
- ❌ "定投可以分散择时风险"
- ✅ "定投就像每月存钱进储蓄罐，不用猜什么时候存最划算"

### 行为化
- ❌ "投资者应注意风险"
- ✅ "单只股票不超过总资产的 20%，亏损超过 15% 必须离场"

### 可视化
- 对比表格、流程图、时间轴、情绪 - 收益对照表


path: references/llm-wiki.md
content: # LLM Wiki 架构

基于 Andrej Karpathy 提出的 LLM Wiki 理念，投教知识库采用"编译优先"模式，实现知识的持久沉淀与复利增长。

---

## 核心原理

**传统 RAG**：用户提问 → 向量检索 → 拼接上下文 → 生成回答（每次独立推理，无沉淀）

**LLM Wiki**：原始素材输入 → 编译为结构化 Markdown Wiki → 所有推理基于编译产物（知识越积越厚）

---

## 三层架构

### 第一层：原始素材层（不可变）

所有输入的投教原始资料统一进入 `raw/` 目录，永久不被修改。

**内容**：
- 证监会公告、交易所投教文章、官方法律法规
- 外部法律政策库、内部客户问答记录

**特点**：
- 事实基准，可追溯
- 当 Wiki 信息出现偏差时，可从原始素材重新编译

### 第二层：Wiki编译层（可变化）

Markdown 文件目录，包含：

| 类型 | 示例 | 说明 |
|------|------|------|
| 实体页面 | "市盈率"、"科创综指"、"北交所" | 基础概念定义 |
| 概念页面 | "资产配置"、"定投"、"复利效应" | 投资原理解释 |
| 主题摘要 | "投资者防骗指南"、"家庭财务规划" | 大类汇总 |
| 对比表格 | "低 PE vs 高PE 的误区对比" | 直观对比 |
| 交叉引用 | 各知识点之间的关联链接 | 知识图谱 |

**AI 代理职责**：
- 创建、更新和维护全部内容
- 当知识点更新时，自动检查所有引用页面并联动更新
- 标记新旧信息之间的矛盾之处
- 定期 Lint 检测（孤立页面、链接失效、内容冲突、信息过时）

### 第三层：应用与查询层

基于 Wiki 进行问答、检索和内容生成。

**三层检索策略**：
1. **Wiki 直接查询**：定义型、列典型的明确问题（如"什么是沪深 300？"）
2. **向量检索补充**：开放式、对比型的问题
3. **推理代理型（ReAct 循环）**：需要多步推理或综合多源信息的复杂问题

---

## 双循环机制

### 内循环（为当前客户即时服务）

```
客户提问 → 顾问检索知识库（优先）→ 找到→转译→输出（文字/语音/图文）→ 客户理解
                                 ↓未找到
                           定向搜索 → 转译 → 输出 → 同时反馈入库
```

### 外循环（系统性提升知识库）

```
顾问使用记录/客户常见问题统计 → 识别高频/难点知识点 → 主动策划深度投教内容 → 上线知识库 → 推送至所有相关客户
```

---

## 工程实践

| 需求 | 推荐方案 | 说明 |
|------|---------|------|
| 知识库构建平台 | Dify / RAGFlow | 开源、可视化、支持混合检索 |
| 向量数据库 | 云原生数据仓库 / Milvus | 稠密 + 稀疏向量混合检索 |
| 知识图谱 | Neo4j / FalkorDB | 构建实体关系网络 |
| 搜索引擎 | Elasticsearch | 关键词检索 + 元数据过滤 |
| LLM 模型 | Claude / GPT-4 / Qwen | 编译和推理核心 |
| 编排框架 | LangGraph | Agentic RAG 流程 |

---

## 落地路线图

| 阶段 | 目标 | 关键任务 | 交付物 |
|------|------|---------|--------|
| 第 1 周 | 框架搭建 | 配置数据存储、搭建 Dify/RAGFlow | 可运行的基础环境 |
| 第 2 周 | 核心流程 MVP | 建立 raw/ + Wiki/目录，编译 10 个高频问题 | 可用问答 Demo |
| 第 1 个月 | 自动化编译 | AI 代理自动编译新素材，版本控制 | 问答准确率 > 90% |
| 第 2-3 个月 | 多态输出 | 建立转译和输出模板库，与工作流集成 | 完整内容生产分发系统 |
| 第 3-6 个月 | 智能化治理 | 集成知识图谱、效果评估看板 | 知识库自进化 |


path: templates/education-template.md
content: # 投教内容模板：{知识点名称}

**生成时间**：{时间}
**来源**：{官方来源}
**难度等级**：⭐/⭐⭐/⭐⭐⭐
**适用人群**：{入门级/进阶级/专业级}

---

## 意图标记

```yaml
intent: {plain/writes/card/wechat/multi}
mold: {-l/-i/-c/-w/-b}
audience: {儿童/新手/进阶/专业}
```

---

## 知识库引用

- {知识点 1} → {Wiki 页面链接}
- {知识点 2} → {Wiki 页面链接}

---

## 因果链

{核心变量 1} → {核心变量 2} → {核心变量 3}

{解释因果链}

---

## 📖 大白话解释（≤200 字）

{用生活类比解释核心概念}

**一句话总结**：{一句话概括}

---

## 📊 对比表/流程图

| 对比项 | 正确理解 | 常见误区 |
|--------|---------|---------|
| {概念 1} | {正确} | {误区} |
| {概念 2} | {正确} | {误区} |

---

## 🎯 行动建议

- ✅ **应该做**：{具体行动 1}
- ✅ **应该做**：{具体行动 2}
- ❌ **不应该做**：{具体行动 3}
- ❌ **不应该做**：{具体行动 4}

---

## 💬 顾问口播脚本（30 秒）

{口语化脚本，适合语音条或面对面讲解}

---

## 📚 延伸阅读

- {相关知识点 1} → {链接}
- {相关知识点 2} → {链接}
- {官方来源} → {链接}

---

## 合规检查记录

- **红线检测**：{通过/未通过}
- **转化协议**：{已转化/未转化}
- **免责声明**：{已添加/未添加}
- **合规建议**：{建议}

---

## 🔄 反馈标记

- **使用频次**：{高/中/低}
- **客户理解难度**：⭐/⭐⭐/⭐⭐⭐/⭐⭐⭐⭐/⭐⭐⭐⭐⭐
- **是否需要迭代**：是/否
- **关联偏误**：{过度自信/损失厌恶/羊群效应/锚定效应/近因效应}

---

*本内容仅供投资者教育使用，不构成投资建议。市场有风险，投资需谨慎。*


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)