CaiJichang

***

name: "wechat-blog-write-publish"\
description: "基于参考资料创作微信公众号文章并发布到草稿箱。Invoke when user provides reference materials and wants to create and publish a WeChat official account article."
------------------------------------------------------------------------------------------------------------------------------------------------------

# WeChat Blog Write & Publish

本技能基于参考资料自动创作微信公众号文章，并发布到公众号草稿箱，实现从素材到成品的全流程自动化。

## 工作流程

### 1. 接收输入

- 接收用户提供的参考资料（网页链接、文档、PDF 等）
- 确认文章主题、核心内容方向和写作风格

### 2. 内容创作

严格遵循以下标准创作高质量文章：

#### 内容要求

- ✅ **准确性**：严格依据参考资料，确保信息准确、来源可靠
- ✅ **专业性**：突出专业深度和实用价值，提供丰富的干货内容
- ✅ **可读性**：采用通俗易懂的表达，避免过度使用专业术语，必要时提供清晰解释
- ✅ **逻辑性**：结构清晰，层次分明，论述连贯

#### 排版设计

- ✅ **布局美观**：整体排版大方得体，视觉舒适
- ✅ **标题层级**：合理使用 Markdown 标题（# ## ###），层次清晰
- ✅ **段落分隔**：段落长短适中，分隔清晰
- ✅ **重点突出**：使用 **加粗**、> 引用 等方式强调关键信息

#### 视觉元素

- ✅ **适度装饰**：合理运用表情符号（如：😊、🎉、✨、📌）增强可读性
- ✅ **风格平衡**：保持专业性与趣味性的平衡，避免过度娱乐化

#### 图表要求

- ✅ **流程图/架构图**：涉及流程、架构等内容时，使用 mermaid 语法创建可视化图表
- ✅ **示例**：

```mermaid
graph TD
    A[开始] --> B[输入处理]
    B --> C[内容生成]
    C --> D[发布]
```

#### 元信息格式

文章开头必须包含 Front Matter 元信息：

```markdown
---
title: 文章标题
cover: asset/微信公众号头像.png
---
```

### 3. 输出格式

- 将完成的文章保存为 Markdown (`.md`) 格式文件
- 确保 Markdown 语法正确，可直接用于发布

### 4. 发布文章

使用 wenyan-cli 工具将 Markdown 文章发布到微信公众号草稿箱：

```bash
wenyan publish -f 文章名字.md
```

#### wenyan-cli 工具说明

**安装方式：**

```bash
npm install -g @wenyan-md/cli
```

**前置配置：**

1. **获取公众号 AppID 和 AppSecret**
   - 登录微信公众号后台
   - 进入"设置与开发" → "开发接口管理"
   - 复制 AppID 和 AppSecret

