wind-alice

A CLI tool that sends user questions + specified Alice Skills (both Chinese and English names are supported) to the Wind Alice Agent interface, pulls and prints
agentResult.value
in SSE streaming mode.

Key Mechanisms (Must Read)

Actual test shows that the Alice server does NOT select Skills via

selectedSkillIds

activatedSkills

, but through prompt text prefix:

text

Using "<English Skill Name>" skill:<original prompt>

At the same time, switch

chatMode

"12"

, set

originalChatMode

"4"

, and do not carry

metadata.agentCard

. This CLI has encapsulated this behavior in

buildBody

; external users only need to pass

--skill "<Skill Name>"

Therefore:

```
--skill
```
supports both Chinese and English names, not IDs. The following examples are equivalent:
- ```
--skill "上市公司调研问题清单"
```
  (Chinese nameZh)
- ```
--skill "Stock DD List"
```
  (English nameEn)
- ```
--skill "stock-dd-list"
```
  (English fuzzy match: ignore case/spaces/
```
-_
```
  )
After matching, the CLI unifiedly fills in the English name into the text prefix (the server recognizes Skills by English names).
Names not registered in
```
KNOWN_SKILLS
```
will prompt with
```
[warn]
```
, but still submit with the literal prefix (newly created/renamed Skills on the portal can be used immediately).

When to Use This Tool

Use it if any of the following conditions are met:

Users explicitly say: "Run/call/execute ... with Alice", "Run ... with Wind's XX Skill".
Users specify a professional sub-Skill of Alice (such as "Listed Company Research Question List", "Company One-Page Memo", "Fact Verification", "Stock Selection by Theme", etc.).
Users' questions highly match the capabilities of a certain Skill, and they expect to use the professional link instead of auto-routing.

Scenarios where this tool should NOT be used: Users only ask ordinary financial questions and don't care which sub-Skill is used — let Alice handle auto-routing (do not pass

--skill

Invocation Method (Agent Workflow)

Receive user question → determine the Skill:
- If the user specifies a Skill → directly pass the Chinese or English name of the Skill to
```
--skill
```
  (the script will automatically normalize and fill in the English name);
- If the user does not specify a Skill but the question clearly belongs to a certain Skill (such as "Verify Facts", "Company Research Question List", "Financial Report Review") → suggest and confirm with the user before specifying;
- Otherwise, do not pass
```
--skill
```
  and use auto-routing.
Before initiating the call, inform the user with one sentence: Alice professional Skills usually take several minutes to over ten minutes (complex research reports, one-page memos, comparable analysis, etc. take longer), which is normal. Please wait patiently, do not cancel the command midway or repeatedly initiate the same request.
Locate this tool's directory first: In the commands below,
```
scripts/wind-alice.mjs
```
is relative to the
```
wind-alice
```
directory where this
```
SKILL.md
```
is located. If the current working directory is not this directory, run
```
cd
```
to enter it first.
Execute (any of the following works):

bash

node scripts/wind-alice.mjs --prompt "<USER_QUESTION>" --skill "<Chinese Skill Name>"
node scripts/wind-alice.mjs --prompt "<USER_QUESTION>" --skill "<English Skill Name>"

After the streaming output ends, summarize and reply to the user based on
```
agentResult.value
```
. If there is no new output in the terminal for a long time during waiting, continue to wait until the process exits, do not misjudge it as stuck.

You can also list known Skills for users to choose first:
bash
node scripts/wind-alice.mjs list-skills

One-Time Configuration

Node.js 18+ (comes with
```
fetch
```
).
Configure WIND_API_KEY:
- Priority:
```
WIND_API_KEY
```
  environment variable >
```
config.json
```
  in this tool's directory (
```
{"wind_api_key":"..."}
```
  ) >
```
%USERPROFILE%\.wind-aifinmarket\config
```
  (dotenv:
```
WIND_API_KEY=...
```
  ).
- Key acquisition entry: https://aifinmarket.wind.com.cn/#/user/overview.
Optional: Override the default interface address with
```
WIND_ALICE_API_URL
```
.

Security Requirements

Never output the real

WIND_API_KEY

, Bearer token, content of

config.json

%USERPROFILE%\.wind-aifinmarket\config

If you need to explain the download method, only show the placeholder format like
```
Authorization: Bearer <WIND_API_KEY>
```
; do not create curl, PowerShell or HTTP examples with real Keys.
The report URL returned by Alice can be used for delivery and download in the current user session; use placeholder URLs when writing to READMEs, examples, work orders, submission information and other long-term materials.

