Skills

rq-report-renderer

Installation
SKILL.md

RQ 股票研究 - HTML 报告渲染器

核心原则

  • 输入必须是显式的 Markdown 文件路径，不能依赖固定目录
  • skill 必须自包含，渲染逻辑、样式和输入契约都放在 report-renderer/ 内
  • 不依赖仓库级 utils
  • 不要求外部 Markdown 库；脚本内置最小可用解析器，覆盖当前各 skill 的真实输出结构
  • 输出必须保留标题、章节、表格、列表、代码样式与数据来源标注
  • 若本机支持打开浏览器，应作为可选行为，而不是强制副作用

目标产出

  • 单文件 HTML 报告
  • 默认与输入 Markdown 同目录同名输出
  • 适合桌面阅读与打印

目录结构

report-renderer/
├── SKILL.md
├── scripts/
│   └── render_report.py
├── assets/
│   └── report.css
└── references/
    └── input_contract.md

输入契约

  • 主输入：一个 Markdown 文件
  • 可选参数：
    • 输出 HTML 路径
    • 覆盖标题
    • --open：渲染后尝试在默认浏览器打开

完整输入格式与支持的 Markdown 子集见 references/input_contract.md。

工作流

步骤 1：准备输入文件

确认已有 Markdown 报告，例如：

INPUT_MD="skill-test-results/sector-overview/baijiu/output/sector_overview_baijiu_2026-04-03.md"
OUTPUT_HTML="${INPUT_MD%.md}.html"

步骤 2：执行渲染

主入口：

python3 report-renderer/scripts/render_report.py "$INPUT_MD" "$OUTPUT_HTML"

若希望渲染后尝试打开浏览器：

python3 report-renderer/scripts/render_report.py "$INPUT_MD" "$OUTPUT_HTML" --open

步骤 3：验证输出

  • HTML 文件存在
  • HTML 中包含 <!DOCTYPE html>
  • 主标题、主要章节和表格都已渲染
  • 不应残留原始 Markdown 表格分隔行（如 | --- | --- |）
  • 数据来源：RQData，置信度5 等来源标注仍保留

参数说明

  • 第一个位置参数：输入 Markdown 文件
  • 第二个位置参数：输出 HTML 文件，可省略
  • --title：覆盖封面标题
  • --open：渲染完成后尝试打开浏览器

报告质量要求

  • 输出必须是完整 HTML，而不是片段
  • 章节层级必须可导航，至少生成二级目录
  • 表格必须渲染成 <table>
  • 列表必须渲染成 <ul> / <ol>
  • 粗体、斜体、行内代码与 <br> 必须保留
  • 样式必须独立内联或由 skill 自带资源注入，不能依赖外部 CDN

常见错误

  • 把完整渲染脚本直接塞回 SKILL.md，没有落地成可执行文件
  • 只渲染段落，不支持 Markdown 表格
  • 把列表项直接变成裸 <li>，没有外层 <ul> / <ol>
  • 强依赖外部 Markdown 库，导致在最小环境里不可执行
  • 依赖 repo 里的 utils/html_renderer.py
Related skills

More from ricequant/ricequant-skills

Installs
1
Repository
ricequant/riceq…t-skills
GitHub Stars
16
First Seen
13 days ago
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykPass