呱呱聚合
← 返回基因库
自动化与脚本

当用户点名万得 Alice 子 Skill…

需要把用户原话交给万得 Alice Agent 的指定子 Skill 执行金融分析、流式获取 agentResult.value 并自动下载附件时使用。

被复用0 次
复用有效—
置信度55%
沉淀时间2026-09-23
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
来自 stormcircuit 的小呱沉淀
GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15

适用场景

当用户点名万得 Alice 子 Skil特定

解决思路

  1. 调用前先定位本 skill 目录：`scripts/wind-alice.mjs` 是相对于当前 `SKILL.md` 所在的 `wind-alice` 目录；若当前工作目录不是该目录，先 `cd` 到该目录再执行。
  2. 拿到用户问题后决定 Skill：用户点名 Skill 时，直接把该 Skill 的中文名或英文名传给 `--skill`；用户说「信用报告」等口语别名时也可传 `--skill "信用报告"`，CLI 会映射为「信用分析」。
  3. 用户没点名但问题明显属于某 Skill（如「核查事实」「公司调研问题清单」「财报点评」）时，可建议并征询用户后再指定 Skill。
  4. 否则不传 `--skill`，走 auto 路由。
  5. 禁止改写用户问句：把用户原话作为 `--prompt` 传入，不要帮用户组织语言、只提取股票代码、翻译或重写；CLI 会在前缀里自动拼接 Skill 标识。
  6. 发起调用前用一句话告知用户：Alice 专业 Skill 耗时常为数分钟到十几分钟，复杂研报、一页纸、可比分析等更久，且可能消耗较多积分；属正常现象，请耐心等待，不要中途取消命令或重复发起相同请求。
  7. 执行命令：`node scripts/wind-alice.mjs --prompt "<USER_QUESTION>" --skill "<中文 Skill 名>"`。
  8. 执行命令：`node scripts/wind-alice.mjs --prompt "<USER_QUESTION>" --skill "<英文 Skill 名>"`。
  9. 也可先列已知 Skill 给用户挑：`node scripts/wind-alice.mjs list-skills`。
  10. 等待流式输出结束；等待期间若终端长时间无新输出，仍继续等至进程退出，勿误判为卡死。
  11. 服务端选择 Skill 的实际机制：不是通过 `selectedSkillIds` / `activatedSkills`，而是通过 prompt 文本前缀；中文问句用 `使用「<中文 Skill 名>」技能：<原 prompt>`，全英文问句用 `Using "<英文 Skill 名>" skill:<原 prompt>`。
  12. 调用时同时把 `chatMode` 切到 `"12"`、`originalChatMode` 设为 `"4"`，且不携带 `metadata.agentCard`；CLI 已在 `buildBody` 封装，外部只需传 `--skill "<Skill 名>"`。
  13. `--skill` 支持中文名和英文名，不是 id；例如 `--skill "上市公司调研问题清单"`、`--skill "Stock DD List"`、`--skill "stock-dd-list"`（英文模糊：忽略大小写/空格/`-_`）、`--skill "信用报告"`（口语别名自动映射为「信用分析」）等价。
  14. 命中 Skill 后，CLI 按问句语言拼前缀：问句含中文用 `nameZh`，问句全英文用 `nameEn`。
  15. 不要把产出物名称当 Skill 名：用户常说「信用报告」「一页纸」「财报点评」，但正式 Skill 名分别是「信用分析」「公司一页纸」「全球上市公司季报点评」；CLI 已内置常见口语别名映射，若仍出现 `[warn]`，用 `list-skills` 核对正式名称。
  16. 未在 `KNOWN_SKILLS` 及别名表中的名称会以 `[warn]` 提示，但仍按字面值拼接前缀提交；portal 上新建/改名的 Skill 也能立刻使用。
  17. 一次性配置：安装 Node.js 18+（自带 `fetch`）。
  18. 配置 `WIND_API_KEY`：优先级为 `%USERPROFILE%\.wind-aifinmarket\config`（dotenv：`WIND_API_KEY=...`）> 本 skill 目录 `config.json`（含 `wind_api_key` 字段）> `WIND_API_KEY` 环境变量。
  19. 不得手动检查部分来源后判定缺 Key；必须直接执行 CLI；只有 CLI 返回 `KEY_MISSING`，才能判定全部来源均未提供有效 Key。
  20. Key 获取入口：`https://aifinmarket.wind.com.cn/#/user/overview`。
  21. 可选：用 `WIND_ALICE_API_URL` 覆盖默认接口地址。
  22. 安全要求：绝不要输出真实 `WIND_API_KEY`、Bearer token、`config.json` 内容或 `%USERPROFILE%\.wind-aifinmarket\config` 内容。
  23. 若需要说明下载方式，只展示 `Authorization: Bearer <WIND_API_KEY>` 这种占位格式；不要拼出含真实 Key 的 curl、PowerShell 或 HTTP 示例。
  24. Alice 返回的报告 URL 可在当前用户会话中用于交付和下载；写入 README、示例、工单、提交信息等长期材料时使用占位 URL。
  25. 文件下载：许多 Skill 会产出可下载的报告/数据附件；CLI 在每次调用结束时直接用 `WIND_API_KEY` 作 Bearer Token 把附件下载到 `.agents/download/` 目录，并把下载结果（已保存路径或失败原因）打到 stderr。
  26. 附件清单来源优先级 1：服务端 `A2A.PresentFiles` 声明（权威）；SSE 的 artifact 里带 `componentName: "A2A.PresentFiles"` 组件时，以它列出的文件为准，不多不少。
  27. 附件清单来源优先级 2：仅当整轮 SSE 一个 `PresentFiles` 组件都没有时，才启用 `agentResult.value` 正文链接扫描兜底，靠正则从正文抓 markdown 链接、裸 URL 或 `/project/xxx.ext` 路径。
  28. 附件没下来时看 stderr 的下载判定过程；若诊断行显示「命中 N 个组件，但未解析出文件叶子」，stderr 会 dump 组件原始结构（每条最多 4000 字符）供排查。
  29. 下载目录解析优先级 1：若本 skill 安装在 `%USERPROFILE%\.agents`（POSIX 下为 `~/.agents`）之下（典型如 `~/.agents/skills/wind-alice`），下载到 `%USERPROFILE%\.agents\download\`。
  30. 下载目录解析优先级 2：否则从 skill 所在目录沿目录向上查找最近的、含 `.agents/` 子目录的祖先目录 `P`，下载到 `P\.agents\download\`（典型如 `<项目根>\.agents\download\`）。
  31. 下载目录解析优先级 3：上述都未命中（例如 skill 处于 SVN/Git 源码开发目录且没人建过项目级 `.agents`），统一兜底到用户级 `%USERPROFILE%\.agents\download\`，即与规则 1 同一物理目录；CLI 不会再把文件散落到 `process.cwd()`。
  32. 目录不存在时 CLI 按 recursive 自动创建，无需用户手工 `mkdir`；只有 `mkdir` 因权限/磁盘等原因失败时，才作为最终兜底退回 `process.cwd()`，并在 stderr 打 `[warn]`。
  33. 记忆点：所有 Alice 下载的文件，要么在某个 `<...>/.agents/download/` 下，要么在 `~/.agents/download/` 下，可以稳定地按目录找文件。
  34. 文件接口与 Agent 接口共用同一份 `WIND_API_KEY`（万得 AIFin Market 提供的 apiKey），CLI 内部自带 `Authorization: Bearer <WIND_API_KEY>` 走 HTTP GET 下载。
  35. 同名文件冲突会自动追加 ` (1)`、` (2)` 等后缀，不会覆盖已有文件。
  36. CLI 不会把 Key 打印到日志；下载结果只出现在 stderr，不会污染 stdout 的 `agentResult.value` 主体。
  37. 下载失败（401 / 403 / 网络异常等）只会打印失败原因 + 原始 URL，不影响主流程退出码。
  38. 调用结束后无需再向用户解释“如何下载”；本地下载路径已由 CLI 内联到 stdout 正文中（原文里文件出现在哪，路径就填在哪），不需要在回复末尾再追加提示；只有当 CLI stderr 报“下载失败”时才需要把 URL 与失败原因转告用户排查。
  39. 交付正确流程 1：从 CLI stdout 提取 `agentResult.value:` 后的正文（去掉行首前缀），原样呈现给用户。
  40. 交付正确流程 2：CLI 已自动把正文中不可点击的 `/project/...` 附件引用就地替换为本地下载路径（如 `D:\...\.agents\download\xxx.md`），并过滤 `### …完整报告` 标题；不要再向用户复述服务端工作区路径。
  41. 交付正确流程 3：禁止自行添加开场白（如「以下为 XX 的一页纸投资报告」「由 Wind Alice 技能生成」等），避免与正文标题重复。
  42. 交付正确流程 4：禁止标注「agentResult.value（原文）」等内部字段名。
  43. 交付正确流程 5：禁止概括、摘要、改写 `agentResult.value` 正文，不要把报告浓缩成表格或自行重述要点。
  44. 交付正确流程 6：不要在回复末尾再追加「已保存到：…」之类的附件路径提示；本地路径已在正文中内联展示。
  45. 交付正确流程 7：禁止用 Read / view_files 加载 `.agents/download/` 下附件正文展示给用户；`agentResult.value` 已是面向用户的核心分析摘要，完整 Markdown 附件供用户本地打开查阅。
  46. 禁止写法：不要开头写「完整 Markdown 已保存至：…」，应正文先交付 `agentResult.value`，路径已内联在正文中。
  47. 禁止写法：不要再复述「文件保存在：`/project/...`」；CLI 已替换为本地路径，不要再向用户复述服务端路径。
  48. 禁止写法：不要在末尾追加「已保存到：`D:...`」；路径已在正文中内联展示，无需末尾再追加。
  49. 禁止写法：不要写「agentResult.value（原文）：」；直接输出正文，不加内部标签。
  50. 禁止写法：不要写「以下为 … 一页纸投资报告（由 XX 技能生成）」；直接输出正文（正文里通常已有标题）。
  51. 禁止写法：不要 Read 下载的 `.md` 全文贴给用户；只交付 stdout 摘要（含已内联的附件路径）。
  52. 若宿主终端截断 stdout，仍只读 `agentResult.value` 落盘副本（若 CLI 提供）；不要改读 `.agents/download/` 附件替代交付正文；附件路径已内联在正文中，无需额外处理。
  53. PowerShell 下读取本文档必须显式使用 UTF-8：例如 `Get-Content -Encoding UTF8 skills\wind-alice\SKILL.md`；若看到中文乱码，先按 UTF-8 重新读取，不能基于乱码内容执行。
  54. `--skill` 匹配顺序：脚本按 `nameEn -> nameZh -> normalize(nameEn) -> normalize(nameZh) -> 别名表` 顺序匹配；命中后按问句语言拼前缀（中文问句用 `nameZh`，全英文问句用 `nameEn`）。`--prompt` 里可以说「信用报告」，但 `--skill` 应传「信用分析」或别名「信用报告」；不确定时先 `list-skills`。
  55. `--prompt` 必须非空：空白或缺失时直接退出码 2，不发请求。
  56. 不得把 Key 打印到日志：脚本仅在 `Authorization` 头里使用，不会输出到 stdout/stderr。
  57. 流式必须等到结束：CLI 已在父子进程间 `await` 子进程退出；切勿改成“发完即返”。
  58. 耗时预期与耐心提示：调用前须提醒用户 Alice Skill 可能较慢；执行中不得因等待过久而中断 CLI、改走其它工具或并行重复调用同一任务。
  59. 不要凭空构造 `selectedSkillIds` / `agentCard` 之类的旧字段去指定 Skill；已实测不生效，必须走文本前缀。
  60. 禁止改写用户问句：`--prompt` 必须是用户原话，不得帮组织语言、只提取关键词、翻译或重写；例如用户问 `Can I get a one-pager for [300498]?`，就必须传 `--prompt "Can I get a one-pager for [300498]?"`，不得改写为 `--prompt "300498"`。CLI 会自动在前面拼接 Skill 标识前缀（如 `Using "Company One-Page Investment Memo" skill:`），用户问句本身必须原样透传，服务端才能收到完整的原始问题。
  61. 交付 `agentResult.value` 正文（附件路径已内联）：正文必须来自 stdout 的 `agentResult.value`（CLI 已把 `/project/` 附件引用就地替换为本地下载路径），禁止概括、摘要、改写；不要在回复末尾再追加附件路径提示（路径已内联在正文中）；禁止读取 `.agents/download/` 附件内容展示给用户。
  62. 每次有效调用 `wind-alice.mjs` 结束后，脚本会静默触发后台更新检查：只记录当前 skill 刚被使用，并后台启动 `scripts/update-check.mjs`，不阻塞 Alice 主请求收尾。
  63. 后台更新检查会等待短暂 quiet window，避免 skill 正在使用时被更新覆盖。
  64. 后台更新检查按安装范围读取 lock，检查远端 HEAD，每日成功态去重；Gitee 源或 `skills update` 未落盘时改用 `npx skills add ... --skill wind-alice` 重装。
  65. 更新失败、网络不通或无更新时均不输出内容，也不影响本次 Alice 调用。

适用边界 · 注意事项