name: stock-analysis-skill description: Agent-first stock and market analysis skill for A-shares, Hong Kong stocks, and US stocks. Use when an agent needs structured stock analysis, market review, strategy-based analysis, or reusable command-line execution for equity research. Supports unified request/response contracts, Tushare-backed market data, news-search-assisted workflows, and deterministic scripts.
Stock Analysis Skill
Use this skill to run reusable stock and market analysis workflows for agents.
Primary workflow
- Start with a dry run to verify request normalization.
- Run the stock / market / strategy script needed by the task.
- Prefer structured responses for downstream chaining.
- Render Markdown only when the agent needs a human-readable report.
Executable entries
Run stock analysis request normalization:
python scripts/run_stock_analysis.py --stock 600519 --dry-run --pretty
Run market analysis request normalization:
python scripts/run_market_analysis.py --region cn --dry-run --pretty
Resolve a strategy resource:
python scripts/resolve_strategy.py 均线金叉 --pretty
References to load when needed
references/package-layout.md— read when you need to understand the package boundary.references/contracts.md— read when you need request/response fields.references/data-sources.md— read when checking runtime dependencies.references/strategies.md— read when mapping a user request to strategy YAML files.references/output-format.md— read when deciding how to return results.references/provider-import-migration.md— read when migrating legacydata_provider.*import paths.
Package boundary
Treat these as the primary skill surface:
SKILL.mdreferences/scripts/strategies/assets/src/stock_analysis_skill/（含providers/运行时数据访问层）
Treat these as engineering/support surfaces, not default user-facing entrypoints:
docs/support/tests/data_provider/（legacy import shim，canonical provider path 已迁到src/stock_analysis_skill/providers/；默认不告警，可用DSA_WARN_LEGACY_IMPORTS=1打开）
Current runtime boundary
- market data: Tushare
- news search: Bocha / Tavily / Brave / SerpAPI
- markets: CN / HK / US
- report templates:
assets/templates/
Do not assume API/Web/Docker fallback paths are part of the skill contract.
Prefer new code under src/stock_analysis_skill/.