← 返回 Skills 市场
xiejinsong

family-trip

作者 xiejinsong · GitHub ↗ · vv3.2.3 · MIT-0
cross-platform ⚠ suspicious
84
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install family-trip
功能描述
Plan perfect family vacations — kid-safe activities, family rooms, stroller-friendly routes, and attractions that adults and children both enjoy. Also suppor...
使用说明 (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: family-trip

Overview

Plan perfect family vacations — kid-safe activities, family rooms, stroller-friendly routes, and attractions that adults and children both enjoy.

When to Activate

User query contains:

  • English: "family trip", "with kids", "family vacation", "bring children"
  • Chinese: "带孩子去哪", "亲子游", "家庭旅行", "带娃旅行"

Do NOT activate for: couple → honeymoon-trip

Prerequisites

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

Parameters

This skill orchestrates multiple CLI commands. See each command's parameters below:

search-flight

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

search-hotel

Parameters

Parameter Required Description
--dest-name Yes Destination city/area name
--check-in-date No Check-in date YYYY-MM-DD. Default: today
--check-out-date No Check-out date. Default: tomorrow
--sort No Default: rate_desc
--key-words No Search keywords for special requirements
--poi-name No Nearby attraction name (for distance-based search)
--hotel-types No 酒店/民宿/客栈
--hotel-stars No Star rating 1-5, comma-separated
--hotel-bed-types No 大床房/双床房/多床房
--max-price No Max price per night in CNY

Sort Options

Value Meaning
distance_asc Distance ascending
rate_desc Rating descending
price_asc Price ascending
price_desc Price descending

search-poi

Parameters

Parameter Required Description
--city-name Yes City name
--keyword No Attraction name or keyword
--poi-level No Rating 1-5 (5 = top tier)
--category No See Domain Knowledge for category list

keyword-search

Parameters

Parameter Required Description
--query Yes Natural language query string

Core Workflow — Multi-command orchestration

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: Family Fun

Trigger: "family trip with kids"

Flights + family hotels + theme parks/zoos/aquariums

Output: Kid-focused family trip.

Playbook B: Educational Family

Trigger: "educational family trip"

Flights + hotels + museums + historical sites

Output: Learning-focused family trip.

Playbook C: Beach Family

Trigger: "beach with kids"

Flights to beach + family resort + water activities

Output: Beach family vacation.

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

Full family orchestration

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.

Family travel tips: kids under 2 fly free (lap), 2-12 get 50% discount. Family rooms/suites save vs two rooms. Pack snacks and entertainment for flights. Top family destinations: Shanghai (Disneyland), Beijing (Great Wall + zoo), Sanya (beach), Chengdu (pandas). Schedule nap time into itinerary for young children.

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 appears to do what it claims (a flyai-cli wrapper for family travel planning), but before installing or using it you should: 1) Verify the @fly-ai/flyai-cli package on npm/GitHub (publisher, repo, recent releases, and postinstall scripts) to ensure you trust the code you will install globally; 2) Prefer inspecting the package source or using a sandbox/container or local (non-global) install to reduce host impact; 3) Be aware the skill's runbook may append a local .flyai-execution-log.json containing your raw user queries and command results—avoid including sensitive personal data in queries or run the skill where that log cannot leak; 4) Expect the agent to refuse to answer from training data and to require the CLI to succeed (it will not fall back to knowledge-based answers), which can lead to repeated network/CLI calls if a result lacks the required booking link; and 5) If you need higher assurance, ask the publisher/source for the official repository or package checksum and confirm the Fliggy/Flyai affiliation before proceeding.
功能分析
Type: OpenClaw Skill Name: family-trip Version: v3.2.3 The skill acts as a travel planning wrapper for the 'flyai-cli' tool, but it contains high-risk instructions in SKILL.md and README.md that mandate the global installation of an external NPM package (@fly-ai/flyai-cli) and the execution of shell commands. Additionally, references/runbook.md instructs the agent to write execution logs to a hidden local file (.flyai-execution-log.json). While these capabilities are plausibly needed for the stated purpose of providing real-time travel data, the requirement for global installation and shell execution represents a significant attack surface without built-in sanitization.
能力评估
Purpose & Capability
The skill is presented as a wrapper around the flyai CLI for real-time travel/booking data (flights, hotels, POIs). It declares no unrelated env vars or binaries and its required actions (installing and invoking flyai-cli) are coherent with the stated purpose.
Instruction Scope
SKILL.md forces the agent to obtain every piece of data from the flyai CLI and forbids using training data. It also instructs the agent to maintain a runbook and, if filesystem writes are available, append a JSON log (.flyai-execution-log.json) containing user_query and other execution details. This local logging of raw user queries could store sensitive input and the requirement to re-execute until [Book](...) links are present may cause repeated CLI/network calls. Functionally consistent, but privacy and looping behavior are worth noting.
Install Mechanism
There is no formal install spec in the registry, but SKILL.md mandates installing @fly-ai/flyai-cli with `npm i -g`. A global npm install is expected for a CLI wrapper, but global npm packages can run arbitrary postinstall scripts and execute code on the host — this is a moderate-risk action and should be validated against the official package source (registry/GitHub).
Credentials
The skill requests no environment variables or credentials, which is proportional. Caveat: the runbook/log will capture the raw user_query and CLI results locally, which could include sensitive details if the user provides them.
Persistence & Privilege
The skill does not request always:true and does not modify other skills. It may write an execution log to the current working directory if filesystem access is available; this is limited persistence and scoped to the agent's environment.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install family-trip
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /family-trip 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
vv3.2.3
No file changes detected for version v3.2.3. - No updates or modifications introduced in this release. - Functionality, content, and behavior remain identical to v3.2.0.
vv3.2.2
Version v3.2.2 (no file changes detected): - No code or documentation changes in this release. - All features, rules, and workflows remain as previously described in version 3.2.0.
vv3.2.1
No file changes detected for v3.2.1. This release has no functional or documentation updates. - Version number incremented only; no content changes.
v3.2.0
family-trip 3.2.0 - Updated skill description for greater detail, including all trip-planning features and Fliggy/Alibaba Group integration. - Enhanced instructions for CLI-only execution: strictly prohibits replying from training data; enforces extraction and validation of all responses from flyai CLI output. - Added explicit, critical rules for parameter handling, CLI command usage, and output validation (e.g., all results must have [Book](...) links). - Expanded and clarified multi-scenario playbooks for different family vacation types. - Updated compatibility, prerequisites, and brand tag formatting details.
元数据
Slug family-trip
版本 v3.2.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 4
常见问题

family-trip 是什么?

Plan perfect family vacations — kid-safe activities, family rooms, stroller-friendly routes, and attractions that adults and children both enjoy. Also suppor... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 84 次。

如何安装 family-trip?

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

family-trip 是免费的吗?

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

family-trip 支持哪些平台?

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

谁开发了 family-trip?

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

💬 留言讨论