Macro Data Interpretation（Wind Alice-宏观数据解读）

通过 alice-macro-data-interpretation 调用 Wind Alice Agent，将宏观经济数据一键解读为结构清晰、可直接复用的研究周报式分析。

核心原则：基础设施交给脚本处理；Agent 只负责把用户的宏观数据问题拼成一句自然语言 prompt 传入。默认就执行 Macro Data Interpretation 技能，无需也不要再指定其它 Skill。 任务完成后，只将 CLI stdout 中的 agentResult.value 原文原样交给用户；CLI 静默下载的附件（reportFullFile=）不要读给用户看。

宿主 Agent：执行任何 shell 命令前必须先读同目录 AGENT.md（一页执行契约，与 IDE 无关，随 skill 包发布）。

---

何时调用本技能

将宏观经济数据解读为结构清晰、可直接复用的研究周报式分析。输入一个或多个宏观指标（CPI、PPI、PMI、GDP、社融、外贸、失业率、利率等），输出包含结论摘要、核心数据、趋势与结构分析、后续跟踪展望的定性研究内容。适用于买方研究员、宏观策略师、财富管理顾问等需要快速形成数据观点的金融专业人士。

适用场景

| 场景 | 解决的问题 | | ------------------ | ---------------------------------------------------- | | 月度数据快速解读 | CPI、PPI、PMI 等月度数据发布后的快速解读与观点提炼 | | 季度/年度趋势分析 | GDP、社融、外贸等季度/年度数据的趋势与结构研判 | | 异常波动驱动分析 | 宏观指标异常波动的驱动因素与分项拆解 | | 多指标联动研判 | 多指标联动的结构性特征与相互印证关系 | | 政策效果数据验证 | 政策效果的数据验证与后续跟踪要点 |

核心能力

1. 结论摘要

   • 一句话核心观点与数据发布后的市场含义
   • 与预期、前值、市场一致预期的对比判断
   • 对政策与市场情绪的定性影响评估

2. 核心数据呈现

   • 关键指标读数、同比/环比、分项明细
   • 历史对比与季节性调整后的解读
   • 数据口径说明与可比性提示

3. 趋势与结构分析

   • 短期走势与中期趋势判断
   • 分项结构、区域/行业分化特征
   • 驱动因素拆解（内需/外需、供给/需求、基数效应等）

4. 后续跟踪展望

   • 需持续跟踪的高频指标与事件
   • 情景假设与风险点提示
   • 对资产类别/行业的传导含义（定性）

试试这样问

• "2025年1月CPI数据怎么看？"
• "最新PMI数据反映了什么信号？"
• "解读一下最新的社融数据"
• "分析2024年四季度GDP增长情况"
• "如何看待近期PPI的持续下行？"

输出形式

• Agent 向用户展示的内容：CLI stdout 中的 agentResult.value 正文（服务端流式返回）
• 自动生成的结构化内容包含：结论摘要、核心数据、趋势与结构分析、后续跟踪展望
• 部分场景下 CLI 会静默把完整报告附件下载到用户 Downloads/ 文件夹或 -d 指定目录（供用户本地查阅）；Agent 向用户展示时只用 agentResult.value，不要粘贴附件正文
• 数据受限时在对应模块明确标注

💡 使用提示

• 明确指标名称和时间范围可获得更精准的分析
• 系统会自动获取核心数据、历史对比和分析框架
• 输出为结构化研究报告，包含数据、趋势、驱动因素和展望

触发场景与 prompt 构造

用户提问命中以下任一场景即可调用：CPI/PPI/PMI 月度数据解读、GDP/社融/外贸季度趋势分析、宏观指标异常波动驱动分析、多指标联动研判、政策效果数据验证与跟踪。

把宏观指标名称、时间范围与关注角度拼成一句自然语言。不要加 使用「...」技能： 前缀，CLI 内部已自动注入。

---

CLI 参数

<SKILL_DIR> = 本文件所在目录绝对路径。Windows 一律用方案 A（PowerShell 5.x 不支持 &&，见 AGENT.md「命令模板」与「禁止写法（Windows）」）；macOS / Linux 用 node scripts/cli.mjs。

命令行调用

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" --prompt "<USER_QUESTION>" --no-wait [-d "<DIR>"] [--new]

# macOS / Linux
node scripts/cli.mjs --prompt "<USER_QUESTION>" --no-wait [-d "<DIR>"] [--new]

参数