2. **配置 IP 白名单** ⚠️
   - 在公众号后台"开发接口管理" → "基本配置" → "IP 白名单"
   - 添加本机公网 IP（可通过访问 [ip.sb](https://ip.sb) 查看）
   - **重要**：未配置白名单会导致 `40164` 错误

3. **配置凭证**
   ```bash
   wenyan config --appid 你的 AppID --appsecret 你的 AppSecret
   ```

**常用命令：**

```bash
# 一键发布（最常用）
wenyan publish -f article.md

# 指定主题样式
wenyan publish -f article.md --theme blue

# 指定作者
wenyan publish -f article.md --author "作者名"

# 指定封面图
wenyan publish -f article.md --cover ./cover.jpg

# 开启评论
wenyan publish -f article.md --enable-comment

# 查看当前配置
wenyan config --list

# 查看可用主题
wenyan config --list-themes
```

**内置主题：**
`default`, `blue`, `green`, `red`, `yellow`, `brown`, `black`, `orange`

**Front Matter 支持：**

文章开头可使用 Front Matter 定义元信息，命令行参数优先级高于 Front Matter：

```markdown
---
title: 文章标题
author: 作者名
digest: 文章摘要
theme: blue
cover: ./cover.jpg
enableComment: true
---
```

**分步执行流程：**

如需更精细的控制，可分步执行：

```bash
# Step 1: Markdown 转 HTML（可指定主题）
wenyan md2html --from article.md --to article.html --theme blue

# Step 2: 修复 HTML 并上传图片到微信图床
wenyan fix article.html

# Step 3: 生成封面图
wenyan cover --title "文章标题" --author "作者名" --to cover.jpg

# Step 4: 发布到草稿箱
wenyan publish --article article.html --cover cover.jpg
```

**输出目录结构：**

执行后会在同级目录生成 `.wxgzh/` 中间产物目录：

```
.wxgzh/
├── article.html          # 转换后的 HTML（已内联样式）
├── article.cover.jpg     # 自动生成的封面图
└── publish-result.json   # 发布结果（含草稿 ID）
```

**常见问题：**

1. **`40164` 错误**：IP 不在白名单，需在公众号后台添加本机公网 IP
2. **封面图比例错误**：微信封面图要求 2.35:1，工具会自动裁剪
3. **图片上传失败**：确保图片为本地路径，或已上传至微信图床

## 使用示例

### 示例 1：基于网页链接创作

**用户输入：**

```
请根据这个链接写一篇关于 LangChain 的公众号文章：
https://python.langchain.com/docs/get_started/introduction
```

**技能执行：**

1. 抓取并分析网页内容
2. 创作文章（包含 Front Matter 元信息、mermaid 图表、适当的表情符号）
3. 保存为 `langchain-intro.md`
4. 执行 `wenyan publish -f langchain-intro.md` 发布到草稿箱

### 示例 2：基于多个参考资料

**用户输入：**

```
请根据以下资料写一篇 AI 产品经理的文章：
- 文档：/path/to/product-methods.pdf
- 链接：https://example.com/ai-pm-guide
```

**技能执行：**

1. 读取 PDF 文档和网页内容
2. 整合信息，创作结构化的文章
3. 保存为 `ai-product-manager.md`
4. 执行 `wenyan publish -f ai-product-manager.md` 发布到草稿箱

## 注意事项

1. **内容准确性**：必须严格基于参考资料，不臆造信息，确保内容可靠
2. **格式规范**：确保 Markdown 语法正确，标题层级清晰，无语法错误
3. **发布前检查**：执行 `publish` 命令前确认 wenyan-cli 已正确配置，文件路径正确
4. **封面图片**：默认使用 `asset/微信公众号头像.png`，请确保该路径存在或使用自定义封面
5. **IP 白名单**：发布前务必在公众号后台配置本机 IP 白名单，避免 `40164` 错误


FILE:README.md
# WeChat Blog Write & Publish Skill

基于参考资料自动创作微信公众号文章，并发布到公众号草稿箱的 AI 技能。

## ✨ 特性

- 🎯 **智能创作**：基于参考资料（网页、文档、PDF）自动生成高质量文章
- 📝 **专业排版**：遵循微信公众号排版规范，美观易读
- 🚀 **一键发布**：自动发布到公众号草稿箱，无需手动操作
- 📊 **可视化图表**：支持 Mermaid 语法，自动生成流程图、架构图
- 🎨 **多主题支持**：内置 8 种主题样式，满足不同风格需求

## 📋 工作流程

```mermaid
graph LR
    A[接收参考资料] --> B[内容分析]
    B --> C[文章创作]
    C --> D[保存 Markdown]
    D --> E[发布到草稿箱]
```

### 1️⃣ 接收输入
- 支持网页链接、文档、PDF 等多种格式
- 确认文章主题、内容方向和写作风格

### 2️⃣ 内容创作
严格遵循四大标准：
- ✅ **准确性**：严格依据参考资料，信息可靠
- ✅ **专业性**：提供深度内容和实用价值
- ✅ **可读性**：通俗易懂，必要时解释专业术语
- ✅ **逻辑性**：结构清晰，层次分明

### 3️⃣ 排版设计
- 合理使用 Markdown 标题层级
- 段落分隔清晰，重点突出
- 适度使用表情符号增强可读性

### 4️⃣ 发布文章
使用 `wenyan-cli` 工具一键发布到微信公众号草稿箱

## 🛠️ 安装与配置

### 安装 wenyan-cli

```bash
npm install -g @wenyan-md/cli
```

### 配置公众号凭证

1. **获取 AppID 和 AppSecret**
   - 登录 [微信公众号后台](https://mp.weixin.qq.com)
   - 进入"设置与开发" → "开发接口管理"
   - 复制 AppID 和 AppSecret

2. **配置 IP 白名单** ⚠️
   - 在公众号后台"开发接口管理" → "基本配置" → "IP 白名单"
   - 添加本机公网 IP（访问 [ip.sb](https://ip.sb) 查看）
   - **重要**：未配置白名单会导致 `40164` 错误

3. **配置凭证**
   ```bash
   wenyan config --appid 你的 AppID --appsecret 你的 AppSecret
   ```

## 📖 使用指南

### 快速开始

```bash
# 一键发布 Markdown 文章
wenyan publish -f article.md
```

### 常用命令

```bash
# 指定主题样式
wenyan publish -f article.md --theme blue

# 指定作者
wenyan publish -f article.md --author "作者名"

# 指定封面图
wenyan publish -f article.md --cover ./cover.jpg

# 开启评论
wenyan publish -f article.md --enable-comment

# 查看配置
wenyan config --list

# 查看可用主题
wenyan config --list-themes
```

### 内置主题

`default` · `blue` · `green` · `red` · `yellow` · `brown` · `black` · `orange`

### 高级用法：分步执行

```bash
# Step 1: Markdown 转 HTML
wenyan md2html --from article.md --to article.html --theme blue

# Step 2: 修复 HTML 并上传图片
wenyan fix article.html

# Step 3: 生成封面图
wenyan cover --title "文章标题" --author "作者名" --to cover.jpg

# Step 4: 发布到草稿箱
wenyan publish --article article.html --cover cover.jpg
```

## 📄 Front Matter 支持

在 Markdown 文章开头定义元信息：

```markdown
---
title: 文章标题
author: 作者名
digest: 文章摘要
theme: blue
cover: ./cover.jpg
enableComment: true
---
```

> 💡 命令行参数优先级高于 Front Matter

## 📁 输出目录结构

执行后生成 `.wxgzh/` 目录：

```
.wxgzh/
├── article.html          # 转换后的 HTML（已内联样式）
├── article.cover.jpg     # 自动生成的封面图
└── publish-result.json   # 发布结果（含草稿 ID）
```

## 💡 使用示例

### 示例 1：基于网页链接

**输入：**
```
请根据这个链接写一篇关于 LangChain 的公众号文章：
https://python.langchain.com/docs/get_started/introduction
```

**执行流程：**
1. 抓取并分析网页内容
2. 创作文章（包含 Front Matter、Mermaid 图表、表情符号）
3. 保存为 `langchain-intro.md`
4. 执行 `wenyan publish -f langchain-intro.md` 发布

### 示例 2：基于多个参考资料

**输入：**
```
请根据以下资料写一篇 AI 产品经理的文章：
- 文档：/path/to/product-methods.pdf
- 链接：https://example.com/ai-pm-guide
```

**执行流程：**
1. 读取 PDF 文档和网页内容
2. 整合信息，创作结构化文章
3. 保存为 `ai-product-manager.md`
4. 执行 `wenyan publish -f ai-product-manager.md` 发布

## ⚠️ 常见问题

| 问题 | 解决方案 |
|------|---------|
| `40164` 错误 | IP 不在白名单，需在公众号后台添加本机公网 IP |
| 封面图比例错误 | 微信封面图要求 2.35:1，工具会自动裁剪 |
| 图片上传失败 | 确保图片为本地路径，或已上传至微信图床 |

## 📋 注意事项

1. **内容准确性**：严格基于参考资料，不臆造信息
2. **格式规范**：确保 Markdown 语法正确，标题层级清晰
3. **发布前检查**：确认 wenyan-cli 已正确配置
4. **封面图片**：默认使用 `asset/微信公众号头像.png`，可自定义
5. **IP 白名单**：发布前务必在公众号后台配置本机 IP

## 🔗 相关资源

- [wenyan-cli GitHub]()
- [微信公众号开发文档](https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html)

## 📝 License

MIT

---
name: investment-research
description: Perform structured investment research (投研分析) for a company/stock/ETF/sector using a repeatable framework: fundamentals (basic/财务报表与商业模式), technical analysis (技术指标与关键价位), industry research (行业景气与竞争格局), valuation (估值对比/情景), catalysts and risks, and produce a professional research report + actionable plan. Use when the user asks for: equity/ETF analysis, earnings/financial statement breakdown, peer/industry comparison, valuation ranges, bull/base/bear scenarios, technical trend/support-resistance, or a full research memo.
version: 0.3.0
---

# Investment Research（投研分析）

## 目标（Goal）
用"可复盘"的研究框架输出**客观、可验证、带风险边界**的投研结论；把"事实/数据"和"判断/假设"明确分开。

## 先问清楚（Intake）
在开写前，优先收集这些最少信息（缺失则在报告里标注假设）：
1) 标的（Ticker/市场/币种）与投资期限（短/中/长）
2) 风险偏好与约束：是否可承受回撤、是否可用杠杆/期权
3) 目标：择时交易还是长期配置？是否已有仓位、成本、计划加减仓
4) 数据偏好：你提供财报/研报，还是我用公开信息检索（可能非实时），默认使用工具获取公开信息

