fubon-cli Skill

Use this skill to execute fubon commands safely and return parseable results for downstream automation.

What This Skill Does

• - Executes fubon-cli command groups end to end.
• Keeps command usage aligned with actual CLI behavior.
• Returns standardized JSON output and error handling guidance.
• Supports order lifecycle workflows: login -> query -> place order -> verify -> adjust/cancel.

When To Use

Use this skill if the user asks for any of these intents:

• - Login/logout/session status for Fubon Neo.
• Place or manage stock/futures/options orders.
• Query inventory, unrealized PnL, settlement, balances, margin quota.
• Read market quotes, candles, trade details, movers, actives, snapshots, history.
• Subscribe to realtime market or callback streams.
• Manage conditional orders.
• Use natural language to produce trading commands (fubon ask, fubon chat).

Preconditions

1. 1. Install platform wheel for fubon_neo.
2. Install fubon-cli.
3. Ensure certificate files and account credentials are available.

Example:

CODEBLOCK0

Core Workflow

1. 1. Authenticate first.
2. Run requested query or order action.
3. Inspect success and error keys.
4. If placing an order, run follow-up query to confirm state.

CODEBLOCK1

Command Map

Auth

CODEBLOCK2

Command Surface

The Command Surface below lists the primary CLI entrypoints and example usages. These map 1:1 to the fubon-cli commands and are safe to invoke from automation when preconditions are met.

See the examples in the Command Map section for concrete invocations.

Stock

CODEBLOCK3

Account

CODEBLOCK4

Market

CODEBLOCK5

Realtime

CODEBLOCK6

Futures and Options

CODEBLOCK7

Conditional Orders

CODEBLOCK8

AI

CODEBLOCK9

Output Contract

Non-streaming commands:

CODEBLOCK10

Failure example:

CODEBLOCK11

Streaming commands output JSONL (one JSON object per line).

Execution Rules

1. 1. Never assume login state; check status or handle not-logged-in errors.
2. For orders, always confirm with fubon stock orders or equivalent query command.
3. For retriable failures (network/transient), retry conservatively once.
4. For parameter or auth failures, stop and surface exact error text.

Safety Boundaries

• - Do not expose raw credentials in logs or chat output.
• Encourage verification of symbol, quantity, price, and account index before order placement.
• Prefer non-production or low-risk validation paths for first-time automation.

Release Binding

This skill is version-bound with fubon-cli.

• - scripts/validate_skill_doc.py validates coverage.
• INLINECODE15 builds skill artifact.
• INLINECODE16 publishes to clawhub endpoint.
• CI/CD should publish skill after package release to keep tool and skill synchronized.

Version Binding

This skill's version must be kept in sync with the fubon-cli package version. The CI/CD pipeline is configured to build and publish the skill bundle immediately after a successful package release so the skill metadata (skill.manifest.json) and SKILL.md match the released package.

• - Use scripts/build_skill_bundle.py to create dist/skill artifacts tied to the current git tag or package version.
• Use scripts/publish_skill.py (requires CLAWHUB_API_TOKEN) to publish the bundle to the skill registry.