Overview
The business diagnostic assistant is used to answer "how should this be done", UI design, UX review, and design systems. It is suitable for product, operations, technical, and software use after clarifying business goals, content materials, or analysis targets. It combines the interface description to be polished, pasted interface description, page copy, design goals, current version issues, or areas hoped to be specifically refined. and other inputs, organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.
When to Use
Applicable Scenarios
- The user raises questions like "how should this be done" and needs to quickly break down goals, determine priorities, and form executable outcomes
- Product, operations, technical, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the business diagnostic assistant
- The user has already prepared refinement goals (explaining the desired professionalism, conversion, comprehension efficiency, brand consistency, or presentation effect.), viewing and usage audience (explaining target users, visitors, reviewers, or clients, and the experience they care about most.), and page or design preview links (providing publicly accessible pages, prototypes, design previews, portfolios, or reference links.), and hopes to organize them into executable analysis or optimization results
- The user needs to turn materials related to the business diagnostic assistant into clear conclusions, priorities, and next steps
How to Call
Call the AI Skills API directly through the exported Python runner:
Command Examples
Basic Call
python3 scripts/run.py --params '{}'
Call with Common Parameters
python3 scripts/run.py --params '{"goal":"精修目标"}'
Parameter Description
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
goal |
string | No | - | Explain the desired professionalism, conversion, comprehension efficiency, brand consistency, or presentation effect |
audience |
string | No | - | Explain target users, visitors, reviewers, or clients, and the experience they care about most |
materialUrl |
string | No | - | Provide publicly accessible pages, prototypes, design previews, portfolios, or reference links; a complete accessible URL is required |
reviewDepth |
string | No | 标准诊断 |
Choose quick polish, standard refinement recommendations, or an in-depth polishing checklist; optional values:快速体检、标准诊断、深度改稿 |
materialFile |
string | No | - | Supports UI screenshots, visual drafts, annotated images, before-and-after comparison images, design documents, or PDFs |
materialText |
string | No | - | Paste interface description, page copy, design goals, current version issues, or areas hoped to be specifically refined |
targetPlatform |
string | No | - | Choose Web, mobile, backend system, marketing page, social media image, presentation page, or another medium |
brandRequirements |
string | No | - | Supplement brand guidelines, component libraries, color/font restrictions, client requirements, and information that must be retained |
See the complete machine-readable parameter structure at references/form-schema.json。
Parameter Value Reference
The current skill has no categorical parameters that require additional lookup.
Supported input formats
The current skill directly accepts JSON parameters; if the parameters contain a link field, please pass a complete, accessible URL.
Example request
The following example parameters can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.
python3 scripts/run.py --params '{"goal":"精修目标"}'
Equivalent --params JSON:
{
"goal": "精修目标"
}
Example return result
{
"success": true,
"data": {
"message": "示例结果请以技能真实返回结构为准。"
},
"meta": {
"executionTime": 842,
"cached": false
}
}
Deliverables
- Summary, diagnostic conclusions, action recommendations, and reusable deliverables: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
- Interpretation of input materials: combine the refinement goals (explain the desired professionalism, conversion, comprehension efficiency, brand consistency, or presentation effect.), viewing and user audience (explain the target users, visitors, reviewers, or clients, and the experience they care about most.), and page or design preview links (fill in publicly accessible pages, prototypes, design previews, portfolios, or reference links.) to extract key context and the basis for judgment.
- Next steps: provide priorities, execution recommendations, or a content framework that can be further developed.
Suggestions for using the results
- First determine whether the output answers the user's core question about the 'Business Diagnostic Assistant'.
- Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether clear next steps are provided.
- If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.
Preparation before running
AISKILLS_BASE_URL: defaulthttps://ai-skills.aiAISKILLS_API_KEY: required, used for authenticated callsAISKILLS_TENANT_ID: defaultdefault