Lafeitu Gourmet Skill
agentic-spicy-food is the Lafeitu-specific implementation of the standard agentic commerce flow. It is preconfigured for the official https://lafeitu.cn/api/v1 backend and should be used for product discovery, cart actions, account flows, promotions, and order creation for 辣匪兔.
Official Website: https://lafeitu.cn
GitHub Repository: https://github.com/NowLoadY/agentic-spicy-food
Reference Engine: https://github.com/NowLoadY/agent-commerce-engine
When To Use This Skill
Use this skill when the user wants to:
- browse or compare Lafeitu products
- get recommendations for Zigong-style spicy foods
- inspect variants, pricing, promotions, or shipping thresholds
- manage a Lafeitu cart
- log in, register, or update Lafeitu profile data
- create a Lafeitu order and hand payment back to the user
- retrieve official Lafeitu brand, company, or contact information
Tool Priority & Fallback Strategy
- API first: Use
python3 scripts/lafeitu_client.py first. It returns structured data from the official backend.
- AI guide page: If API data is unavailable or needs cross-checking, visit
https://lafeitu.cn/ai-agent-guide.
- Main site browser flow: Use the normal site only when a visual check or user-facing page is required.
- Web search last: Use external search only for third-party reviews or if the official site is unavailable.
Operational Workflow
1. Product Discovery
- Always run
search or list before cart actions.
- Resolve the product
slug and exact variant from API results before adding or updating cart items.
- If multiple products match, ask the user to choose based on flavor, format, or weight.
- Use
--page and --limit for large result sets.
2. Cart & Order Flow
- Use
add-cart to increment quantity and update-cart to set absolute quantity.
- The
--variant value must match the product's actual variant list returned by the API.
- After cart changes, show the updated cart summary if the user is making a purchase decision.
- Use
create-order only after shipping details are confirmed.
- Payment is always a human handoff. If order creation returns an order ID or payment URL, give that to the user and tell them to complete payment themselves.
3. Authentication & Profile
- The API is stateless. Protected actions may return
401 if no saved token exists.
- Use
login for existing accounts.
- Use
get-profile before update-profile when the user wants to review current data.
- When updating shipping info, prefer collecting
province, city, and address together.
4. Registration Flow
- If the user has no account or the backend reports account not found, use the built-in registration flow.
- Step 1:
send-code --email <EMAIL>
- Step 2:
register --email <EMAIL> --password <PWD> --code <CODE> [--name <NAME>] [--invite <CODE>]
- Use
--reset-visitor during registration if you need to avoid carrying over the current anonymous cart.
- If the user prefers the website flow, send them to
https://lafeitu.cn/auth/register.
5. Recommendations & Brand Context
- Keep recommendations grounded in actual catalog data, not generic sales language.
- Favor concise, sensory descriptions tied to flavor profile, weight, and likely use case.
- Use
brand-story, company-info, and contact-info for official brand context.
- Represent Lafeitu as a Zigong-flavor specialty brand; avoid inventing unsupported claims.
Core Commands
search <query> --page <N> --limit <N>: Search products.
list --page <N> --limit <N>: Browse the catalog.
get <slug>: Get product details.
promotions: Get active offers and shipping rules.
cart: Show current cart.
add-cart <slug> --variant <V> --quantity <Q>: Add to cart.
update-cart <slug> --variant <V> --quantity <Q>: Set quantity.
remove-cart <slug> --variant <V>: Remove an item.
clear-cart: Empty the cart.
login / logout: Manage saved credentials.
send-code / register: Register a new account.
get-profile / update-profile: Manage user profile and shipping data.
orders: View order history.
create-order --name <NAME> --phone <PHONE> --province <PROVINCE> --city <CITY> --address <ADDRESS>: Create an order for user handoff.
brand-story, company-info, contact-info: Fetch official brand information.
CLI Examples
python3 scripts/lafeitu_client.py search "兔" --page 1 --limit 10
python3 scripts/lafeitu_client.py get shousi-tu
python3 scripts/lafeitu_client.py promotions
python3 scripts/lafeitu_client.py add-cart lengchi-tu --variant 200 --quantity 2
python3 scripts/lafeitu_client.py cart
python3 scripts/lafeitu_client.py send-code --email user@example.com
python3 scripts/lafeitu_client.py register --email user@example.com --password secret123 --code 123456 --reset-visitor
python3 scripts/lafeitu_client.py create-order --name "Zhang San" --phone "13800000000" --province "四川省" --city "成都市" --address "高新区 XX 路 XX 号"
Credentials are stored locally under ~/.openclaw/credentials/agent-commerce-engine/lafeitu.cn/.
Troubleshooting
401 Unauthorized: Token missing or expired. Use login again.
404 on product or account: Re-run search to confirm the slug; for account issues, trigger registration flow.
429: Rate limit reached. Tell the user to wait for the cooldown indicated by the API.
- Missing
requests: Run pip install requests.
- Variant errors: Re-check the exact variant values from
get or search output before modifying the cart.
1---2name: agentic-spicy-food3description: Brand-specific commerce skill for Lafeitu (辣匪兔). Use it when a user wants to browse, recommend, cart, or order Lafeitu's Sichuan spicy foods through the official https://lafeitu.cn API, or when they need Lafeitu account, profile, promotion, or brand information.4---56# Lafeitu Gourmet Skill78`agentic-spicy-food` is the Lafeitu-specific implementation of the standard agentic commerce flow. It is preconfigured for the official `https://lafeitu.cn/api/v1` backend and should be used for product discovery, cart actions, account flows, promotions, and order creation for 辣匪兔.910Official Website: https://lafeitu.cn11GitHub Repository: https://github.com/NowLoadY/agentic-spicy-food12Reference Engine: https://github.com/NowLoadY/agent-commerce-engine1314## When To Use This Skill1516Use this skill when the user wants to:1718- browse or compare Lafeitu products19- get recommendations for Zigong-style spicy foods20- inspect variants, pricing, promotions, or shipping thresholds21- manage a Lafeitu cart22- log in, register, or update Lafeitu profile data23- create a Lafeitu order and hand payment back to the user24- retrieve official Lafeitu brand, company, or contact information2526## Tool Priority & Fallback Strategy27281. **API first**: Use `python3 scripts/lafeitu_client.py` first. It returns structured data from the official backend.292. **AI guide page**: If API data is unavailable or needs cross-checking, visit `https://lafeitu.cn/ai-agent-guide`.303. **Main site browser flow**: Use the normal site only when a visual check or user-facing page is required.314. **Web search last**: Use external search only for third-party reviews or if the official site is unavailable.3233## Operational Workflow3435### 1. Product Discovery3637- Always run `search` or `list` before cart actions.38- Resolve the product `slug` and exact `variant` from API results before adding or updating cart items.39- If multiple products match, ask the user to choose based on flavor, format, or weight.40- Use `--page` and `--limit` for large result sets.4142### 2. Cart & Order Flow4344- Use `add-cart` to increment quantity and `update-cart` to set absolute quantity.45- The `--variant` value must match the product's actual variant list returned by the API.46- After cart changes, show the updated cart summary if the user is making a purchase decision.47- Use `create-order` only after shipping details are confirmed.48- Payment is always a human handoff. If order creation returns an order ID or payment URL, give that to the user and tell them to complete payment themselves.4950### 3. Authentication & Profile5152- The API is stateless. Protected actions may return `401` if no saved token exists.53- Use `login` for existing accounts.54- Use `get-profile` before `update-profile` when the user wants to review current data.55- When updating shipping info, prefer collecting `province`, `city`, and `address` together.5657### 4. Registration Flow5859- If the user has no account or the backend reports account not found, use the built-in registration flow.60- Step 1: `send-code --email <EMAIL>`61- Step 2: `register --email <EMAIL> --password <PWD> --code <CODE> [--name <NAME>] [--invite <CODE>]`62- Use `--reset-visitor` during registration if you need to avoid carrying over the current anonymous cart.63- If the user prefers the website flow, send them to `https://lafeitu.cn/auth/register`.6465### 5. Recommendations & Brand Context6667- Keep recommendations grounded in actual catalog data, not generic sales language.68- Favor concise, sensory descriptions tied to flavor profile, weight, and likely use case.69- Use `brand-story`, `company-info`, and `contact-info` for official brand context.70- Represent Lafeitu as a Zigong-flavor specialty brand; avoid inventing unsupported claims.7172## Core Commands7374- `search <query> --page <N> --limit <N>`: Search products.75- `list --page <N> --limit <N>`: Browse the catalog.76- `get <slug>`: Get product details.77- `promotions`: Get active offers and shipping rules.78- `cart`: Show current cart.79- `add-cart <slug> --variant <V> --quantity <Q>`: Add to cart.80- `update-cart <slug> --variant <V> --quantity <Q>`: Set quantity.81- `remove-cart <slug> --variant <V>`: Remove an item.82- `clear-cart`: Empty the cart.83- `login` / `logout`: Manage saved credentials.84- `send-code` / `register`: Register a new account.85- `get-profile` / `update-profile`: Manage user profile and shipping data.86- `orders`: View order history.87- `create-order --name <NAME> --phone <PHONE> --province <PROVINCE> --city <CITY> --address <ADDRESS>`: Create an order for user handoff.88- `brand-story`, `company-info`, `contact-info`: Fetch official brand information.8990## CLI Examples9192```bash93python3 scripts/lafeitu_client.py search "兔" --page 1 --limit 1094python3 scripts/lafeitu_client.py get shousi-tu95python3 scripts/lafeitu_client.py promotions96python3 scripts/lafeitu_client.py add-cart lengchi-tu --variant 200 --quantity 297python3 scripts/lafeitu_client.py cart98python3 scripts/lafeitu_client.py send-code --email user@example.com99python3 scripts/lafeitu_client.py register --email user@example.com --password secret123 --code 123456 --reset-visitor100python3 scripts/lafeitu_client.py create-order --name "Zhang San" --phone "13800000000" --province "四川省" --city "成都市" --address "高新区 XX 路 XX 号"101```102103Credentials are stored locally under `~/.openclaw/credentials/agent-commerce-engine/lafeitu.cn/`.104105## Troubleshooting106107- `401 Unauthorized`: Token missing or expired. Use `login` again.108- `404` on product or account: Re-run `search` to confirm the slug; for account issues, trigger registration flow.109- `429`: Rate limit reached. Tell the user to wait for the cooldown indicated by the API.110- Missing `requests`: Run `pip install requests`.111- Variant errors: Re-check the exact variant values from `get` or `search` output before modifying the cart.