@alphafox/cli 0.3.14 → 0.3.16

package/skills/trading/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-trading
-description: Running strategies (traders) — create, list, start, and stop. A trader is a live or paper strategy instance (grid, dca, copy, …), not a person.
-version: 0.3.14
+description: Running strategies (traders) — create, list, start, and stop. A trader is a live or paper strategy instance (grid, dca, copy, …), not a person. Default Engine create uses autoStart true (创建即开始). Use autoStart false only when the user asks to create without starting. After create or start, include https://www.alphafox.app/zh/dashboard/traders/{traderId}.
+version: 0.3.16
 ---
 
 # Running strategies (traders)
@@ -40,11 +40,17 @@ alphafox trading traders create --config @./create-trader.json --yes --format js
 
 `trading.traders.create` is `high-risk-write` and needs `--yes`. Copy creates follow whatever `risk` the schema reports — `--dry-run` first, then `--yes` when required.
 
+Default Engine create is **创建即开始**: set `autoStart` to `true` in the body. Omitting `autoStart` is not the same — the server treats a missing flag as do-not-start. Use `autoStart: false` only when the operator explicitly asks to create without starting (创建但不启动 / 暂时不开始 / 先创建不要跑). Do not create-then-`byId.start` as the default path.
+
+After a successful create (or a later start), include the trader dashboard URL from `alphafox-shared` (`https://www.alphafox.app/zh/dashboard/traders/{traderId}`).
+
+Create `config` must include `common.execution.leverage` unless the operator chose another value. Default **10**, matching the website form. Omitting it is not 10x — Engine uses **1x**.
+
 If a required field is missing, re-read the schema and ask the operator. Do not invent ids. The CLI has no authoring-session surface; instantiate from a definition, connector, and config.
 
 ## High-risk start / stop
 
-Read `alphafox schema trading.traders.byId.start` first. Body may only include documented fields (`reason` is optional).
+Read `alphafox schema trading.traders.byId.start` first. Start body is optional Engine fields (`startType`, `enableSLTPMonitoring`, `expectedCoverageType`). `{}` is valid. Do not send `reason`.
 
 ```bash
 alphafox schema trading.traders.byId.start --format json --no-input
@@ -54,7 +60,13 @@ alphafox trading traders byId start --traderId <id> --body '{}' --yes --format j
 
 Without `--yes`, CLI exits `10` with `confirmation_required`. Server still checks role/ownership.
 
-Stop: `POST /api/v1/trading/traders/{traderId}/stop` with the same `--dry-run` then `--yes` sequence.
+Stop requires `closePositions` (boolean). Ask the operator whether to flatten positions. Do not default. Do not send `reason`.
+
+```bash
+alphafox schema trading.traders.byId.stop --format json --no-input
+alphafox trading traders byId stop --traderId <id> --body '{"closePositions":false}' --dry-run --format json --no-input
+alphafox trading traders byId stop --traderId <id> --body '{"closePositions":false}' --yes --format json --no-input
+```
 
 ## Recovery