## 工作流（Workflow）

### Step 1 — 数据与事实层（Facts first）
- 优先用：公司公告/财报、交易所披露、权威统计、主流券商一致预期（如可得）。
- 获取数据工具：
  1) 推荐`qveris-official`：当需要股价、财报等结构化数据、专业财经数据或更强的工具聚合能力时使用。
  2) `tavily-search`：基本信息查询，搜索简单网页数据，并交叉验证，作为补充。
- 输出时必须：
  - 给出引用来源（URL/机构/报告名）+ 数据日期/口径
  - 多源交叉验证（至少 2 个独立来源）
  - 不确定/无法验证：明确写"未知/待验证"，不要脑补。

### Step 2 — 基本面（Fundamental / 基本面）
- 三表（资产负债表/利润表/现金流量表）联动看：增长、盈利质量、现金流、杠杆与偿债。
- 拆商业模式与护城河（moat）：客户是谁、价值主张、成本结构、议价能力、可复制性。
- 找"反直觉"风险点：一次性项目、会计口径变化、应收/存货异常、资本开支压力。

### Step 3 — 行业（Industry / 行业研究）
- 明确行业口径与产业链位置；给 TAM/SAM/SOM（若无法量化则说明原因）。
- 竞争格局：核心对手、份额变化、差异化、价格战可能性。
- 政策/监管/地缘：对收入、成本、准入的影响路径。