| 参数 | 说明 | |------|------| | --prompt, -p | 用户提问（研究对象 + 关注角度，自然语言）。必填；CLI 自动加 使用「宏观数据解读」技能： 前缀，Agent 不要再加 | | --no-wait | Agent 默认必带——CLI 内部自旋 tasks/get 直到终态。默认 60s 一次探针、每轮 30min、全程 60min；到轮上限 CLI 自动续轮；Agent 禁止外层 Start-Sleep 或连发多条 | | -d, --download-dir | 报告附件落地目录；不传则用户 Downloads/ 文件夹（Windows %USERPROFILE%\Downloads）。不存在自动创建；同名冲突自动加 (1) 后缀，绝不覆盖 | | --new | 用户明确要求并行新建时清除本地记录后新建；须先 check-conflict 询问用户 | | --continue-session | 显式请求延续上一次多轮会话上下文（opt-in）。默认每次 CLI 调用视为全新会话，contextId 每次新生成，避免跨 Agent / 跨话题的 context 污染。宿主 Agent 判定为同一会话追问时（省略式追问 / 明确承接前文 / 代词指代等）应自动加此参数，不再要求用户显式说「接着刚才那个话题继续」。CLI 会复用上次落盘的 contextId（不设时间窗口）；无落盘记录时退化为新会话。与 --new 正交：--new 决定是否新建 taskId、--continue-session 决定是否复用 contextId | | --new-session | 显式强制新建会话上下文（与默认行为一致，保留兼容旧脚本）。与 --continue-session 同时给时以 --new-session 为准 | | --session-scope <ID> | 宿主 Agent 会话隔离标识（推荐始终传入）。同一 OS 用户下 Cursor / Trae 等宿主 Agent 默认共享 ~/.wind-aifinmarket/current-session.json；不隔离会出现"A Agent 的续接读到 B Agent 的 contextId"这类跨宿主污染。传入 <ID> 后按 current-session.<ID>.json 隔离到宿主自己的文件。也可用环境变量 WIND_ALICE_SESSION_SCOPE 统一设置（命令行 --session-scope 优先）。非法字符（空格 / 冒号 / 路径分隔符 / 中文等）自动替换成 _，长度上限 64 | | --once | 配合 --no-wait，单次探针；仅脚本调试，Agent 禁止外层循环 | | --no-strict | 关闭 strict 模式（默认开启：未输出 DONE 行时 exit=0 改成 6）；Agent 禁止传 | | --watch-interval / --watch-timeout / --watch-absolute-max | 自旋节奏与上限调优（秒），通常默认即可 | | --help, -h | 查看帮助 |

已废弃：--watch / -w（--no-wait 默认即内部自旋）。

调用示例

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" -p "2025年1月CPI数据怎么看" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" -p "解读一下最新的社融数据" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" -p "最新PMI数据反映了什么信号" --no-wait -d "D:\reports\macro"
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" -p "重新分析宁德时代" --no-wait --new   # 仅用户说"重新跑"才加

# macOS / Linux
node scripts/cli.mjs -p "2025年1月CPI数据怎么看" --no-wait
node scripts/cli.mjs -p "解读一下最新的社融数据" --no-wait
node scripts/cli.mjs -p "最新PMI数据反映了什么信号" --no-wait -d "/reports/macro"
node scripts/cli.mjs -p "重新分析宁德时代" --no-wait --new

附件用 WIND_API_KEY 自动鉴权下载到 Downloads/ 或 -d 目录（CLI 在 DONE 行给出 reportFullFile= 路径仅供落盘核对）；Agent 交付用户时只用 agentResult.value，不要展示下载附件内容。

子命令

只读 / 配置类，不消耗服务端额度：

| 子命令 | 用途 | |--------|------| | apikey-set <KEY> / apikey-get / apikey-clear | 写入 / 查看（脱敏）/ 清除 ~/.wind-aifinmarket/config.env 中的 API Key | | status --prompt <Q> | 查询本地 tasks.json 中该 prompt 最近一条任务的落盘路径 | | check-conflict --prompt <Q> | 主调用前的并发预检：检测是否有同/相似 prompt 的 running 任务。无冲突 → exit=0；命中 → exit=11，stdout 列出 EXISTING_TASK ...，Agent 必须把详情列给用户、由用户三选一（attach / --new / 取消）。详见 AGENT.md「check-conflict 后用户三选一」 |

解析下载目录意图

扫描用户对话中是否说过"下载到 X / 保存到 X / 放到 X 目录"。

• 命中 → 用 -d "<DIR>" 传入（多次指定取最近一次，含空格的路径必须加双引号）。
• 未命中 → 不要传该参数；CLI 落到用户 Downloads/ 文件夹。

---

环境与配置

1. Node.js 18+

CLI 基于 Node.js（18+ 自带 fetch）。node -v 检查，未达标到 nodejs.org 下载。

2. 获取并配置 WIND_API_KEY

获取：浏览器打开 Wind Alice → 我的账号 → 总览，在「API Key」一栏点「生成」/「复制」（失效或泄漏点「重置」会让旧 Key 立即作废）。

写入（推荐用 CLI 子命令）：

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" apikey-set <KEY>
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" apikey-get
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\amdi.ps1" apikey-clear

# macOS / Linux
node scripts/cli.mjs apikey-set <KEY>    # 写入（KEY 裸值，不加引号）
node scripts/cli.mjs apikey-get          # 查看是否已配置 + 脱敏末四位
node scripts/cli.mjs apikey-clear        # 清除