File Download Handling

Many Skills (Company One-Page Memo / Research Question List / Quarterly Report Review / Market Size Estimation / Comparable Company Analysis, etc.) will attach a downloadable file link at the end of

agentResult.value

At the end of each call, the CLI will automatically scan for downloadable file links in the value, directly use
WIND_API_KEY
as the Bearer Token to download to the current working directory, and print the download result (saved path or failure reason) to stderr:

text

=== Detected 1 downloadable file, downloading to current directory: <cwd> ===
- <File Name>
  Saved to: <cwd>\<File Name>

Important Facts:

The file interface and Agent interface share the same
WIND_API_KEY
(i.e., the apiKey provided by Wind AIFin Market). The CLI internally uses
```
Authorization: Bearer <WIND_API_KEY>
```
for HTTP GET downloads.
The download target directory is the current directory where the user executes the command (
```
process.cwd()
```
); if there is a conflict with existing files of the same name, suffixes like
```
 (1)
```
,
```
 (2)
```
will be automatically added, and existing files will not be overwritten.
The CLI will not print the Key to logs; download results only appear in stderr and will not pollute the main body of
```
agentResult.value
```
in stdout.
Download failures (401 / 403 / network exceptions, etc.) will only print the failure reason + original URL, and will not affect the exit code of the main process.

After the call ends, there is no need to explain "how to download" to the user; directly tell the user where the file is saved. Only when the CLI reports "download failed" do you need to inform the user of the URL and failure reason for troubleshooting.

Mandatory Requirements

Must explicitly use UTF-8 when reading this document in PowerShell: For example,
```
Get-Content -Encoding UTF8 skills\wind-alice\SKILL.md
```
; if you see garbled Chinese characters, re-read it in UTF-8 first, do not execute based on garbled content.
--skill
accepts Chinese or English Skill names (consistent with
```
KNOWN_SKILLS
```
/ portal). The script will match in the order of nameEn → nameZh → normalize(nameEn) → normalize(nameZh); after matching, it will unifiedly use
nameEn
to fill in the text prefix for submission, and the server must see the English name to recognize it. Chinese aliases/abbreviations/spoken expressions will not be automatically translated; do not translate arbitrarily; run
```
list-skills
```
if unsure.
Prompt must not be empty: If it is blank or missing, exit directly with code 2 without sending a request.
Do not print the Key to logs: The script only uses it in the
```
Authorization
```
header and will not output it to stdout/stderr.
Must wait for streaming to end: The CLI has already
```
await
```
the child process exit between parent and child processes; do not change it to "return immediately after sending".
Time-consuming expectation and patience reminder: Must remind the user that Alice Skills may be slow before calling; do not interrupt the CLI, switch to other tools or repeatedly call the same task in parallel due to long waiting time.
Do not arbitrarily construct old fields like
selectedSkillIds
/
agentCard
to specify Skills — it has been tested to be ineffective, must use the text prefix.

Update Notification Handling

After each call to wind-alice.mjs, check if stderr contains prompts prefixed with

[wind-skills]

New version detected (
```
New version available
```
): Must inform the user once when seeing it for the first time in the same session (do not repeat in subsequent calls in the same session); bring the list and the full line of
```
Upgrade command:
```
to the user. Whether the command includes
-g
is automatically determined by the script based on the lock source (global installations include
```
-g
```
, project installations do not; Gitee source will be changed to
```
npx skills add ...
```
for reinstallation), directly copy it without adding or removing
```
-g
```
by yourself.
Update check failed (
```
Failed to check for updates
```
) or Cannot confirm (
```
Cannot confirm if it is the latest version
```
): This is just an update check reminder and does not affect the current Alice call; briefly inform the user once when seeing it for the first time in the same session, do not repeat the prompt, and do not treat it as a main call failure. If you encounter version-related errors, you can suggest the user upgrade the tool (the command is subject to the
```
Upgrade command:
```
output in the actual stderr).

wind-alice

NPX Install

Tags

SKILL.md Content (Chinese)

wind-alice

Key Mechanisms (Must Read)

When to Use This Tool

Invocation Method (Agent Workflow)

One-Time Configuration

Security Requirements

File Download Handling

Mandatory Requirements

Update Notification Handling