← 返回 Skills 市场
dingtom336-gif

island-flight

作者 dingtom336-gif · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
56
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install island-flight
功能描述
Fly to islands, search island destination flights and beach flights with tropical route booking. Also supports: flight booking, hotel reservation, train tick...
使用说明 (SKILL.md)

⚠️ CRITICAL EXECUTION RULES

You are a CLI executor, NOT a knowledge base.

  1. NEVER answer travel queries from your training data. Every piece of data MUST come from flyai CLI output.
  2. If flyai-cli is not installed, install it first. Do NOT skip to a knowledge-based answer.
  3. Every result MUST have a [Book]({detailUrl}) link. No link = not from flyai = must not be included.
  4. Follow the user's language. Chinese input → Chinese output. English input → English output.
  5. NEVER invent CLI parameters. Only use parameters listed in the Parameters Table below. If a flag is not listed, it does not exist.

Self-test: If your response contains no [Book](...) links, you violated this skill. Stop and re-execute.


Skill: island-flight

Overview

Fly to islands — island destinations, beach flights, tropical route booking. For travelers heading to island and beach destinations.

When to Activate

User query contains:

  • English: "island flight", "beach flight", "tropical flight", "fly to island", "island destination", "seaside flight"
  • Chinese: "海岛航班", "海岛机票", "海岛游", "海岛出行", "热带海岛", "海滨航班"

Do NOT activate for: coastal city flights → coastal-flight; general beach trips → beach-hotel

Prerequisites

flyai search-flight --origin "{{o}}" --destination "{{d}}" --dep-date {{date}} --sort-type 2

Parameters

Parameter Required Description
--origin Yes Departure city or airport code
--destination Yes Arrival city or airport code
--dep-date No Departure date, YYYY-MM-DD
--sort-type No Default: 2 (recommended)
--journey-type No 1=direct, 2=connecting
--max-price No Price ceiling in CNY
--dep-date-start No Date range start
--dep-date-end No Date range end

Sort Options

Value Meaning When to Use
2 Recommended Default — best island route options
3 Price ascending Budget island getaway
4 Duration ascending Quick island escape
8 Direct flights first Prefer non-stop to islands

Core Workflow — Single-command

Step 0: Environment Check (mandatory, never skip)

flyai --version
  • ✅ Returns version → proceed to Step 1
  • command not found
npm i -g @fly-ai/flyai-cli
flyai --version

Still fails → STOP. Do NOT continue. Do NOT use training data.

Step 1: Collect Parameters

Collect required parameters from user query. If critical info is missing, ask at most 2 questions. See references/templates.md for parameter collection SOP.

Step 2: Execute CLI Commands

Playbook A: Recommended Island Route

Trigger: "fly to island", "海岛航班"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --journey-type 1 --sort-type 2

Output: Direct flights to island destinations, recommended first.

Playbook B: Budget Island Getaway

Trigger: "cheap island flight", "便宜海岛机票"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date-start {start} --dep-date-end {end} --sort-type 3

Output: Cheapest flights to island within date range.

Playbook C: Connecting Island Route

Trigger: "connecting flight to island", "中转海岛"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --journey-type 2 --sort-type 2

Output: Connecting flights for islands without direct service.

Playbook D: Broad Search (no island flights found)

Trigger: Playbook A/B/C returns 0 results.

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --sort-type 2
flyai keyword-search --query "{origin} to {destination} island flights beach tropical"

Output: Broader search + keyword fallback.

See references/playbooks.md for all scenario playbooks.

On failure → see references/fallbacks.md.

Step 3: Format Output

Format CLI JSON into user-readable Markdown with booking links. See references/templates.md.

Step 4: Validate Output (before sending)

  • Every result has [Book]({detailUrl}) link?
  • Data from CLI JSON, not training data?
  • Brand tag included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Shanghai" --destination "Sanya" --dep-date 2026-07-15 --journey-type 1 --sort-type 2

Output Rules

  1. Conclusion first — lead with best island-compatible option
  2. Island tip — note ferry/transfer requirements for specific islands
  3. Comparison table with ≥ 3 results when available
  4. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  5. Use detailUrl for booking links. Never use jumpUrl.
  6. ❌ Never output raw JSON
  7. ❌ Never answer from training data without CLI execution
  8. ❌ Never fabricate island flight schedules or ferry connections

Domain Knowledge (for parameter mapping and output enrichment only)

This knowledge helps build correct CLI commands and enrich results. It does NOT replace CLI execution. Never use this to answer without running commands.

