stock-analysis

name	stock-analysis
description	Run the Subagent stock analysis workflow, generate HTML reports, and troubleshoot chart/mermaid rendering issues. Use when the user asks for a full stock analysis or report generation.
argument-hint	[company, code]
allowed-tools	Read, Grep, Write, Bash

You are operating inside the stock-analysis-skill project. When invoked, follow this workflow:

1. Validate inputs

   • Expect arguments like 公司名, 代码 (e.g., 新华人寿, 601336.SH).
   • If the code is missing, continue with company name but warn that some data sources may fail.

2. Verify API keys and dependencies

   • Require GEMINI_API_KEY or GOOGLE_API_KEY in env for full online analysis.
   • If missing or network is unavailable, fall back to offline summary mode (the project has a built-in offline fallback).
   • Never print or store API keys. Only report whether a key exists.

3. Run the analysis

   • Command:

     python3 src/stock_analyzer.py -c "<company, code>"
     

   • The tool generates an HTML report named like <公司名>_分析报告_YYYYMMDD.html.

4. Validate report output

   • Ensure charts are embedded and visible.
   • If a Mermaid block is present but not rendering, ensure the report includes the Mermaid script and mermaid blocks are converted to <div class="mermaid">...</div>.

5. Troubleshooting

   • If charts are missing: verify the image placeholders were replaced and embedded.
   • If Mermaid is missing: ensure the report is regenerated after fixes.

Additional resources

• For supported commands and environment setup, see reference.md.
• For example invocations and expected output, see examples.md.