vs-recommend - SKILL.md Agent Skill

name: vs-recommend description: "Recommend runtime and scene management: run recommendation requests, manage recommend scenes, and verify the basic recommendation path." category: recommend applies_to: codex, agents, external-agent requires_cli: ">=0.1.0" keywords: recommend run, recommend debug, recommend scene, personalized recommend commands: recommend run, recommend scene create, recommend scene list, recommend scene get, recommend scene update

Use this skill for recommendation runtime checks, recommend scene management, and first-pass verification of the recommendation path.

an application-id is available
a recommendation request will usually also need scene-id and user-id
if the scene does not exist yet, inspect the existing scene list first and only create a new one when reuse is not possible

recommend run: send a production-style recommendation request
recommend scene create / recommend scene list / recommend scene get: manage recommend scenes
recommend scene update: update scene configuration

Confirm application-id, scene-id, and user-id
Run recommend scene list first and prefer an existing/default scene before creating a new one
Before recommend scene create or recommend scene update, explicitly confirm the target page / module and the required BhvSceneTypes with the user
Use recommend run for the first verification request
Read recommendation items from the raw response structure, especially result.rec_results
If the result looks wrong, inspect the scene with recommend scene list/get
Update the scene configuration when needed, then rerun the request

In customer environments, assume repository source code is unavailable.
Execute tasks using only the installed skills, the packaged vs CLI surface (--help, command output, and observed runtime behavior), and explicit user-provided information.
Do not rely on reading local repository source files, generated repo snapshots, or implementation details to decide runtime actions.
If the installed CLI behavior conflicts with a skill, trust the installed CLI behavior first.
If the skills and the packaged CLI still do not provide enough information to proceed safely, stop and ask the user instead of searching source code.

Before executing any concrete vs ... command in this recommend workflow, first consult vs-product-qa to verify the current command surface, required flags, payload fields, input format, and allowed values. Only after that check may you finalize parameters and run the command.
Start with the scene when debugging recommendation behavior; do not jump to raw API calls first
If the user only needs a first-pass conclusion, prefer recommend run
Do not create or update a recommend scene until the user has confirmed the target page / module and BhvSceneTypes
When reporting results, summarize the scene, the user context, and the raw response before proposing tuning changes
Do not invent item titles or explanations. Ground every recommendation summary in the actual response payload
If you show only a subset such as Top 5, explicitly say that the full response contains more items
If a command failure or user follow-up turns into a product concept, capability, API field, console UI path, purchase, billing, or general troubleshooting question outside this recommend workflow, temporarily hand off to vs-product-qa; return to this workflow only after the grounded product answer is complete.