fix: preserve CloudBase skill routing checks

Author: binggg

config/source/guideline/cloudbase/SKILL.md

@@ -44,20 +44,20 @@ If a skill points to its own `references/...` files, keep following those relati
 
 <!-- DO NOT EDIT: auto-generated from references/activation-map.yaml -->
 
-| Scenario | Read first | Then read | Do NOT route to first |
-|----------|------------|-----------|------------------------|
-| web-auth | `auth-tool` | auth-web, web-development | cloud-functions, http-api |
-| miniapp-cloudbase | `miniprogram-development` | auth-wechat, no-sql-wx-mp-sdk | auth-web, web-development |
-| native-http-api | `http-api` | auth-tool, relational-database-tool | auth-web, no-sql-web-sdk, web-development |
-| web-nosql | `web-development` | no-sql-web-sdk, auth-web | relational-database-tool, http-api |
-| mysql-mcp | `relational-database-tool` | relational-database-web, http-api | no-sql-web-sdk, web-development |
-| cloud-functions | `cloud-functions` | auth-tool, ai-model-nodejs | cloudrun-development, auth-web |
-| cloudrun-backend | `cloudrun-development` | auth-tool, relational-database-tool | cloud-functions |
-| ai-agent | `cloudbase-agent` | cloud-functions, cloudrun-development | - |
-| ui-first | `ui-design` | web-development, miniprogram-development | cloud-functions |
-| ai-web | `web-development` | ai-model-web, ui-design | ai-model-wechat, http-api |
-| ops-inspector | `ops-inspector` | cloud-functions, cloudrun-development | ui-design, spec-workflow |
-| spec-workflow | `spec-workflow` | cloudbase | web-development, cloud-functions |
+| Scenario | Read first | Then read | Do NOT route to first | Must check before action |
+|----------|------------|-----------|------------------------|--------------------------|
+| Web login / registration / auth UI | `auth-tool` | auth-web, web-development | cloud-functions, http-api | Provider status and publishable key |
+| WeChat mini program + CloudBase | `miniprogram-development` | auth-wechat, no-sql-wx-mp-sdk | auth-web, web-development | Whether the project really uses CloudBase / `wx.cloud` |
+| Native App / Flutter / React Native | `http-api` | auth-tool, relational-database-tool | auth-web, no-sql-web-sdk, web-development | SDK boundary, OpenAPI, auth method |
+| Web projects + NoSQL Database | `web-development` | no-sql-web-sdk, auth-web | relational-database-tool, http-api | Login state and database access permission model |
+| MySQL Database (relational) | `relational-database-tool` | relational-database-web, http-api | no-sql-web-sdk, web-development | Distinguish MCP management vs app code access |
+| Cloud Functions | `cloud-functions` | auth-tool, ai-model-nodejs | cloudrun-development, auth-web | Event vs HTTP function, runtime, `scf_bootstrap` |
+| CloudRun backend | `cloudrun-development` | auth-tool, relational-database-tool | cloud-functions | Container boundary, Dockerfile, CORS |
+| AI Agent (智能体开发) | `cloudbase-agent` | cloud-functions, cloudrun-development | cloud-functions, cloudrun-development | AG-UI protocol, scf_bootstrap, SSE streaming |
+| UI generation | `ui-design` | web-development, miniprogram-development | cloud-functions | Design specification first |
+| AI Model (Web) | `web-development` | ai-model-web, ui-design | ai-model-wechat, http-api | Platform and streaming interaction mode |
+| Resource health inspection / troubleshooting | `ops-inspector` | cloud-functions, cloudrun-development | ui-design, spec-workflow | CLS enabled, time range for logs |
+| Spec workflow / architecture design | `spec-workflow` | cloudbase | web-development, cloud-functions | Requirements, design, tasks confirmed |
 
 
 ### Routing reminders
@@ -79,7 +79,7 @@ If a skill points to its own `references/...` files, keep following those relati
 
 ### Approach A: IDE Native MCP
 