CLI 把 Key 写到 ~/.wind-aifinmarket/config.env（Windows %USERPROFILE%\.wind-aifinmarket\config.env），dotenv 格式单行 WIND_API_KEY=...——这是唯一受支持的位置。历史路径仍可读取（同目录无后缀 config、旧目录 ~/.wind-alice/config.env 与 config），apikey-set 只写新路径。

手动写入（无 Node 运维场景）：

# macOS / Linux
mkdir -p ~/.wind-aifinmarket && printf 'WIND_API_KEY=...\n' > ~/.wind-aifinmarket/config.env && chmod 600 ~/.wind-aifinmarket/config.env

# Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.wind-aifinmarket" | Out-Null
"WIND_API_KEY=..." | Set-Content -Encoding ascii "$env:USERPROFILE\.wind-aifinmarket\config.env"

安全：CLI 不读环境变量，也不读 skill 目录内的 config.json——避免 Key 残留在 shell 历史 / CI 日志 / 提交记录。apikey-set / apikey-get stdout 仅回显脱敏 Key；macOS/Linux 会自动把文件权限收到 600。

配置位置与环境变量

| 路径 / 变量 | 内容 | 必备 | |-------------|------|------| | ~/.wind-aifinmarket/config.env（Win: %USERPROFILE%\.wind-aifinmarket\config.env） | dotenv：WIND_API_KEY=<KEY>，唯一受支持位置（不读环境变量、不读 skill 目录 config.json） | ✅ | | ~/.wind-aifinmarket/tasks.json | 本地任务注册表（CLI 自动维护） | 自动 | | ~/.wind-aifinmarket/results/<taskId>.md | 每条任务的 agentResult.value 落盘副本（stdout 截断时 Agent 可读） | 自动 | | WIND_ALICE_API_URL（环境变量） | Alice Agent 接口地址，默认 https://mcp.wind.com.cn/skills/alice，一般无需修改 | 否 |

兼容：历史路径仍可读取（同目录无后缀 config、旧目录 ~/.wind-alice/config.env 与 config），apikey-set 只写新路径。

中文乱码（Windows 必读）

根因：Node 输出 UTF-8 字节，Trae / PowerShell 5.x 管道捕获时默认按 GBK 解码 → live 输出变成 鏈繘绋嬪皢闃诲...，不是 CLI 坏了。

三层防护（由 CLI 自动提供）：

1. scripts/amdi.ps1：调用前切 UTF-8 代码页（Windows Agent 优先用它代替裸 node）。

2. ALICE_SESSION_LOG=：非 TTY 管道场景下，CLI 会把全部输出 tee 到 ~/.wind-aifinmarket/logs/<promptHash>.session.log（完整 64 位 promptHash，UTF-8 BOM）。只能读 stdout 打印的那条路径，禁止 view_folder logs/ 扫描：

   # ✅ 从本次 CLI stdout 复制 ALICE_SESSION_LOG= 的完整路径
   Get-Content -Path "$env:USERPROFILE\.wind-aifinmarket\logs\<promptHash>.session.log" -Encoding UTF8 -Tail 200 -Wait
   
   # ❌ 禁止：按 mtime 挑「最新」或只认 12 位前缀——不同 prompt（同公司）会落在不同文件
   

3. 落盘 .md（results/、Downloads/、--detach 日志）均带 UTF-8 BOM，Get-Content 即使不写 -Encoding UTF8 通常也能正确显示。

禁止：因 live 乱码就改 prompt 重试、连发多条 CLI、或手工 Start-Sleep 轮询 tasks.json。

查看 --detach 日志（避免中文乱码）

~/.wind-aifinmarket/logs/<hash>.log 由 CLI 以 UTF-8 写入。PowerShell 5.x 的 Get-Content 默认按 GBK 解码，会把 UTF-8 中文显示成 鏈繘绋嬪皢闃诲... 这类乱码——不是日志坏了，是读法错了。

# ✅ 正确：显式指定 UTF-8
Get-Content -Path "$env:USERPROFILE\.wind-aifinmarket\logs\969e4c647aae.log" -Encoding UTF8 -Tail 50 -Wait

# ❌ 错误：省略 -Encoding UTF8，中文 Windows 上几乎必乱码
Get-Content -Path "...\969e4c647aae.log" -Tail 50 -Wait

自新版 CLI 起，--detach 创建的日志文件会写入 UTF-8 BOM，部分环境下即使不写 -Encoding UTF8 也能正常显示；仍建议 Agent 始终带 -Encoding UTF8。

---

执行契约（七步流程 / 红线 / 完成判定 / replay / 退出码 / 交付顺序 / 会话续接 / 命令模板 / 自检清单）见 AGENT.md——唯一权威来源，本文不重复。 排障与常见问题（任务幂等性与停止行为、CLI 执行失败处理、Q&A）见 TROUBLESHOOTING.md。