Akshare Stock Analyzer Skill

Skill 名称（推荐对外叫法）：

• - 中文：A 股盘中 + 趋势分析助手
• 英文：Stock-Analyzer

一个可单独开源、独立使用的“股票短期分析”技能，目录内自带完整脚本：

• - 拉取行情 + 计算指标（scripts/fetch.py）
• 应用自定义周+当天规则生成趋势/信号/评分（scripts/analyze.py）
• 数据源封装（scripts/txprovider.py 和 scripts/sinaprovider.py）
• 获取单只股票当日最新行情快照（scripts/real_time.py）

何时使用（When to use）

在这些场景下，应该触发/使用本 skill：

• - 用户说：分析某只 A 股/ETF 的近期走势、空头/多头趋势、风险情况
• 用户希望基于最近一周和当天的表现，判断：

- trend（多头/空头/震荡）
- weekly_change_pct / today_change_pct
- signal（buy/sell/hold）
- score（0~10 短期强弱评分）

• - 用户提到：

- “帮我看这只股票最近怎么样”
- “这票现在是多头还是空头”
- “最近一周跌这么多要不要走人”
- “用之前那套策略分析一下 A500、招商银行、方大炭素”等

不适用的场景：

• - 纯宏观新闻解读、公司基本面深度研究、不需要技术指标的长线判断
• 与 A 股无关的资产（例如美股、期货、加密货币），除非你另外扩展脚本

依赖脚本与环境（Existing workflow & environment）

本 skill 目录自带以下 Python 脚本（均在 scripts/ 子目录下）：

• - scripts/fetch.py

- 提供 fetch_with_indicators(symbol_or_name, start_date, end_date, adjust, prefer) - 负责： - 通过新浪优先、腾讯兜底的方式拉取日线行情 - 统一输出中文列：日期、开盘、收盘、最高、最低、成交量 - 计算：MA7 / MA14 / MA20 / MA60、MACD(12,26,9) 的 DIF/DEA/MACD、RSI14

• - scripts/analyze.py

- 提供： - analyze_single(ts_code: str, df: pd.DataFrame) -> AnalysisResult - AnalysisResult 字段已在文件顶部详细注释，包括： - trend / weekly_change_pct / today_change_pct - macd_* / rsi_* - signal / score - 均线结构与扩展字段：ma_pattern / ma_bias / ma_values / ma_spread - 趋势强度与风险相关：trend_strength / reversal_hint / risk_level - 更完整的字段说明见：scripts/analyze_result.md，可作为下游解读/LLM 的 schema 参考。 - 也提供命令行用法示例（可选）： - INLINECODE23

• - scripts/txprovider.py / scripts/sinaprovider.py

• - scripts/real_time.py

- 提供 get_today_quote(symbol_or_name) 以及 CLI：python scripts/real_time.py <symbol>： - 直接通过新浪 hq 实时 HTTP 接口（hq.sinajs.cn）获取盘口级实时数据； - 返回 JSON 字段包含：code, name, date, price, change_pct, open, high, low, volume, amount, turnover, market_cap, bids, asks； - 其中 bids/asks 为 1~5 档买卖盘列表（每项含 level/price/volume）； - 可将该 JSON 结果交给 scripts/real_time_result.md 中的 Prompt 模板，生成盘中中文解读报告。

运行本 skill 需要外部环境已安装：

• - Python 3.9+
• 第三方库：akshare、INLINECODE30

输入（Inputs）

从用户对话中，尽量提取这些信息：

• - 必填：

- 股票代码或名称，例如： - "招商银行"、"600036"、"方大炭素"、"159339"、"A500" 等

• - 可选：

- 时间范围： - 显式开始/结束日期：YYYYMMDD 或 YYYY-MM-DD - 或者“最近 N 天”：例如最近 60/120 个交易日 - 复权方式：不复权 / 前复权 / 后复权（"", "qfq", "hfq"） - 数据源优先级：新浪("sina") 或 腾讯("tx")

缺省策略：

• - 若用户未指定时间范围，默认用最近 120 个自然日对应的交易日数据。
• 若用户未指定数据源，默认优先新浪。
• 若用户未指定复权方式，默认不复权。

工作步骤（Workflow）

本 skill 分为两个典型使用场景，请不要混用：

• - 今日盘中行情查看：

- 只关心“今天涨跌多少、量价情况如何”的盘中快照； - 直接调用 scripts/real_time.py： - 例如：python scripts/real_time.py 方大炭素 - 返回一条包含价格、涨跌幅、成交量、盘口五档等信息的 JSON，不经过 fetch.py / analyze.py 日线流程； - 可结合 scripts/real_time_result.md 的输出规范，将该 JSON 转成结构化的盘中分析报告。