-Configure CloudBase MCP via your IDE\'s MCP settings. For detailed config examples (Cursor, Claude Code, Windsurf, Cline, etc.), see `references/mcp-setup.md`.
+Configure CloudBase MCP via your IDE's MCP settings. For detailed config examples (Cursor, Claude Code, Windsurf, Cline, etc.), see `references/mcp-setup.md`.
 
 
 ### Approach B: mcporter CLI

config/source/guideline/cloudbase/references/activation-map.yaml

@@ -184,7 +184,9 @@ scenarios:
   beforeAction:
   - 先确认是 Agent 开发而不是普通云函数。
   - 确认 AG-UI 协议、SSE streaming、部署目标（云函数或 CloudRun）。
-  doNotUse: []
+  doNotUse:
+  - cloud-functions
+  - cloudrun-development
   commonMistakes:
   - 把 Agent 开发误当成普通云函数开发。
   - 未确认 AG-UI 协议就直接写代码。

config/source/guideline/cloudbase/references/mcp-setup.md

@@ -82,6 +82,6 @@ When your IDE does not support native MCP, use **mcporter** as the CLI.
 - Query app-side login config:
   `npx mcporter call cloudbase.queryAppAuth action=getLoginConfig --output json`
 - Patch app-side login strategy:
-  `npx mcporter call cloudbase.manageAppAuth action=patchLoginStrategy patch='{"usernamePassword\":true}' --output json`
+  `npx mcporter call cloudbase.manageAppAuth action=patchLoginStrategy patch='{"usernamePassword":true}' --output json`
 - Query publishable key:
   `npx mcporter call cloudbase.queryAppAuth action=getPublishableKey --output json`

tests/skill-activation-routing.test.js

@@ -7,15 +7,16 @@ import { loadYamlModule } from '../scripts/lib/load-yaml-module.mjs';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const ROOT_DIR = path.resolve(__dirname, '..');
-const ACTIVATION_MAP_FILE = path.join(
+const GUIDELINE_DIR = path.join(
   ROOT_DIR,
   'config',
   'source',
   'guideline',
   'cloudbase',
-  'references',
-  'activation-map.yaml',
 );
+const GUIDELINE_FILE = path.join(GUIDELINE_DIR, 'SKILL.md');
+const ACTIVATION_MAP_FILE = path.join(GUIDELINE_DIR, 'references', 'activation-map.yaml');
+const MCP_SETUP_FILE = path.join(GUIDELINE_DIR, 'references', 'mcp-setup.md');
 
 const SKILL_SOURCE_DIR = path.join(ROOT_DIR, 'config', 'source', 'skills');
 
@@ -77,4 +78,23 @@ describe('skill activation routing contract', async () => {
     expect(byId.get('cloud-functions').doNotUse).toContain('cloudrun-development');
     expect(byId.get('ui-first').firstRead).toBe('ui-design');
   });
+
+  test('keeps the source guideline routing table aligned with activation checks', () => {
+    const source = fs.readFileSync(GUIDELINE_FILE, 'utf8');
+
+    expect(source).toContain('| Scenario | Read first | Then read | Do NOT route to first | Must check before action |');
+    expect(source).toContain('| Web login / registration / auth UI | `auth-tool` | auth-web, web-development | cloud-functions, http-api | Provider status and publishable key |');
+    expect(source).toContain('| AI Agent (智能体开发) | `cloudbase-agent` | cloud-functions, cloudrun-development |');
+    expect(source).not.toContain('| web-auth | `auth-tool` |');
+  });
+
+  test('keeps moved mcporter patch examples copy-pasteable', () => {
+    const setup = fs.readFileSync(MCP_SETUP_FILE, 'utf8');
+    const patchExamples = Array.from(setup.matchAll(/patch='([^']+)'/g));
+
+    expect(patchExamples.length).toBeGreaterThan(0);
+    for (const [, patch] of patchExamples) {
+      expect(() => JSON.parse(patch)).not.toThrow();
+    }
+  });
 });