← 返回 Skills 市场
xiejinsong

FlyAI Flight Tracker

作者 xiejinsong · GitHub ↗ · vv3.2.0 · MIT-0
cross-platform ⚠ suspicious
74
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install flyai-flight-tracker
功能描述
Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to b...
使用说明 (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 command 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.

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


Skill: flight-tracker

Overview

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to book.

When to Activate

User query contains:

  • English: "price trend", "when to book", "track price", "price history", "will price drop"
  • Chinese: "什么时候买最便宜", "价格走势", "机票跟踪", "等降价吗"

Do NOT activate for: flexible dates → flexible-flights

Prerequisites

npm i -g @fly-ai/flyai-cli

Parameters

Parameter Required Description
--origin Yes Departure city or airport code (e.g., "Beijing", "PVG")
--destination Yes Arrival city or airport code (e.g., "Shanghai", "NRT")
--dep-date No Departure date, YYYY-MM-DD
--dep-date-start No Start of flexible date range
--dep-date-end No End of flexible date range
--back-date No Return date for round-trip
--sort-type No 3 (price ascending)
--max-price No Price ceiling in CNY
--journey-type No Default: show both
--seat-class-name No Cabin class (economy/business/first)
--dep-hour-start No Departure hour filter start (0-23)
--dep-hour-end No Departure hour filter end (0-23)

Sort Options

Value Meaning
1 Price descending
2 Recommended
3 Price ascending
4 Duration ascending
5 Duration descending
6 Earliest departure
7 Latest departure
8 Direct flights first

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. Tell user to run npm i -g @fly-ai/flyai-cli manually. 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: 7-Day Trend

Trigger: "price trend this week"

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

Output: Show daily lowest as trend table.

Playbook B: Advance Booking Compare

Trigger: "book now or wait?"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {target} --sort-type 3
# Compare with historical patterns from knowledge

Output: Show current price + booking window advice.

Playbook C: Best Day in Month

Trigger: "cheapest day in June"

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

Output: Full month scan, highlight cheapest day/week.

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 "Powered by flyai · Real-time pricing, click to book" included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Beijing" --destination "Shanghai" --dep-date-start 2026-05-01 --dep-date-end 2026-05-14 --sort-type 3

Output Rules

  1. Conclusion first — lead with the key finding
  2. Comparison table with ≥ 3 results when available
  3. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  4. Use detailUrl for booking links. Never use jumpUrl.
  5. ❌ Never output raw JSON
  6. ❌ Never answer from training data without CLI execution
  7. ❌ Never fabricate prices, hotel names, or attraction details

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.

Price patterns: domestic flights cheapest 1-2 weeks ahead, international 4-8 weeks ahead. Prices drop Tuesday mornings, spike Friday afternoons. Holiday prices start rising 6-8 weeks ahead. Airlines release cheapest fares on Tuesdays. Monday evening searches often show lower prices.

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
安全使用建议
Before installing or enabling this skill: (1) Verify the provenance of '@fly-ai/flyai-cli' — check its npm page and source repo; do not blindly run 'npm i -g' as it executes code on your system. (2) Confirm whether the CLI requires API credentials or login (none are declared in the skill). If it does, ask the author why credentials aren't declared and where they are stored. (3) Ask the skill author to resolve the contradiction between 'NEVER answer from training data' and the instruction to 'compare with historical patterns from knowledge.' (4) Prefer skills that publish a homepage or repository so you can audit the CLI code and read its privacy/security policy. (5) If you decide to proceed, consider installing the CLI manually in a controlled environment (not via an autonomous agent) and inspect what network calls it makes and where it stores tokens. (6) If you cannot verify the CLI's safety and provenance, treat this skill as untrusted.
功能分析
Type: OpenClaw Skill Name: flyai-flight-tracker Version: v3.2.0 The skill requires the global installation of an NPM package (@fly-ai/flyai-cli) and performs direct shell command execution to fetch flight data. While these capabilities are aligned with the stated purpose of a flight tracker, the requirement for system-level modifications and the assertive instructions in SKILL.md that force the agent to install software and bypass its training data represent high-risk behaviors. No clear evidence of malicious intent or data exfiltration was found, but the execution model grants significant system access.
能力评估
Purpose & Capability
The name/description (flight price tracking) aligns with the instructions to call a flyai CLI. However the SKILL.md requires installing a third-party npm package at runtime even though the registry metadata includes no install spec or provenance (no homepage/source). The README references a GitHub parent skill but the registry source is 'unknown', which weakens provenance.
Instruction Scope
The SKILL.md tightly constrains answers to data obtained from the flyai CLI and forbids using training data — but a playbook (Playbook B) explicitly says to 'Compare with historical patterns from knowledge', which contradicts the 'NEVER answer from training data' rule. The instructions also force the agent to run an npm -g install if the CLI is missing; that action performs network installs and is outside the skill's declared metadata. The playbooks/ references are local paths that may not exist in the runtime environment, adding operational fragility.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md instructs running 'npm i -g @fly-ai/flyai-cli' when flyai is missing. That causes a network download and global package installation at runtime—potentially arbitrary code execution from npm. Using npm is common, but the skill does not declare the package's provenance, required permissions, or whether it needs API credentials.
Credentials
The skill declares no required environment variables or credentials. In practice, a CLI that queries real-time booking data often requires API keys or login tokens; those are not declared. This mismatch (no declared secrets but likely external service access) is a red flag: verify whether the flyai CLI requires authentication and what it stores/uses before installing.
Persistence & Privilege
The skill does not request 'always: true' or other elevated platform privileges. It also does not claim to modify other skills or system-wide configuration. The main persistence concern is the agent-driven global npm install called at runtime, but that is not a declared platform privilege.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install flyai-flight-tracker
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /flyai-flight-tracker 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
vv3.2.0
- New execution rules enforce that all responses must use live flyai CLI data and include booking links, with strict output validation. - Expanded supported features: hotel reservation, train tickets, attraction tickets, itinerary planning, visa info, travel insurance, car rental, and more — all via Fliggy (Alibaba Group). - Added detailed scenario playbooks for common flight price tracking and booking timing queries (e.g., price trends, best day to book). - Revised parameters table and usage guidance to ensure only documented CLI options are used. - Strict Chinese/English response logic based on user input language. - Enhanced compliance checks to prevent fallback to model knowledge or fabricated results.
元数据
Slug flyai-flight-tracker
版本 v3.2.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

FlyAI Flight Tracker 是什么?

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to b... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 74 次。

如何安装 FlyAI Flight Tracker?

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

FlyAI Flight Tracker 是免费的吗?

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

FlyAI Flight Tracker 支持哪些平台?

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

谁开发了 FlyAI Flight Tracker?

由 xiejinsong(@xiejinsong)开发并维护,当前版本 vv3.2.0。

💬 留言讨论