• - 日线趋势 / 策略分析：

- 需要结合最近一周 + 当天的日线数据，判断趋势、signal、score 等； - 才使用 fetch.py + analyze.py 这一整套日线分析流程（见下文步骤 1~5）。

当是“趋势 / 策略分析”场景时，按以下步骤工作：

1. 1. 解析用户意图和参数

- 从自然语言中解析出： - symbol_or_name - 时间范围（start_date/end_date 或 days） - prefer（sina/tx）和 adjust（"", "qfq", "hfq"） - 若信息缺失，向用户简短追问（优先问股票代码/名称）。

1. 2. 获取行情+指标数据

- 尽量以“导入模块 + 调用函数”的方式使用现有代码： - 从 scripts/fetch.py 导入 fetch_with_indicators。 - 调用： - 显式日期： - fetch_with_indicators(symbol_or_name, start_date, end_date, adjust, prefer) - 仅天数： - 先根据当前日期计算 start/end 字符串，再调用上面的函数。 - 如需快速验证，也可以使用 CLI 方式： - 在 skill 根目录下执行： - python scripts/fetch.py <symbol> --days 120 --prefer sina --adjust "" - 若数据拉取失败（网络错误、接口异常、代码错误），应： - 把错误信息简要反馈给用户 - 不要编造分析结果

1. 3. 调用策略分析引擎

- 优先方式：在 Python 环境中导入并直接调用： - from scripts.analyze import analyze_single - res = analyze_single(ts_code=symbol_or_name, df=df_with_indicators) - 或使用 CLI： - 在 skill 根目录下执行： - python scripts/analyze.py <symbol> --days 120 --prefer sina --adjust "" - 获取 AnalysisResult，可以通过： - asdict(res) 形式转换为普通字典，方便解读字段。 - 字段含义与推荐用法详见 scripts/analyze_result.md，便于后续自动化/NL 解读。

1. 4. 解释字段并生成自然语言结论

- 至少解释这些核心字段： - trend：当前是多头/空头/震荡趋势，简要说明依据（近期一周涨跌幅）。 - weekly_change_pct：最近一周涨跌幅（%），说明“这一周整体是涨还是跌、多大幅度”。 - today_change_pct：今天相对昨天的涨跌幅（%），说明“今天是大涨/小涨/小跌/大跌”。 - signal：当前信号是 buy / sell / hold，并说明触发的逻辑大致是什么。 - score：所在区间（例如 0~2 很弱、3~5 一般、6~8 偏强、9~10 很强）。 - 如用户关心，也可以简要提及： - macd_strength, macd_momentum, rsi_zone, rsi_trend 等作为辅助参考； - 均线结构与趋势强度：ma_pattern / ma_bias / ma_spread / trend_strength； - 风险与拐点：reversal_hint / risk_level，用于说明是否存在顶部/底部预警或趋势过度发散等风险。 - 若需要更系统、模板化的“交易员风格”解读，可在执行完 analyze.py 后，将 asdict(res) 结果连同 scripts/analyze_result.md 的字段说明，交给专门的解读模块（例如 scripts/analyze_data.md 中描述的规范）生成文本。

1. 5. 输出格式

- 使用简洁的中文分点说明： - 一条描述当前趋势（多头/空头/震荡） - 一条描述周涨跌幅 + 今日涨跌幅 - 一条说明 signal 和 score 的含义（例如“当前属明显空头，短期不建议参与”） - 一条风险提示：本分析基于技术指标和短期价格表现，不构成投资建议。

输出示例（示意）

趋势：空头（bearish）。最近一周累计下跌约 13.9%，整体处在明显下跌通道。
涨跌情况：今天相对昨天约 -2.5%，延续下跌，未见有效止跌信号。
信号与评分：signal = sell，score = 1（0~10 中偏底部区间，短期状态较差）。
结论：这只股票当前短期趋势偏弱，风险较高，不适合作为当前关注重点标的，如已持有可考虑减仓或观望处理。以上仅为技术面参考，不构成投资建议。

注意事项（Safety / Caveats）

• - 所有结论仅基于技术指标和短期价格表现，不考虑公司基本面、消息面等因素。
• 在表述时避免使用“必然、肯定、保证”等绝对化措辞，使用“偏强/偏弱/倾向于”等表述。
• 明确提醒用户：

- 本结论不构成投资建议。 - 投资决策需结合自身风险承受能力和更多信息谨慎判断。