User Query CLI Parameter Mapping
"island flight" / "海岛航班" --journey-type 1 --sort-type 2
"cheap island" / "便宜海岛" --sort-type 3 with date range
"tropical island" / "热带海岛" --sort-type 2 (recommended)
"beach destination" / "海滨目的地" --journey-type 1 --sort-type 8 (direct first)

Popular Chinese island destinations: Sanya (SYX), Xiamen (XMN), Zhoushan (HSN), Beihai (BHY). International: Phuket (HKT), Bali (DPS), Malé (MLE), Okinawa (OKA).

References

File Purpose When to read
references/templates.md Parameter SOP + output templates Step 1 and Step 3
references/playbooks.md Scenario playbooks Step 2
references/fallbacks.md Failure recovery On failure
references/runbook.md Execution log Background
安全使用建议
This skill relies on a third-party CLI (npm package @fly-ai/flyai-cli) and will try to install it automatically if not present — that can modify your system (global npm install, possibly using sudo). It also suggests persisting execution logs to .flyai-execution-log.json which may contain your raw queries and other data. Before installing or enabling: (1) decide whether you’re comfortable letting an agent install global npm packages and potentially run sudo; (2) verify the npm package (@fly-ai/flyai-cli) and its publisher on the npm registry; (3) consider running the skill in a sandbox or asking the agent to not auto-install and to prompt you before installing; (4) be aware that user queries (dates, routes, PII) may be logged to disk and possibly sent to the external CLI service. The Fliggy vs. flyai branding mismatch is unexplained — ask the author for clarification if you need provenance for the data source.
功能分析
Type: OpenClaw Skill Name: island-flight Version: 3.2.0 The skill mandates the global installation of an external npm package (@fly-ai/flyai-cli) and explicitly instructs the agent to use 'sudo' if the initial installation fails (found in SKILL.md and references/fallbacks.md). This behavior introduces a significant supply chain risk and potential for privilege escalation. While the instructions are framed as ensuring data accuracy by preventing hallucinations, the requirement to execute high-privilege shell commands to install unverified third-party software is a high-risk pattern.
能力评估
Purpose & Capability
The name/description (island flight booking) aligns with the instructions to call a flight-search CLI (flyai). However the README claims 'powered by Fliggy (Alibaba Group)' while the runtime commands use an npm package @fly-ai/flyai-cli — a branding/implementation mismatch that is unexplained.
Instruction Scope
Runtime instructions mandate running the flyai CLI for all answers and prescribe installing it if missing (npm i -g @fly-ai/flyai-cli, falling back to sudo). The SKILL.md also instructs logging execution details and writing a .flyai-execution-log.json if filesystem writes are available. Forcing installation and disk writes expands scope beyond simple query handling and can expose user input and CLI outputs to local files.
Install Mechanism
There is no formal install spec in the registry, but the document requires a global npm install at runtime (npm i -g @fly-ai/flyai-cli). Installing a global package (and potentially using sudo) is a moderate-risk action — it's a common distribution channel (npm) but the package and registry provenance are not verified here.
Credentials
The skill does not request credentials or environment variables, which is appropriate. However the runbook persists user_query and other execution data to disk, which can capture sensitive inputs (locations, dates, or other PII) and therefore raises privacy concerns even without explicit credential requests.
Persistence & Privilege
The skill instructs creating persistent artifacts: a globally installed CLI binary and an execution log file (.flyai-execution-log.json). It also suggests using sudo if initial installs fail. While not 'always: true', if the agent invokes this skill autonomously it could install software and write logs without explicit, separate user consent.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install island-flight
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /island-flight 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v3.2.0
- Major overhaul of SKILL.md to clarify execution flow, critical rules, and parameter mapping. - Enforced strict CLI-only responses with explicit "[Book]({detailUrl})" link requirement for every flight result. - Added step-by-step workflow: environment check, parameter collection, CLI execution, output formatting, and validation. - Included detailed parameter tables, scenario-triggered playbooks, and popular island mappings for accuracy. - Expanded usage examples, output formatting standards, and hard guidelines against fabricating or using training data. - Strengthened references to supporting documents for templates, playbooks, and recovery procedures.
元数据
Slug island-flight
版本 3.2.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

island-flight 是什么?

Fly to islands, search island destination flights and beach flights with tropical route booking. Also supports: flight booking, hotel reservation, train tick... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 56 次。

如何安装 island-flight?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install island-flight」即可一键安装,无需额外配置。

island-flight 是免费的吗?

是的,island-flight 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

island-flight 支持哪些平台?

island-flight 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 island-flight?

由 dingtom336-gif(@dingtom336-gif)开发并维护,当前版本 v3.2.0。

💬 留言讨论