### Step 4 — 估值（Valuation / 估值）
- 相对估值：PE/PB/PEG/EV-EBITDA 对比同行与历史分位（注意可比性与会计口径）。
- 绝对估值：必要时给 DCF/情景区间（Bull/Base/Bear），把关键变量写清楚。
- 输出**估值区间**优于单点目标价；注明数据日期与货币。

### Step 5 — 技术面（Technical / 技术分析）
- 只做"时点与风险管理"辅助：趋势（多周期）+ 关键位（支撑/阻力）+ 量价验证。
- 指标作为证据而非结论：MA、MACD、RSI、KDJ、布林带等（见参考）。
- 给可执行计划：入场区间、无效点/止损（stop-loss）、目标与跟踪规则。

### Step 6 — 结论、催化剂、风险与反证
- 催化剂（catalysts）：未来 3–12 个月可验证事件 + 可能影响方向。
- 风险：列 Top 3–7，并给"监控指标/触发条件"。
- 反证（disconfirming evidence）：什么发生会推翻你的核心观点。

## 输出规范（Output Standard）
- 默认输出：一份《投研分析报告》+ 一段"行动清单"。
- 明确区分：
  - **事实（Facts）**：带来源与时间
  - **假设（Assumptions）**：可被验证/证伪
  - **判断（Judgement）**：基于事实与假设
