stock-qualitative-analysis

Use this skill when a user asks for a qualitative stock analysis report (定性分析) that must be evidence-based and formatted as a structured report. This skill emphasizes strict citations and non-hallucination behavior.

Inputs

• Company name (required)

• Ticker / exchange (optional but recommended)

• Market context (US / HK / CN / other)

• Time window (e.g., FY2015–FY2024; latest quarterly)

• Language preference (Chinese default; English if requested)

• Sources:

User-provided filings (PDF or HTML)

• SEC EDGAR fetch (optional, if allowed)

• Other public sources (only if cited)

Outputs

• A Markdown report following the template structure in assets/report-template.md

• Each section contains: 结论要点 / 详细情况 / 证据与出处 (or English equivalents when English output is requested)

• Final 来源清单 with SEC filings and other sources in reverse-chronological order

Core rules (non-negotiable)

• Do not state facts without a source.

• Any factual claim MUST include a source string; otherwise use a placeholder in 【...】 describing what is needed.

• Actively analyze sources: Go beyond surface-level summaries. Extract specific details, quantitative data, and contextual insights relevant to each section of the report template.

• Comprehensive filling: Make the best effort to fill all sections of the report template. If information is truly missing from the provided sources, use a specific placeholder indicating what is missing.

• If real-time data is required, explicitly state that the user must verify freshness.

• No investment advice, price targets, or trading recommendations.

• Default output language: Chinese. If the user query is in English, respond in English.

Execution

• Intake: confirm company name, ticker/exchange, market, time window, and allowed data sources.

• Pre-check local data: before any remote fetching, verify whether local filings are sufficient; only fetch remotely if local data is insufficient.

• Acquire sources: use scripts/build_source_manifest.py to pull SEC filings and ingest local PDFs.

• Extract key 10-K sections (HTML): use scripts/extract_sec_html_sections.py to produce per-item text files (e.g., Item 1/1A/7/8) before analysis.

• Section-by-section generation (Agent-driven): for each section in assets/report-template.md, the Agent expands the section in sequence, producing 结论要点 / 详细情况 / 证据与出处 based on the available sources and citing evidence.

• Progressive write-back: before starting summaries, determine whether a local report file exists; after completing each section, write the content into that file.

• Finalization: rewrite 投资要点概览 after all sections are complete, then update 来源清单.

Usage

• The Agent executes the section loop at runtime based on the template headings.

• The Agent MUST attempt to fill every section using provided sources and mark missing facts with explicit placeholders.

• If the user asks for English output, the Agent translates the template headings and section labels consistently (e.g., Conclusion / Details / Evidence) while preserving the report structure.

Data acquisition

• SEC EDGAR fetch: scripts/fetch_sec_edgar.py

• Local PDF ingestion: scripts/ingest_local_pdfs.py

• Source manifest: scripts/build_source_manifest.py

• HTML section extractor: scripts/extract_sec_html_sections.py

Citation format

• SEC filings: Form 10-K/10-Q/20-F/6-K + 年度/日期 + 章节/标题

• Web sources: 机构/网站 + 发布日期 + 标题

Examples

Example request

“参考 SEC filings，帮我做 AAPL 的定性分析，按模板输出。”

Example output shape

Use assets/report-template.md and fill each section with facts + citations. Unknowns become placeholders.

References

• Guardrails and writing style: references/prompt-guardrails.md

• Report template: assets/report-template.md

• Validation checklist: references/validation-checklist.md

• Goldenset examples: references/goldenset.md