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.