Merge pull request #471 from TencentCloudBase/feature/prompt-skill-install-pages

docs(prompts): 🧭 simplify skill prompt pages

Author: binggg

config/source/guideline/cloudbase/SKILL.md

@@ -180,7 +180,7 @@ If the platform supports long-term memory, persist these scenarios so the agent
 
 Prefer long-term memory when available: write the scenarios and working rules there so the agent always applies them. When configuring the workspace (e.g. `AGENTS.md`) or long-term memory, add reminders like:
 
-- **CloudBase skills** → Run `npx skills add tencentcloudbase/skills -y` to install; use `cloudbase-guidelines` and log in to CloudBase (MCP auth, device-code) for full-stack development.
+- **CloudBase skills** → Run `npx skills add tencentcloudbase/cloudbase-skills -y` to install; use `cloudbase-guidelines` and log in to CloudBase (MCP auth, device-code) for full-stack development.
 - **CloudBase = MCP, understand tools first** → When managing or deploying CloudBase, you MUST use MCP and MUST understand tool details first. Before calling any CloudBase tool, run `npx mcporter describe cloudbase --all-parameters` (or equivalent in your IDE) to inspect the server config and get full parameter details.
 - **mcporter call format** → `npx mcporter call cloudbase.<tool> key=value`, e.g. `npx mcporter call cloudbase.auth action=status --output json`.
 - **CloudBase development and deployment** → Use MCP to automate (environment, functions, database, hosting, etc.).

doc/components/prompts.json

@@ -49,6 +49,18 @@
       "在 iOS 应用中使用 CloudBase HTTP API 实现用户注册和登录"
     ]
   },
+  {
+    "id": "auth-nodejs",
+    "title": "身份认证：Node.js 服务端",
+    "description": "使用 CloudBase Node SDK 进行服务端身份认证",
+    "shortDescription": "Node.js 服务端身份认证",
+    "category": "auth",
+    "order": 5,
+    "prompts": [
+      "帮我实现一个云函数，验证用户身份并获取用户信息",
+      "创建一个 Node.js 后端服务，使用 CloudBase Auth 进行用户认证"
+    ]
+  },
   {
     "id": "no-sql-web-sdk",
     "title": "文档数据库：Web SDK",
@@ -97,6 +109,18 @@
       "在 Web 应用中使用 CloudBase 关系型数据库 SDK 实现数据查询和操作"
     ]
   },