- 避免确定性措辞：用"可能/大概率/条件成立时"。
- 必须包含风险提示与免责声明。

## 模板与参考资料（Resources）
- 生成报告时：优先按 `references/report-template.md` 的结构输出。
- 指标口径不确定时：查 `references/indicator-cheatsheet.md`。

## 快速示例（Prompts that should work）
- "按基本面+行业+估值分析一下 XX（给 bull/base/bear）"
- "把 XX 最近 3 年的财务质量拆开讲，看看有没有风险点"
- "用技术面给一个交易计划：支撑阻力、止损止盈怎么设"
- "对比 XX 和 YY：谁更值得配置？给关键分歧与跟踪指标"

## 工具要求（Tool Requirements）

### 推荐工具
- **qveris-official**（首选）：用于获取股价、财报等结构化数据和专业财经数据
- **tavily-search**（备用）：用于基本信息查询和网页数据补充

### 工具使用策略
1. 优先使用结构化数据源（qveris-official）
2. 交叉验证至少 2 个独立来源
3. 明确标注数据来源、日期和口径
4. 无法验证的数据明确标注"未知/待验证"

FILE:CONFIG.md
# 配置说明（Configuration Guide）

## 工具配置

本技能需要配置以下工具才能正常工作：

### 1. qveris-official（推荐）

**类型**: 主数据源

**用途**:
- 股价历史数据
- 财务报表（资产负债表、利润表、现金流量表）
- 专业财经数据
- 一致预期数据

**配置步骤**:

1. 获取 qveris API Key
   - 访问 qveris 官网注册账号
   - 在开发者控制台获取 API Key

2. 在 OpenClaw 配置中添加工具
   ```json
   {
     "tools": {
       "entries": {
         "qveris-official": {
           "enabled": true,
           "apiKey": {
             "source": "env",
             "provider": "default",
             "id": "QVERIS_API_KEY"
           }
         }
       }
     }
   }
   ```

3. 设置环境变量
   ```bash
   export QVERIS_API_KEY="your-api-key-here"
   ```

### 2. tavily-search（备用）

**类型**: 辅助数据源

**用途**:
- 公司基本信息查询
- 公告和新闻检索
- 补充数据交叉验证

**配置步骤**:

1. 获取 Tavily API Key
   - 访问 Tavily 官网注册
   - 获取 API Key

2. 在 OpenClaw 配置中添加工具
   ```json
   {
     "tools": {
       "entries": {
         "tavily-search": {
           "enabled": true,
           "apiKey": {
             "source": "env",
             "provider": "default",
             "id": "TAVILY_API_KEY"
           }
         }
       }
     }
   }
   ```

3. 设置环境变量
   ```bash
   export TAVILY_API_KEY="your-api-key-here"
   ```

## 数据源优先级

1. **首选**: qveris-official（结构化数据、专业财经数据）
2. **备用**: tavily-search（网页信息、新闻公告）

## 配置验证

配置完成后，可以通过以下方式验证：

```bash
# 检查环境变量
echo $QVERIS_API_KEY
echo $TAVILY_API_KEY

# 测试技能
clawhub inspect investment-research
```

## 常见问题

### Q: 如何确认工具已正确配置？
A: 在 OpenClaw 中执行 `clawhub list` 查看已安装的技能和工具，确保工具状态为 "enabled"。

### Q: 数据获取失败怎么办？
A: 
1. 检查 API Key 是否有效
2. 确认网络连接正常
3. 查看 qveris/Tavily 服务状态
4. 尝试使用备用数据源

