美股雷达（US Stock Radar）

以三种模式运行一套实用的美股分析工作流：

• screener：基于多因子信号分值对股票代码（ticker）集合进行排序
• deep-dive：结合基本面与技术面代理指标，深入分析单只股票
• watchlist：监控自定义股票列表，并输出潜在预警标的

本技能属于只读式启发式市场工作流，并非完整的机构级研究终端。所调用的公开免费接口可能存在数据不全、延迟或限频等问题；需明确揭示此类缺陷。

工作流

1. 使用对应模式运行 scripts/us_stock_radar.py 脚本。
2. 优先阅读 JSON 输出结果；将其视为唯一可信源。
3. 在结论解释中明确注明前提假设、置信度及数据缺口。
4. 避免做出确定性预测；仅呈现信号等级、触发原因及部分数据缺失警告。
5. 若某些接口调用失败，则降级继续执行，并显式暴露置信度下降情况。

快速审计路径

如需快速审查：

1. 运行 python3 skills/us-stock-radar/scripts/us_stock_radar.py --sources
2. 运行 python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode screener --json
3. 确认脚本仅发起只读型公共 HTTP 请求。
4. 验证当覆盖范围不全时，是否明确暴露 availability、data_gaps 和 degraded_mode 字段。

命令

python3 skills/us-stock-radar/scripts/us_stock_radar.py --sources
python3 skills/us-stock-radar/scripts/us_stock_radar.py --version
python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode screener --tickers "AAPL,MSFT,NVDA,AMZN,GOOGL"
python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode deep-dive --ticker AAPL --audience pro
python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode deep-dive --ticker TSLA --audience beginner --lang zh
python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode watchlist --tickers "AAPL,NVDA,TSLA" --event-mode high-alert
python3 skills/us-stock-radar/scripts/us_stock_radar.py --mode screener --json

安全边界 / 范围约束

• 只读技能：仅查询公开市场接口。
• 不使用任何身份认证、Cookie、券商账户或私有 API。
• 不提交任何订单、不执行任何交易、不修改任何投资组合状态。
• 在常规使用过程中不写入文件、不发送任何出站消息。
• 仅生成分析结果；不构成投资建议。

输出策略

• 默认语言行为：auto。
• 若指定 --lang auto 且提示中含中文内容，则最终叙述切换为中文。
• 若指定 --lang auto 且未检测到中文，则使用英文。
• --json 输出与语言无关。
• 必须始终包含以下字段：
  • as_of_utc
  • mode
  • event_mode
  • availability
  • data_gaps
  • degraded_mode
  • confidence
  • sources
  • 启发式说明 / 免责备注
• 受众模式：
  • pro：简洁信号摘要
  • beginner：通俗语言解读
• 事件模式：
  • normal
  • high-alert（采用更严格阈值）

评分体系（A/B/C/D）

信号分值综合多项启发式检查，例如：

• 估值区间（PE）
• RSI 健康度
• 成交量扩张
• 股价相对于 MA50 的位置
• 营收增长率
• ROE 质量

评级标准：

• A：分值 ≥ 5
• B：分值 = 4
• C：分值 = 2–3
• D：分值 ≤ 1

解读约束规则

• 评级仅为启发式汇总，非价格目标。
• 若基本面数据缺失，应降低整体置信度，而非默认隐式偏向看涨/看跌。
• 公开市场接口可能延迟、数据不完整，或因地域限制被屏蔽。
• 盘前时段 / 定时工作流须显式标注时间戳。

数据源

• Yahoo Finance 行情 API：/v7/finance/quote
• Yahoo Finance 图表 API：/v8/finance/chart
• Yahoo Finance quoteSummary API：/v10/finance/quoteSummary
• Stooq 公共备用源：日行情 / 历史 CSV 接口