+  {
+    "id": "data-model-creation",
+    "title": "数据库：数据模型创建",
+    "description": "使用 AI 创建复杂数据模型",
+    "shortDescription": "复杂数据模型设计",
+    "category": "database",
+    "order": 5,
+    "prompts": [
+      "帮我创建一个用户和订单的数据模型",
+      "设计一个博客系统的数据模型"
+    ]
+  },
   {
     "id": "database-http-api",
     "title": "数据库：App 集成",

doc/prompts/ai-model-nodejs.mdx

@@ -18,244 +18,18 @@ import AIDevelopmentPrompt from '../components/AIDevelopmentPrompt';
 
 <AIDevelopmentPrompt ruleId="ai-model-nodejs" />
 
-## Skill 
+## 安装与查看
 
-````markdown title="rule.md"
-## When to use this skill
-
-Use this skill for **calling AI models in Node.js backend or CloudBase cloud functions** using `@cloudbase/node-sdk`.
-
-**Use it when you need to:**
-
-- Integrate AI text generation in backend services
-- Generate images with Hunyuan Image model
-- Call AI models from CloudBase cloud functions
-- Server-side AI processing
-
-**Do NOT use for:**
-
-- Browser/Web apps → use `ai-model-web` skill
-- WeChat Mini Program → use `ai-model-wechat` skill
-- HTTP API integration → use `http-api` skill
-
----
-
-## Available Providers and Models
-
-CloudBase provides these built-in providers and models:
-
-| Provider | Models | Recommended |
-|----------|--------|-------------|
-| `hunyuan-exp` | `hunyuan-turbos-latest`, `hunyuan-t1-latest`, `hunyuan-2.0-thinking-20251109`, `hunyuan-2.0-instruct-20251111` | ✅ `hunyuan-2.0-instruct-20251111` |
-| `deepseek` | `deepseek-r1-0528`, `deepseek-v3-0324`, `deepseek-v3.2` | ✅ `deepseek-v3.2` |
-
----
-
-## Installation
+如果需要安装全部 CloudBase Skills，可执行：
 
 ```bash
-npm install @cloudbase/node-sdk
+npx skills add tencentcloudbase/cloudbase-skills
 ```
 
-⚠️ **AI feature requires version 3.16.0 or above.** Check with `npm list @cloudbase/node-sdk`.
-
----
-
-## Initialization
-
-### In Cloud Functions
-
-```js
-const tcb = require('@cloudbase/node-sdk');
-const app = tcb.init({ env: '&lt;YOUR_ENV_ID&gt;' });
-
-exports.main = async (event, context) =&gt; {
-  const ai = app.ai();
-  // Use AI features
-};
-```
+如果只安装当前 Skill，可执行：
 
-### Cloud Function Configuration for AI Models
-
-⚠️ **Important:** When creating cloud functions that use AI models (especially `generateImage()` and large language model generation), set a longer timeout as these operations can be slow.
-
-**Using MCP Tool `manageFunctions(action="createFunction")`:**
-
-Legacy compatibility: if an older prompt still says `createFunction`, keep the same payload shape but execute it through `manageFunctions(action="createFunction")`.
-
-Set the `timeout` parameter in the `func` object:
-
-- **Parameter**: `func.timeout` (number)
-- **Unit**: seconds
-- **Range**: 1 - 900
-- **Default**: 20 seconds (usually too short for AI operations)
-
-**Recommended timeout values:**
-- **Text generation (`generateText`)**: 60-120 seconds
-- **Streaming (`streamText`)**: 60-120 seconds  
-- **Image generation (`generateImage`)**: 300-900 seconds (recommended: 900s)
-- **Combined operations**: 900 seconds (maximum allowed)
-
-### In Regular Node.js Server
-
-```js
-const tcb = require('@cloudbase/node-sdk');
-const app = tcb.init({
-  env: '&lt;YOUR_ENV_ID&gt;',
-  secretId: '&lt;YOUR_SECRET_ID&gt;',
-  secretKey: '&lt;YOUR_SECRET_KEY&gt;'
-});
-
-const ai = app.ai();
-```
-
----
-
-## generateText() - Non-streaming
-
-```js
-const model = ai.createModel("hunyuan-exp");
-
-const result = await model.generateText({
-  model: "hunyuan-2.0-instruct-20251111",  // Recommended model
-  messages: [{ role: "user", content: "你好，请你介绍一下李白" }],
-});
-
-console.log(result.text);           // Generated text string
-console.log(result.usage);          // { prompt_tokens, completion_tokens, total_tokens }
-console.log(result.messages);       // Full message history
-console.log(result.rawResponses);   // Raw model responses
-```
-
----
-
-## Error Handling Pattern
-
-```js
-const model = ai.createModel("deepseek");
-
-try {
-  const result = await model.generateText({
-    model: "deepseek-v3.2",
-    messages: [{ role: "user", content: "Summarize today's deployment logs" }],
-  });
-
-  console.log(result.text);
-} catch (error) {
-  console.error("AI request failed", error);
-}
-```
-
----
-
-## streamText() - Streaming
-
-```js
-const model = ai.createModel("hunyuan-exp");
-
-const res = await model.streamText({
-  model: "hunyuan-2.0-instruct-20251111",  // Recommended model
-  messages: [{ role: "user", content: "你好，请你介绍一下李白" }],
-});
-
-// Option 1: Iterate text stream (recommended)
-for await (let text of res.textStream) {
-  console.log(text);  // Incremental text chunks
-}
-
-// Option 2: Iterate data stream for full response data
-for await (let data of res.dataStream) {
-  console.log(data);  // Full response chunk with metadata
-}
-
-// Option 3: Get final results
-const messages = await res.messages;  // Full message history
-const usage = await res.usage;        // Token usage
-```
-
----
-
-## generateImage() - Image Generation
-
-⚠️ **Image generation is only available in Node SDK**, not in JS SDK (Web) or WeChat Mini Program.
-
-```js
-const imageModel = ai.createImageModel("hunyuan-image");
-
-const res = await imageModel.generateImage({
-  model: "hunyuan-image",
-  prompt: "一只可爱的猫咪在草地上玩耍",
-  size: "1024x1024",
-  version: "v1.9",
-});
-
-console.log(res.data[0].url);           // Image URL (valid 24 hours)
-console.log(res.data[0].revised_prompt);// Revised prompt if revise=true
-```
-
-### Image Generation Parameters
-
-```ts
-interface HunyuanGenerateImageInput {
-  model: "hunyuan-image";      // Required
-  prompt: string;                       // Required: image description
-  version?: "v1.8.1" | "v1.9";         // Default: "v1.8.1"
-  size?: string;                        // Default: "1024x1024"
-  negative_prompt?: string;             // v1.9 only
-  style?: string;                       // v1.9 only
-  revise?: boolean;                     // Default: true
-  n?: number;                           // Default: 1
-  footnote?: string;                    // Watermark, max 16 chars
-  seed?: number;                        // Range: [1, 4294967295]
-}
-
-interface HunyuanGenerateImageOutput {
-  id: string;
-  created: number;
-  data: Array&lt;{
-    url: string;                        // Image URL (24h valid)
-    revised_prompt?: string;
-  }&gt;;
-}
+```bash
+npx skills add https://github.com/tencentcloudbase/skills --skill ai-model-nodejs
 ```
 
----
-
-## Type Definitions
-
-```ts
-interface BaseChatModelInput {
-  model: string;                        // Required: model name
-  messages: Array&lt;ChatModelMessage&gt;;    // Required: message array
-  temperature?: number;                 // Optional: sampling temperature
-  topP?: number;                        // Optional: nucleus sampling
-}
-
-type ChatModelMessage =
-  | { role: "user"; content: string }
-  | { role: "system"; content: string }
-  | { role: "assistant"; content: string };
-
-interface GenerateTextResult {
-  text: string;                         // Generated text
-  messages: Array&lt;ChatModelMessage&gt;;    // Full message history
-  usage: Usage;                         // Token usage
-  rawResponses: Array&lt;unknown&gt;;         // Raw model responses
-  error?: unknown;                      // Error if any
-}
-
-interface StreamTextResult {
-  textStream: AsyncIterable&lt;string&gt;;    // Incremental text stream
-  dataStream: AsyncIterable&lt;DataChunk&gt;; // Full data stream
-  messages: Promise&lt;ChatModelMessage[]&gt;;// Final message history
-  usage: Promise&lt;Usage&gt;;                // Final token usage
-  error?: unknown;                      // Error if any
-}
-
-interface Usage {
-  prompt_tokens: number;
-  completion_tokens: number;
-  total_tokens: number;
-}
-```
-````
+当前 Skill 在线查看： [ai-model-nodejs](https://skills.sh/tencentcloudbase/skills/ai-model-nodejs)