### Q: 可以只配置一个数据源吗？
A: 可以，但建议至少配置 qveris-official 以获得最佳体验。tavily-search 作为备用数据源用于交叉验证。

## 高级配置

### 自定义数据源

如果需要使用其他数据源（如 Yahoo Finance、Alpha Vantage 等），可以在 OpenClaw 配置中添加自定义工具：

```json
{
  "tools": {
    "entries": {
      "custom-finance-api": {
        "enabled": true,
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "CUSTOM_API_KEY"
        },
        "config": {
          "endpoint": "https://api.example.com",
          "rateLimit": 100
        }
      }
    }
  }
}
```

### 数据缓存配置

为提高性能，建议配置数据缓存：

```json
{
  "skills": {
    "entries": {
      "investment-research": {
        "enabled": true,
        "config": {
          "cacheEnabled": true,
          "cacheTTL": 3600
        }
      }
    }
  }
}
```

## 安全建议

1. **不要提交 API Key**: 确保 `.env` 文件在 `.gitignore` 中
2. **使用环境变量**: 避免在配置文件中硬编码敏感信息
3. **定期轮换**: 定期更换 API Key 以提高安全性
4. **限制权限**: 为 API Key 设置适当的权限范围

FILE:README.md
# 投资研究（Investment Research）

执行结构化投资研究（投研分析），用于公司/股票/ETF/行业的专业分析。

[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/openclaw/skill-template)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)

## 📋 功能概述

本技能提供完整的投研分析框架，包括：
- ✅ 基本面分析（财务报表与商业模式）
- ✅ 技术分析（技术指标与关键价位）
- ✅ 行业研究（行业景气与竞争格局）
- ✅ 估值分析（估值对比与情景分析）
- ✅ 催化剂与风险评估
- ✅ 结构化报告输出

## 🚀 安装与使用

### 安装方式

通过 ClawHub 安装：
```bash
clawhub install investment-research
```

或手动安装到工作区：
```bash
git clone https://github.com/CaiJichang212/investment-research.git
cp -r investment-research ~/.openclaw/skills/
```

### 使用示例

```
- "按基本面+行业+估值分析一下 XX（给 bull/base/bear）"
- "把 XX 最近 3 年的财务质量拆开讲，看看有没有风险点"
- "用技术面给一个交易计划：支撑阻力、止损止盈怎么设"
- "对比 XX 和 YY：谁更值得配置？给关键分歧与跟踪指标"
```

## ⚙️ 数据配置说明

**重要：本技能需要配置数据源才能获取实时财经数据。**

### 必需配置

#### 1. qveris-official（推荐）

用于获取股价、财报等结构化数据和专业财经数据。

**配置方式：**
- 在工具配置中启用 `qveris-official` 工具
- 如需 API Key，请参考 qveris 官方文档进行配置

**用途：**
- 股价历史数据
- 财务报表（资产负债表、利润表、现金流量表）
- 专业财经数据
- 一致预期数据

#### 2. tavily-search（备用）

用于基本信息查询和网页数据补充。

**配置方式：**
- 在工具配置中启用 `tavily-search` 工具
- 如需 API Key，请参考 Tavily 官方文档进行配置

**用途：**
- 公司基本信息查询
- 公告和新闻检索
- 补充数据交叉验证

### 数据获取流程

1. **优先使用**：公司公告/财报、交易所披露、权威统计、主流券商一致预期
2. **数据验证**：至少使用 2 个独立来源进行交叉验证
3. **数据标注**：明确标注数据来源、日期和口径
4. **不确定处理**：无法验证的数据明确标注"未知/待验证"

## 📊 分析框架

### Step 1 - 数据与事实层
- 获取最新财务数据和市场信息
- 多源交叉验证确保数据准确性

### Step 2 - 基本面分析
- 三表联动分析（资产负债表/利润表/现金流量表）
- 商业模式与护城河分析
- 风险点识别

