trader-analyst 是一款专注财报季的 SEC 财报解读技能。它的目标是从公司实际向 SEC 申报的数字出发，按季度对齐、逐项说明变化，避免只读新闻稿里最亮眼的数字。
用途 该技能服务于收益季的财报分析：读取公司在 10-Q 与 10-K 中标记的 XBRL 公司事实数据，并找到最新的 8-K（含 item 2.02“Results of Operations”）及其 EX-99.1 新闻稿，用申报数字做主线、新闻稿做上下文补充。
主要能力
- 读取 https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json，获取公司所有已标记数字；读取公司 submissions 列表，定位最新 10-Q 或 10-K，以及最新含 item 2.02 的 8-K；进入该 8-K 文件夹查找 EX-99.1 新闻稿附件。
- 通过 --metrics 参数写出 trader/metrics.json，每家公司一行，包含 TTM 营收、净利润、稀释 EPS、最新利润率与增速，供 /trader-screener 使用。
- 示例文件 metrics.example.json 是 2026-10-13 对 AAPL、AXP、GOOGL、KO 和 BAC 的真实运行结果。
- 支持 --quarters 8 查看两年数据、--json 输出机器可读格式、--cik 处理无股票代码的公司。
使用方式 工具位于技能文件夹内，使用标准库 Python，无需密钥： python3 "${CLAUDE_SKILL_DIR}/facts.py" --help 运行前必须配置 SEC User-Agent（trader/config.json 中的 sec_user_agent，或环境变量 SEC_USER_AGENT），格式为“Your Name you@example.com”，需使用真实姓名与邮箱；缺少该信息时工具拒绝调用 SEC。示例调用： python3 "${CLAUDE_SKILL_DIR}/facts.py" AAPL python3 "${CLAUDE_SKILL_DIR}/facts.py" AAPL AXP GOOGL KO BAC --metrics trader/metrics.json 随后打开最新财报新闻稿（EX-99 链接）与 10-Q 阅读上下文，再撰写摘要：一句话说明本季营收、EPS、增速，一句话说明利润率，一句话说明异常情况（一次性项目、派生季度、数据滞后），并附上链接。用词平实，只用数字支持的事实，不加形容词。
规则与限制
- 以申报数字为先：表格来自公司申报的 XBRL 事实；新闻稿仅用于指引、分部信息等上下文，并注明数字来源。
- 同口径对比：增速对比去年同期；也会显示环比，但提示许多业务存在季节性（例如苹果 12 月季度通常是全年最大）。
- 明确派生数据：公司不申报 Q4 10-Q，第四季度由 10-K 全年减去其中三个季度得出，标注为“derived”，派生 EPS 为近似值。
- 提示数据滞后：SEC 事实 API 可能落后于申报；若最新 10-Q 晚于事实中的最新季度，工具会打印 NOTE 与链接，提示先读 10-Q 再总结。
- 标记一次性项目：当净利润高于营业利润时，说明其中包含营业外收益（投资计价、税务项目等）；银行与保险公司无毛利率，留空而非填零。
- 从不判断股票便宜、昂贵、买入或卖出，只报告公司申报内容；不编造申报中没有的数字，不估算无法派生的季度；无 User-Agent 不调用 SEC，并保持远低于每秒 10 次请求。
适用场景 适合财报季快速整理单家公司或多公司（如 trader/targets.json 中的全部代码）的申报数据、撰写基于申报数字的季度摘要，并为筛选器提供结构化指标。
安全说明 该技能定位为教育与工具用途，不构成财务建议，仅读取申报文件；除 /trader-broker 在 /trader-risk 通过且用户对该笔订单明确输入 yes 后外，不会下任何订单。