huaweicloud-devkit 1.0.2 → 1.0.3-next.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "type": "module",
   "files": [

package/plugins/huaweicloud-core/.claude-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/.cursor-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.hermes-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "name": "huaweicloud-devkit",
   "id": "huaweicloud-devkit",
   "displayName": "HuaweiCloud DevKit",
-  "version": "1.0.2",
+  "version": "1.0.3-next.0",
   "family": "bundle-plugin",
   "bundleFormat": "codex",
   "description": "Guide coding agents to use Huawei Cloud safely — KooCLI, APIs, SDKs, 28 MCP tools, skills, and safety guardrails.",

package/plugins/huaweicloud-core/skills/huawei-modelarts/SKILL.md

@@ -63,3 +63,11 @@ Discover operation parameters with `--help` before executing any write operation
 
 - **OBS storage**: See `huawei-obs` for bucket and training data management
 - **VPC/Subnet**: See `huawei-vpc` for notebook network configuration
+
+## External Skills
+
+For advanced workflows (notebook lifecycle, training job diagnosis,
+hyperparameter tuning), search the marketplace:
+`huaweicloud_search_marketplace` query="ModelArts notebook/training/diagnosis"
+→ install via `npx skills add huaweicloud/huaweicloud-skills --skill <name> -y -g`
+→ load and execute.

package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/SKILL.md

@@ -19,7 +19,10 @@ Use this skill to turn vague developer intent into a precise Huawei Cloud capabi
 6. Prefer SDK docs when the deliverable is application code.
 7. Prefer MCP only when an approved Huawei Cloud MCP tool exists for the needed operation.
 8. Treat Terraform as a secondary V1 path for reviewed IaC, not the default.
-9. When no built-in devkit skill matches, browse the community skill marketplace at https://github.com/huaweicloud/huaweicloud-skills. Fetch the index from https://raw.githubusercontent.com/huaweicloud/huaweicloud-skills/master/skills-index/index.json.
+9. When no built-in devkit skill matches:
+   a. Search: use `huaweicloud_search_marketplace` to find a matching skill in the community marketplace
+   b. Install: run `npx skills add huaweicloud/huaweicloud-skills --skill <skill-name> -y -g`
+   c. Execute: load the installed skill and follow its procedure
 10. When the deliverable is a PPT, architecture diagram (draw.io), or frontend page that needs official Huawei Cloud service logos, use the `huaweicloud_get_service_icon` MCP tool to get logo URLs from the official Icons library instead of guessing or hotlinking unofficial images.
 
 ## Scenario Routing

package/plugins/huaweicloud-core/src/setup-cli.mjs

@@ -438,18 +438,31 @@ function installRuntimeDeps(pluginsDir) {
   };
   mkdirSync(pluginsDir, { recursive: true });
   writeFileSync(join(pluginsDir, 'package.json'), JSON.stringify(pkgJson, null, 2));
-  const r = spawnSync('npm', ['install', '--omit=dev'], {
+  const spawnOpts = {
     cwd: pluginsDir,
+    shell: true,
     windowsHide: true,
     stdio: 'pipe',
     timeout: 120000,
-  });
+  };
+  let r = spawnSync('npm', ['install', '--omit=dev'], spawnOpts);
+  const isRetryable = (res) => {
+    const stderr = (res.stderr || '').toString();
+    return res.error?.code === 'EPERM' || res.error?.code === 'EBUSY' || /EPERM|EBUSY/.test(stderr);
+  };
+  if (r.status !== 0 && isRetryable(r)) {
+    console.log(`  \x1b[33m[WARN]\x1b[0m npm install hit file-lock error, retrying in 2s...`);
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 2000);
+    r = spawnSync('npm', ['install', '--omit=dev'], spawnOpts);
+  }
   const undiciDir = join(pluginsDir, 'node_modules', 'undici');
   if (r.status === 0 && existsSync(undiciDir)) {
     console.log(`  Runtime deps installed -> ${join(pluginsDir, 'node_modules')}`);
   } else {
+    const errCode = r.error?.code;
     const err = (r.stderr || '').toString().trim().split(/\r?\n/).slice(-2).join(' ');
-    console.log(`  \x1b[33m[WARN]\x1b[0m npm install failed in ${pluginsDir}${err ? `: ${err}` : ''}`);
+    const hint = errCode === 'ENOENT' ? ' (npm not found — ensure Node.js/npm is in PATH)' : '';
+    console.log(`  \x1b[33m[WARN]\x1b[0m npm install failed in ${pluginsDir}${err ? `: ${err}` : ''}${hint}`);
     console.log('  Manual fix: cd %s && npm install', pluginsDir);
     if (!existsSync(undiciDir)) {
       console.log(`  \x1b[31m[ERROR]\x1b[0m undici is NOT installed. MCP server will fail to start.`);
@@ -1378,6 +1391,7 @@ async function installDsh() {
   const safetyDir = join(PLUGIN_ROOT, 'safety');
   const pluginDest = dshPluginsDir();
 
+  mkdirSync(pluginDest, { recursive: true });
   copyDir(skillsSrc, dshSkillsDir());
   console.log(`  Skills -> ${dshSkillsDir()}`);
   copyDir(srcDir, join(pluginDest, 'src'));
@@ -1386,9 +1400,8 @@ async function installDsh() {
   console.log(`  Safety Policy -> ${join(pluginDest, 'safety')}`);
   ensureDshMcpPatch();
   tryInstallDshMcpClient();
-  mkdirSync(pluginDest, { recursive: true });
-  writeFileSync(join(pluginDest, '.installed'), new Date().toISOString());
   installRuntimeDeps(pluginDest);
+  writeFileSync(join(pluginDest, '.installed'), new Date().toISOString());
 }
 
 async function updateDsh() {
@@ -1397,6 +1410,7 @@ async function updateDsh() {
   const safetyDir = join(PLUGIN_ROOT, 'safety');
   const pluginDest = dshPluginsDir();
 
+  mkdirSync(pluginDest, { recursive: true });
   copyDir(skillsSrc, dshSkillsDir());
   const stale = pruneStale(dshSkillsDir(), skillsSrc);
   console.log(`  Skills updated -> ${dshSkillsDir()}${stale > 0 ? ` (removed ${stale} stale)` : ''}`);
@@ -1406,9 +1420,8 @@ async function updateDsh() {
   console.log(`  Safety Policy updated -> ${join(pluginDest, 'safety')}`);
   ensureDshMcpPatch();
   tryInstallDshMcpClient();
-  mkdirSync(pluginDest, { recursive: true });
-  writeFileSync(join(pluginDest, '.installed'), new Date().toISOString());
   installRuntimeDeps(pluginDest);
+  writeFileSync(join(pluginDest, '.installed'), new Date().toISOString());
 }
 
 function uninstallDsh() {
@@ -1939,9 +1952,15 @@ async function cmdInstall() {
                     : '当前 agent';
   const pad = ' '.repeat(24 - appName.length);
   if (target === 'officeace') {
-    console.log(`\n\x1b[1m\x1b[33m╔══════════════════════════════════════════════════════╗`);
-    console.log(`\x1b[1m\x1b[33m║  打开连接器 → 我的连接器 → huaweicloud-devkit      ║`);
-    console.log(`\x1b[1m\x1b[33m║  → 连接 → 回到对话 → 输入框开启连接器                  ║`);
+    console.log(`\n\x1b[1m\x1b[33m╔══════════════════════════════════════════════════════════╗`);
+    console.log(`\x1b[1m\x1b[33m║  打开连接器 → 我的连接器 → huaweicloud-devkit      �`);
+    console.log(`\x1b[1m\x1b[33m║  → 连接 → 回到对话 → 输入框开启连接器                  �`);
+    console.log(`\x1b[1m\x1b[33m╚══════════════════════════════════════════════════════╝\x1b[0m`);
+  } else if (target === 'workbuddy') {
+    console.log(`\n\x1b[1m\x1b[33m╔══════════════════════════════════════════════════════════╗`);
+    console.log(`\x1b[1m\x1b[33m║  MCP 工具即时生效，无需重启会话                    �`);
+    console.log(`\x1b[1m\x1b[33m║  前往连接器 → 自定义连接器，确认 huaweicloud-devkit    �`);
+    console.log(`\x1b[1m\x1b[33m║  已添加信任并启用                                   �`);
     console.log(`\x1b[1m\x1b[33m╚══════════════════════════════════════════════════════╝\x1b[0m`);
   } else {
     console.log(`\n\x1b[1m\x1b[33m╔══════════════════════════════════════════════════════╗`);
@@ -1964,6 +1983,8 @@ async function cmdInstall() {
   console.log(`  2. 配置代理（企业内网）：npx huaweicloud-devkit proxy init`);
   if (target === 'officeace') {
     console.log(`  3. 打开连接器 → 我的连接器 → huaweicloud-devkit → 连接 → 回到对话 → 输入框开启连接器`);
+  } else if (target === 'workbuddy') {
+    console.log(`  3. 前往连接器 → 自定义连接器，确认 huaweicloud-devkit 已添加信任并启用`);
   } else {
     console.log(`  3. 重启 ${appName} 会话（MCP 工具重启后生效）`);
   }
@@ -2189,6 +2210,18 @@ async function cmdDoctor() {
     check(`MCP server can start (${mcpTarget})`, true, '');
   }
 
+  const undiciPluginDirs = [
+    opencodePluginDir,
+    codexPluginDir,
+    codeartsPluginDir,
+    workbuddyPluginDir,
+    dshPluginDir,
+    officeacePluginDir,
+    hermesPluginDir,
+  ];
+  const undiciOk = undiciPluginDirs.some((d) => existsSync(join(d, 'node_modules', 'undici')));
+  check('Runtime deps (undici) installed', undiciOk, 'Run: npx huaweicloud-devkit install');
+
   const safetyOk =
     existsSync(join(opencodePluginDir, 'safety', 'policy.json')) ||
     existsSync(join(codexPluginDir, 'safety', 'policy.json')) ||

package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/SKILL.md

@@ -1,191 +0,0 @@
----
-name: huawei-cloud-find-skills
-description: |
-  Invoke this skill to search, discover, browse, find and install any Huawei Cloud (华为云) agent skill.Triggers include: "华为云","华为云有什么skill","华为云相关skill","华为云agent skill 市场","华为云skill类目","explore Huawei Cloud skills","show Huawei Cloud skill categories","does a Huawei Cloud skill exist for...","which Huawei Cloud skills exist","搜索华为云技能","有没有管理ECS/OBS/RDS的skill","帮我找 XX 华为云skill","介绍 XX Skill 内容","华为云 XX Skill 具体做什么","安装华为云Skill".
----
-
-> [!IMPORTANT]
-> **For any Huawei Cloud query or management task:**
->
-> 1. **Search** — use this skill (`huawei-cloud-find-skills`) to find the relevant Skill.
-> 2. **Install** — install the matched Skill (see [Step 3](#step-3-install-skill)).
-> 3. **Execute** — follow the installed Skill's instructions to fulfill the request.
-
-# Huawei Cloud Agent Skills Search and Discovery
-
-This skill enables users to efficiently search, discover, and install Huawei Cloud skills.
-
-## Scenario Description
-
-This skill enables users to:
-
-- **Search Skills**: Find skills by keyword, category, or both (matched against name, description, and triggers)
-- **Browse Categories**: Explore available skill categories
-- **View Skill Details**: Fetch full SKILL.md content from GitHub for specific skills
-- **Install Skills**: Guide users through skill installation via `npx skills add` (GitCode default), `npx clawhub install`, or fallback GitHub method
-
-**Architecture**: GitCode API v5 (`index.json` + `cn-en-map.json`) → HTTP GET (base64 decode) → In-memory search → GitHub raw fetch for details → Install
-
-### Use Cases
-
-- "Find a skill for managing ECS instances"
-- "What Huawei Cloud skills are available for OBS?"
-- "华为云有哪些 VPC 相关的 skill?"
-- "Browse all available Huawei Cloud skills"
-- "Install a skill for RDS management"
-- "帮我找一个华为云网络相关的skill"
-
-## Prerequisites
-
-- **Node.js >= 22** must be installed
-- **Network access** to `gitcode.com` (API v5 for index) and `github.com` / `raw.githubusercontent.com` (for skill details)
-
-### Step 0: Check Python Environment
-
-> **MANDATORY**: Before running any script command, verify Python is available.
-
-```bash
-# Check Python availability
-python --version   # or: python3 --version
-```
-
-If the command fails or returns Python 2.x:
-
-1. **Install Python 3**: Download from [python.org](https://www.python.org/downloads/) or use a package manager:
-   ```bash
-   # macOS
-   brew install python3
-   # Ubuntu/Debian
-   sudo apt-get install python3
-   # Windows — download installer from python.org, check "Add Python to PATH"
-   ```
-2. **Verify after install**: Run `python --version` again to confirm Python 3.6+ is available
-3. **If `python` points to Python 2**: Use `python3` instead of `python` in all commands below
-
-## Repository Info
-
-```
-INDEX_REPO=2501_91318609/skills-for-index
-INDEX_BRANCH=main
-SKILLS_REPO=huaweicloud/huaweicloud-skills
-SKILLS_BRANCH=master
-RAW_BASE=https://raw.githubusercontent.com/$SKILLS_REPO/$SKILLS_BRANCH
-```
-
-## Index Source
-
-The search script fetches the skill index from GitCode API v5 via HTTP GET (base64 auto-decoded):
-
-```
-SKILLS_INDEX_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main
-SKILLS_CN_EN_MAP_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main
-```
-
-## Core Workflow
-
-### Step 1: Search Skills
-
-> **MANDATORY**: The agent MUST execute the search script to search the skill index. Do NOT read the JSON file directly — always use the script.
-
-Given `keyword` (from AI-understood user intent) and optional `category`, run the search script:
-
-```bash
-node scripts/search-skills.mjs <keyword>
-node scripts/search-skills.mjs <keyword> -c <category>
-node scripts/search-skills.mjs -c <category>
-```
-
-→ [scripts/search-skills.mjs](scripts/search-skills.mjs) (Node.js — cross-platform)
-
-**What the script does**:
-
-1. Fetches `index.json` and `cn-en-map.json` via HTTP GET from GitCode API v5 (auto-decodes base64 content)
-2. Expands keywords via `cn-en-map.json` (bidirectional CN↔EN, e.g., "ECS" → "ECS, 弹性云服务器, 云服务器")
-3. Scores each skill: name match **+10**, trigger match **+8**, description match **+5**, service match **+3**
-4. Sorts by score descending, outputs formatted results with matched keywords
-
-**Fallback iteration** (if no results): 1) Switch CN↔EN keywords 2) Expand keywords 3) Remove category filter 4) Try synonyms 5) List all skills
-
-The process should persist until the skill is found or its absence is confirmed. In the event of total failure, notify the user of the specific steps that were attempted.
-
-### Step 2: View Skill Details (optional)
-
-Fetch the full SKILL.md content from GitHub for intent validation. Skip this step if the search results from Step 1 are sufficiently informative.
-
-```bash
-# URL pattern — use the skill's category, service, and name from index
-DETAIL_URL="https://raw.githubusercontent.com/huaweicloud/huaweicloud-skills/master/skills/${category}/${service}/${name}/SKILL.md"
-```
-
-The agent can fetch this URL using `curl` or its web-fetch tool, then present the skill's full documentation to the user.
-
-### Step 3: Install Skill
-
-> **MANDATORY**: Use one of the commands below. Option A is the default; Option C is a fallback when Option A is unavailable.
-
-```bash
-# Option A: npx skills add from GitCode (default)
-npx skills add https://gitcode.com/huaweicloud/huaweicloud-skills.git#master --skill <skill-name> -y
-
-# Option B: npx clawhub install (OpenClaw ecosystem)
-npx clawhub install <skill-name> -y
-
-# Option C (fallback): npx skills add from GitHub
-npx skills add huaweicloud/huaweicloud-skills --skill <skill-name> -y
-```
-
-If all installation attempts fail, report the error message to the user. Do NOT attempt any method outside the commands above.
-
-## Parameters
-
-| Parameter    | Required/Optional | Description                                                           | Default |
-| ------------ | ----------------- | --------------------------------------------------------------------- | ------- |
-| `Keyword`    | Optional          | Search keyword (matched against name, description, triggers, service) | None    |
-| `Category`   | Optional          | Category code for filtering (e.g., "computing", "storage", "network") | None    |
-| `skill-name` | Required (Step 3) | Exact skill name for installing                                       | None    |
-
-## Reference Documentation
-
-| Document                                             | Description                                                                           |
-| ---------------------------------------------------- | ------------------------------------------------------------------------------------- |
-| GitCode API v5 `index.json`                          | Skill index fetched via HTTP GET (base64 decoded)                                     |
-| GitCode API v5 `cn-en-map.json`                      | Chinese-English keyword mapping fetched via HTTP GET (base64 decoded)                 |
-| [scripts/search-skills.py](scripts/search-skills.py) | Search script (Python) — fetches from GitCode API v5, expands keywords, scores, sorts |
-
-## Search Heuristics
-
-> Optional reference for keyword-to-category hints. The agent can infer categories from `index.json` without these.
-
-- Cloud infrastructure keywords (ecs, bms, vpc, obs, rds, ...) → likely `computing`, `network`, `storage`, etc.
-- Tool keywords (cli, terraform, koo) → likely `devtools`
-- Management keywords (monitoring, alarm, log) → likely `monitoring`
-
-## Troubleshooting
-
-### Issue: Script fails with "Failed to fetch index.json"
-
-**Cause**: GitCode API v5 URL unreachable
-**Solution**: Verify network connectivity to `gitcode.com`
-
-### Issue: GitCode API v5 returns 404
-
-**Cause**: File path incorrect or default branch is not `main`
-**Solution**: Verify the skill's `category`, `service`, and `name` from search results
-
-### Issue: Search returns no results
-
-**Cause**: Keywords don't match any skill
-**Solution**:
-
-1. Try broader keywords
-2. Switch between Chinese and English keywords (e.g., "对象存储" → "obs")
-3. List all skills: `python scripts/search-skills.py -c "computing"`
-
-## Notes
-
-- This skill is **read-only** and does not create any cloud resources
-- **No cache management needed** — index is fetched fresh from GitCode API v5 each run
-- **Network required** — index data is hosted on GitCode, fetched via HTTP GET (base64 decoded)
-- **MUST use script to search** — do not read index.json directly
-- Index repo: `https://gitcode.com/2501_91318609/skills-for-index` (branch: `main`)
-- Skills repo: `https://github.com/huaweicloud/huaweicloud-skills` (branch: `master`)

package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/scripts/search-skills.mjs

@@ -1,171 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-const INDEX_URL =
-  'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main';
-const CN_EN_MAP_URL =
-  'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main';
-
-const GENERIC_KEYWORDS = new Set([
-  '华为云',
-  'huawei',
-  'huawei cloud',
-  '云',
-  'cloud',
-  '技能',
-  'skill',
-  'skills',
-  '所有',
-  'all',
-  '全部',
-  '有什么',
-  '有哪些',
-  '相关',
-  '列表',
-  'list',
-  '查找',
-  '搜索',
-  '发现',
-  '浏览',
-  'find',
-  'search',
-  'discover',
-  'browse',
-  'show',
-  'explore',
-  'agent',
-  '市场',
-  'market',
-  '类目',
-  'category',
-  '安装',
-  'install',
-]);
-
-async function fetchJson(url, _label) {
-  const resp = await fetch(url, { headers: { 'User-Agent': 'huaweicloud-devkit/1.0' } });
-  const data = await resp.json();
-  if (data?.encoding === 'base64' && data.content) {
-    return JSON.parse(Buffer.from(data.content, 'base64').toString('utf8'));
-  }
-  return data;
-}
-
-function isGeneric(kw) {
-  const k = kw.toLowerCase().trim();
-  return GENERIC_KEYWORDS.has(k) || /华为云|huawei/i.test(k);
-}
-
-function expandKeywords(raw, cnEnMap) {
-  if (!raw) return [[], []];
-  const parts = raw.replace(/[,;]/g, ' ').split(/\s+/).filter(Boolean);
-  const expanded = [...parts];
-  for (const p of parts) {
-    const lower = p.toLowerCase();
-    if (cnEnMap[p]) expanded.push(cnEnMap[p]);
-    for (const [cn, en] of Object.entries(cnEnMap)) {
-      if (en === lower) expanded.push(cn);
-    }
-  }
-  const unique = [...new Set(expanded)].sort();
-  return [unique.filter((kw) => !isGeneric(kw)), unique.filter((kw) => isGeneric(kw))];
-}
-
-function scoreSkill(skill, specificKws, genericKws) {
-  if (!specificKws.length && !genericKws.length) return [1, []];
-  let total = 0;
-  const matched = [];
-  const nl = (skill.name || '').toLowerCase();
-  const dl = (skill.description || '').toLowerCase();
-  const sl = (skill.service || '').toLowerCase();
-  const tl = (skill.triggers || []).map((t) => (t || '').toLowerCase());
-
-  for (const kw of specificKws) {
-    const k = kw.toLowerCase();
-    let s = 0;
-    if (nl.includes(k)) s += 10;
-    else if (tl.some((t) => t.includes(k))) s += 8;
-    else if (dl.includes(k)) s += 5;
-    else if (sl.includes(k)) s += 3;
-    if (s > 0) {
-      total += s;
-      matched.push(kw);
-    }
-  }
-  for (const kw of genericKws) {
-    const k = kw.toLowerCase();
-    let s = 0;
-    if (nl.includes(k)) s += 10;
-    else if (tl.some((t) => t.includes(k))) s += 4;
-    else if (dl.includes(k)) s += 2;
-    else if (sl.includes(k)) s += 1;
-    if (s > 0) {
-      total += s;
-      matched.push(kw);
-    }
-  }
-  if (!specificKws.length && total === 0) {
-    total = 1;
-    if (dl.length > 20) total += 1;
-    if (tl.length) total += 1;
-  }
-  return [total, matched];
-}
-
-async function main() {
-  const keyword =
-    process.argv
-      .slice(2)
-      .filter((a) => !a.startsWith('-'))
-      .join(' ') || '';
-  const catIdx = process.argv.indexOf('-c');
-  const category = catIdx >= 0 ? process.argv[catIdx + 1] || '' : '';
-
-  try {
-    const [idx, cnEnMap] = await Promise.all([fetchJson(INDEX_URL, 'index'), fetchJson(CN_EN_MAP_URL, 'cn-en-map')]);
-
-    if (!keyword && !category) {
-      console.log(`Categories: ${(idx.categories || []).join(', ')}`);
-      console.log('Usage: node search-skills.mjs <keyword> [-c <category>]');
-      return;
-    }
-
-    const [specificKws, genericKws] = expandKeywords(keyword, cnEnMap);
-    const hasSpecific = specificKws.length > 0;
-
-    const results = [];
-    for (const skill of idx.skills || []) {
-      if (category && skill.category !== category) continue;
-      const [score, matched] = scoreSkill(skill, specificKws, genericKws);
-      if (hasSpecific && score === 0) continue;
-      const desc = (skill.description || '').slice(0, 150);
-      results.push({
-        score,
-        name: skill.name,
-        category: skill.category,
-        service: skill.service,
-        description: desc + (skill.description?.length > 150 ? '...' : ''),
-        triggers: (skill.triggers || []).slice(0, 5),
-        matched,
-      });
-    }
-    results.sort((a, b) => b.score - a.score);
-
-    if (!results.length) {
-      console.log(`No results. Try broader keywords, remove category filter, or switch CN↔EN.`);
-      return;
-    }
-
-    console.log(`Found ${results.length} skill(s):`);
-    for (const r of results) {
-      console.log(
-        `  [${r.score}pts] ${r.name} (${r.category}/${r.service})${r.matched.length ? ' matched: ' + r.matched.join(',') : ''}`,
-      );
-      console.log(`    ${r.description}`);
-    }
-  } catch (e) {
-    console.error(`Error: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-main();