### Step 3 - 行业研究
- 行业市场规模与景气度
- 竞争格局分析
- 政策与监管影响

### Step 4 - 估值分析
- 相对估值（PE/PB/PEG/EV/EBITDA）
- 绝对估值（DCF/情景分析）
- 估值区间输出

### Step 5 - 技术分析
- 多周期趋势分析
- 关键支撑/阻力位识别
- 交易计划制定

### Step 6 - 结论与建议
- 明确投资观点
- 催化剂与风险评估
- 反证分析

## 📝 使用示例

```
- "按基本面+行业+估值分析一下 XX（给 bull/base/bear）"
- "把 XX 最近 3 年的财务质量拆开讲，看看有没有风险点"
- "用技术面给一个交易计划：支撑阻力、止损止盈怎么设"
- "对比 XX 和 YY：谁更值得配置？给关键分歧与跟踪指标"
```

## 📄 输出规范

- 结构化投研分析报告
- 行动清单与跟踪指标
- 明确区分事实/假设/判断
- 完整的风险提示与免责声明

## 📚 参考资料

- [报告模板](references/report-template.md) - 标准化报告结构
- [指标速查](references/indicator-cheatsheet.md) - 财务与技术指标定义

## 🔧 技术规格

- **版本**: 0.3.0
- **语言**: 中英文双语
- **兼容性**: OpenClaw / ClawHub
- **依赖**: qveris-official (推荐), tavily-search (备用)

## 📝 更新日志

### v0.3.0 (2026-03-19)
- ✅ 完善 clawhub 元数据配置
- ✅ 优化 SKILL.md 格式和内容
- ✅ 添加工具要求说明
- ✅ 完善安装与使用文档

### v0.1.0
- 初始版本发布
- 基本投研分析框架
- 报告模板和指标速查

## ⚠️ 免责声明

本技能仅用于信息交流与研究讨论，不构成投资建议。投资有风险，入市需谨慎。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 🙏 致谢

- OpenClaw 社区
- ClawHub 平台

FILE:_meta.json
{
  "ownerId": "local",
  "slug": "investment-research",
  "version": "0.3.0",
  "name": "A股投资助手",
  "description": "适合中国A股的投研分析专业技能，用于公司/股票/ETF/行业的专业分析",
  "homepage": "https://github.com/CaiJichang212/investment-research",
  "metadata": {
    "openclaw": {
      "requires": {
        "bins": [],
        "env": [
          "QVERIS_API_KEY",
          "TAVILY_API_KEY"
        ],
        "config": [
          "tools.entries.qveris-official",
          "tools.entries.tavily-search"
        ]
      },
      "primaryEnv": "",
      "os": ["darwin", "linux", "win32"]
    }
  }
}

FILE:references/indicator-cheatsheet.md
# 指标速查（Fundamental & Technical Cheatsheet）

## 基本面（Fundamentals）
- 营收增长率（Revenue Growth）= (本期营收-上期营收)/上期营收
- 净利润率（Net Margin）= 净利润/营收
- ROE（Return on Equity）= 净利润/平均股东权益
- ROA（Return on Assets）= 净利润/平均总资产
- 资产负债率（Debt Ratio）= 总负债/总资产
- 净负债（Net Debt）= 有息负债-现金及等价物
- 自由现金流（FCF, Free Cash Flow）≈ 经营现金流-资本开支（CapEx）

## 估值（Valuation）
- PE（P/E）= 市值/净利润（或股价/每股收益 EPS）
- PB（P/B）= 市值/净资产（或股价/每股净资产 BVPS）
- PEG = PE/利润增速（注意用一致口径与周期）
- EV/EBITDA：企业价值/息税折旧摊销前利润

## 技术面（Technical）
- MA（Moving Average）：常用 20/50/200
- MACD：DIF/DEA/柱；看背离与金叉死叉，配合趋势使用
- RSI：常用 14；>70 可能超买，<30 可能超卖（需结合趋势）
- KDJ：更偏短线，震荡市参考价值更高
- 布林带（Bollinger Bands）：中轨 MA，上下轨 ±k*σ；看收口/开口、轨道突破的“真假”

