Shengwang Integration

Workflow

Step 0: Ensure doc index exists (MANDATORY)

⚠️ This step is NON-NEGOTIABLE. Execute it BEFORE any routing, intake, or code generation.

Check if references/docs.txt exists. If not (or if this is a fresh project), download it immediately:

bash skills/shengwang-integration/scripts/fetch-docs.sh

This file is the documentation index — all doc lookups depend on it. Do NOT proceed to Step 1 until this file exists or the download has been attempted. If download fails, proceed with local reference docs and fallback URLs.

Step 1: Collect kickoff information

Use intake to collect kickoff information. Ask only for details the user has not already provided.

Collect only the details needed to remove implementation blockers:

User's use case / target solution
Main Shengwang / Agora product
Platform or client stack
Backend language if relevant
Any key technical details already known that affect routing or implementation

Use a conversational flow:

Ask one short question at a time
Infer obvious context from the user's request when it is safe to do so
Ask only for the next most useful missing detail
Stop asking as soon as there is enough information to continue

For product-specific preferences such as ConvoAI vendors, do not force a full configuration upfront. Use recommended defaults as short suggestions, but for ConvoAI the user must still explicitly answer or confirm all of these fields before implementation:

ASR
ASR language
LLM
TTS

"Use the default" is a valid explicit confirmation. Collect these confirmations one at a time, not as a large form.

If the user already gave enough information, do not repeat questions. Produce a lightweight kickoff recap, then continue automatically unless a required detail is still missing.

Step 2: Start with local references

Use the kickoff summary plus the route table below to select the correct local reference module. If the available information is sufficient, begin implementation using the existing local docs under references/.

Purpose	Route to
New request, vague, or missing details	intake
Credentials, AppID, REST auth	general
Download SDK, sample project, Token Builder, GitHub repo	Route to the relevant product module
Generate Token, token server, AccessToken2, RTC/RTM auth	token-server
ConvoAI operation (with details already known)	conversational-ai
RTC SDK integration	rtc
RTM messaging / signaling	rtm
Cloud Recording	cloud-recording

If Step 2 provides enough information for implementation, proceed. If essential information is still missing or the local references are not enough, continue to Step 3.

Step 3: Research with doc fetching

Use references/doc-fetching.md to fetch more comprehensive documentation. Do this only after Step 2, when the local references are insufficient for the requested implementation.

Research order:

Local references in this skill
Fetched docs via the doc-fetching workflow
Fallback web search only if needed after doc fetching

Once Step 3 provides enough information, proceed with implementation.

Download Rules

Use git clone --depth 1 <url> — GitHub URLs must be repo root only (no branch/subdirectory paths)
On any download failure: report the error, provide the URL for manual download, never silently skip

shengwang-integration