## 可靠性提示（Reliability）
- 单一指标不下结论；至少“趋势+量价+关键位”交叉验证。
- 任何技术指标在重大消息面前可能失效。

FILE:references/report-template.md
# 投研分析报告模板（Investment Research Report Template）

> 用途：生成结构化、可复用的投研分析输出。默认面向股票/ETF；其他资产（可转债、期货、加密等）需在“适用性”处声明。

## 0. 执行摘要（Executive Summary）
- 标的（Ticker/Market）：
- 结论（观点分级）：看多/中性/看空（Bull/Base/Bear）
- 关键理由（3 条内）：
- 关键假设（2–5 条）：
- 触发因素/催化剂（Catalysts）：
- 主要风险（Top Risks）：
- 适用投资者/持有周期（Who/When）：

## 1. 公司/标的概况（Company/Instrument Overview）
- 主营业务与收入构成：
- 商业模式（Business Model）：
- 护城河（Moat）：品牌/规模/成本/渠道/技术/监管牌照等
- 管理层与治理（Management & Governance）：
- 股权结构/重要股东（Ownership）：

## 2. 行业与竞争格局（Industry & Competition）
- 行业定义与市场规模（TAM/SAM/SOM）：
- 景气度与周期位置（Cycle）：
- 产业链位置与议价能力（Value Chain & Pricing Power）：
- 竞争对手对比（Peers）：份额、产品、毛利、增长、资本开支
- 政策/监管（Policy/Regulation）：

## 3. 财务与经营质量（Financials & Quality）
> 建议给 3–5 年趋势；若有季报也给近 4–8 季。
- 收入增速、毛利率、净利率：
- ROE/ROA、杜邦拆解（DuPont）：
- 费用率与经营杠杆（Operating Leverage）：
- 现金流质量（Cash Conversion）：经营现金流 vs 净利润
- 资产负债表健康度：净现金/净负债、短债压力、流动比率
- 异常项：一次性收益/减值、会计政策变更、非经常性损益

## 4. 估值（Valuation）
- 相对估值（Relative）：PE/PB/PEG/EV-EBITDA vs 同行/历史分位
- 绝对估值（Absolute）：DCF/股利折现/分部估值（SOTP）
- 情景分析（Scenario）：Bull/Base/Bear 的关键变量与估值区间
- 市场一致预期（Consensus）与分歧点：

## 5. 技术面（Technical Analysis）
> 仅作为交易/时点辅助，不替代基本面。
- 趋势（Trend）：上升/震荡/下降（多周期：日/周/月）
- 关键位：支撑/阻力（Support/Resistance）、趋势线
- 指标：MA、MACD、RSI、布林带（Bollinger Bands）、量价（Price-Volume）
- 形态：箱体/头肩/旗形/突破失败等
- 交易计划：入场区间、止损（Stop-loss）、止盈/跟踪止盈（Take-profit/Trailing）

## 6. 事件与催化剂（Events & Catalysts）
- 未来 3–12 个月可验证事件：财报、产品发布、政策落地、并购、价格调整
- 领先指标（Leading Indicators）：订单、ASP、渠道库存、运价、开工率等

## 7. 风险提示与反证（Risks & Disconfirming Evidence）
- 经营风险：需求、竞争、供给、成本、执行
- 财务风险：负债、再融资、现金流、减值
- 政策/合规风险：
- 流动性与市场风险：
- 我错的信号（What would make me wrong）：

## 8. 结论与建议（Conclusion & Actionable Plan）
- 观点与依据回顾：
- 仓位建议（Position Sizing，非强制）：
- 关键观察清单（Watchlist）：
- 更新频率：下次复盘时间点/触发条件

## 9. 免责声明（Disclaimer）
- 本报告仅作信息交流与研究讨论，不构成投资建议/要约；投资有风险，入市需谨慎。