huaweicloud-devkit 1.0.2-dev.9 → 1.0.2-next.10

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

@@ -1,124 +1,171 @@
-#!/usr/bin/env node
-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();
+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();

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

@@ -1,55 +1,55 @@
----
-name: huawei-cts
-description: "Use when managing Cloud Trace Service (CTS) audit logs, trackers, and traces on Huawei Cloud. Triggers: CTS, Cloud Trace, audit log, tracker, trace, operation record. NOT for: CES monitoring alarms (use huawei-cloud-eye), log analysis (use LTS)."
-version: 1
----
-
-# Huawei Cloud CTS
-
-**STOP - Do not answer from general knowledge.** Follow the procedure below.
-
-Always run `hcloud CTS <Operation> --help` before constructing commands to discover exact parameter names and requirements.
-
-## Overview
-
-Domain expertise for Cloud Trace Service. Covers trackers, traces, notifications, and resource tags.
-
-## Critical Warnings
-
-| Trap | Why |
-|------|-----|
-| Tracker required for traces | Must create a tracker before traces are recorded |
-| OBS bucket prerequisite | Tracker needs an OBS bucket for log delivery |
-| 7-day retention default | Trace data retained 7 days by default. Create LTS tracker for longer retention |
-| Organization tracker | Cross-account auditing requires organization tracker |
-
-## Common Workflows
-
-| Task | Operation |
-|------|-----------|
-| List operations | `ListOperations --cli-region=<r> --project_id=<p>` |
-| List traces | `ListTraces --cli-region=<r> --project_id=<p>` |
-| Create tracker | `CreateTracker --cli-region=<r> --project_id=<p>` |
-| List trackers | `ListTrackers --cli-region=<r> --project_id=<p>` |
-| Delete tracker | `DeleteTracker --cli-region=<r> --project_id=<p>` |
-| Create notification | `CreateNotification --cli-region=<r> --project_id=<p>` |
-| List notifications | `ListNotifications --cli-region=<r> --project_id=<p>` |
-| List trace resources | `ListTraceResources --cli-region=<r> --project_id=<p>` |
-
-Discover exact parameters with `--help` before executing any command.
-
-## Troubleshooting
-
-| Error | Fix |
-|-------|-----|
-| No traces found | Check tracker is created and enabled. Filter by time range |
-| Tracker creation fails | Ensure OBS bucket exists and has correct permissions |
-
-## Security
-
-- SHOULD enable CTS for all production accounts
-- MUST use OBS server-side encryption for trace logs
-
-## Cross-Skill References
-
-- **OBS**: See `huawei-obs` for tracker log delivery bucket
+---
+name: huawei-cts
+description: 'Use when managing Cloud Trace Service (CTS) audit logs, trackers, and traces on Huawei Cloud. Triggers: CTS, Cloud Trace, audit log, tracker, trace, operation record. NOT for: CES monitoring alarms (use huawei-cloud-eye), log analysis (use LTS).'
+version: 1
+---
+
+# Huawei Cloud CTS
+
+**STOP - Do not answer from general knowledge.** Follow the procedure below.
+
+Always run `hcloud CTS <Operation> --help` before constructing commands to discover exact parameter names and requirements.
+
+## Overview
+
+Domain expertise for Cloud Trace Service. Covers trackers, traces, notifications, and resource tags.
+
+## Critical Warnings
+
+| Trap                        | Why                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------ |
+| Tracker required for traces | Must create a tracker before traces are recorded                               |
+| OBS bucket prerequisite     | Tracker needs an OBS bucket for log delivery                                   |
+| 7-day retention default     | Trace data retained 7 days by default. Create LTS tracker for longer retention |
+| Organization tracker        | Cross-account auditing requires organization tracker                           |
+
+## Common Workflows
+
+| Task                 | Operation                                              |
+| -------------------- | ------------------------------------------------------ |
+| List operations      | `ListOperations --cli-region=<r> --project_id=<p>`     |
+| List traces          | `ListTraces --cli-region=<r> --project_id=<p>`         |
+| Create tracker       | `CreateTracker --cli-region=<r> --project_id=<p>`      |
+| List trackers        | `ListTrackers --cli-region=<r> --project_id=<p>`       |
+| Delete tracker       | `DeleteTracker --cli-region=<r> --project_id=<p>`      |
+| Create notification  | `CreateNotification --cli-region=<r> --project_id=<p>` |
+| List notifications   | `ListNotifications --cli-region=<r> --project_id=<p>`  |
+| List trace resources | `ListTraceResources --cli-region=<r> --project_id=<p>` |
+
+Discover exact parameters with `--help` before executing any command.
+
+## Troubleshooting
+
+| Error                  | Fix                                                        |
+| ---------------------- | ---------------------------------------------------------- |
+| No traces found        | Check tracker is created and enabled. Filter by time range |
+| Tracker creation fails | Ensure OBS bucket exists and has correct permissions       |
+
+## Security
+
+- SHOULD enable CTS for all production accounts
+- MUST use OBS server-side encryption for trace logs
+
+## Cross-Skill References
+
+- **OBS**: See `huawei-obs` for tracker log delivery bucket

package/plugins/huaweicloud-core/skills/huawei-dds-dcs/SKILL.md

@@ -1,70 +1,70 @@
----
-name: huawei-dds-dcs
-description: "Use when creating or managing Document Database Service (DDS/MongoDB-compatible) or Distributed Cache Service (DCS/Redis/Memcached) on Huawei Cloud. Triggers: DDS, DCS, MongoDB, Redis, Memcached, document DB, cache, replica set, sharding. NOT for: RDS (use huawei-rds), GaussDB (use huawei-gaussdb)."
-version: 1
----
-
-# Huawei Cloud DDS / DCS
-
-**STOP - Do not answer from general knowledge.** Follow the procedure below.
-
-Always run `hcloud DDS <Operation> --help` or `hcloud DCS <Operation> --help` before constructing commands.
-
-## DDS (Document Database Service — MongoDB Compatible)
-
-## DDS Critical Warnings
-
-| Trap | Why |
-|------|-----|
-| Requires 3-node replica | Minimum production deployment needs 3 nodes |
-| Shard key permanent | Once selected, shard key cannot be changed |
-| Storage auto-scaling off | Enable before storage fills |
-
-### Common Workflows
-
-| Task | Operation |
-|------|-----------|
-| List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
-| Create instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
-| Delete instance | `DeleteInstance --cli-region=<r> --project_id=<p>` |
-| Add readonly node | `AddReadonlyNode --cli-region=<r> --project_id=<p>` |
-| Add shard | `AddShardingNode --cli-region=<r> --project_id=<p>` |
-| Create backup | `CreateBackup --cli-region=<r> --project_id=<p>` |
-
-Discover exact parameters with `--help` before executing any command.
-
-## DCS (Distributed Cache Service — Redis/Memcached)
-
-## DCS Critical Warnings
-
-| Trap | Why |
-|------|-----|
-| Redis password required | Cannot create Redis instance without password |
-| Memcached no password | Memcached has no auth — only accessible within VPC |
-| Cache persistence costs | AOF/RDB persistence uses additional storage |
-
-### Common Workflows
-
-| Task | Operation |
-|------|-----------|
-| List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
-| Create Redis instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
-| Delete instance | `DeleteInstances --cli-region=<r> --project_id=<p>` |
-| Restart instance | `RestartInstance --cli-region=<r> --project_id=<p>` |
-| Show node information | `BatchShowNodesInformation --cli-region=<r> --project_id=<p>` |
-| Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>` |
-
-Discover exact parameters with `--help` before executing any command.
-
-## Troubleshooting
-
-| Error | Fix |
-|-------|-----|
-| DDS instance creation fails | Check 3-node minimum, VPC/subnet availability |
-| DCS connection refused | Redis instances need password. Memcached only accessible within VPC |
-| DCS auto-expire not working | Enable auto-expire scan task for Redis |
-
-## Cross-Skill References
-
-- **VPC/Subnet**: See `huawei-vpc` for instance networking
-- **Backup/CBR**: See `huawei-cbr` for backup management
+---
+name: huawei-dds-dcs
+description: 'Use when creating or managing Document Database Service (DDS/MongoDB-compatible) or Distributed Cache Service (DCS/Redis/Memcached) on Huawei Cloud. Triggers: DDS, DCS, MongoDB, Redis, Memcached, document DB, cache, replica set, sharding. NOT for: RDS (use huawei-rds), GaussDB (use huawei-gaussdb).'
+version: 1
+---
+
+# Huawei Cloud DDS / DCS
+
+**STOP - Do not answer from general knowledge.** Follow the procedure below.
+
+Always run `hcloud DDS <Operation> --help` or `hcloud DCS <Operation> --help` before constructing commands.
+
+## DDS (Document Database Service — MongoDB Compatible)
+
+## DDS Critical Warnings
+
+| Trap                     | Why                                         |
+| ------------------------ | ------------------------------------------- |
+| Requires 3-node replica  | Minimum production deployment needs 3 nodes |
+| Shard key permanent      | Once selected, shard key cannot be changed  |
+| Storage auto-scaling off | Enable before storage fills                 |
+
+### Common Workflows
+
+| Task              | Operation                                           |
+| ----------------- | --------------------------------------------------- |
+| List instances    | `ListInstances --cli-region=<r> --project_id=<p>`   |
+| Create instance   | `CreateInstance --cli-region=<r> --project_id=<p>`  |
+| Delete instance   | `DeleteInstance --cli-region=<r> --project_id=<p>`  |
+| Add readonly node | `AddReadonlyNode --cli-region=<r> --project_id=<p>` |
+| Add shard         | `AddShardingNode --cli-region=<r> --project_id=<p>` |
+| Create backup     | `CreateBackup --cli-region=<r> --project_id=<p>`    |
+
+Discover exact parameters with `--help` before executing any command.
+
+## DCS (Distributed Cache Service — Redis/Memcached)
+
+## DCS Critical Warnings
+
+| Trap                    | Why                                                |
+| ----------------------- | -------------------------------------------------- |
+| Redis password required | Cannot create Redis instance without password      |
+| Memcached no password   | Memcached has no auth — only accessible within VPC |
+| Cache persistence costs | AOF/RDB persistence uses additional storage        |
+
+### Common Workflows
+
+| Task                   | Operation                                                     |
+| ---------------------- | ------------------------------------------------------------- |
+| List instances         | `ListInstances --cli-region=<r> --project_id=<p>`             |
+| Create Redis instance  | `CreateInstance --cli-region=<r> --project_id=<p>`            |
+| Delete instance        | `DeleteInstances --cli-region=<r> --project_id=<p>`           |
+| Restart instance       | `RestartInstance --cli-region=<r> --project_id=<p>`           |
+| Show node information  | `BatchShowNodesInformation --cli-region=<r> --project_id=<p>` |
+| Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>`      |
+
+Discover exact parameters with `--help` before executing any command.
+
+## Troubleshooting
+
+| Error                       | Fix                                                                 |
+| --------------------------- | ------------------------------------------------------------------- |
+| DDS instance creation fails | Check 3-node minimum, VPC/subnet availability                       |
+| DCS connection refused      | Redis instances need password. Memcached only accessible within VPC |
+| DCS auto-expire not working | Enable auto-expire scan task for Redis                              |
+
+## Cross-Skill References
+
+- **VPC/Subnet**: See `huawei-vpc` for instance networking
+- **Backup/CBR**: See `huawei-cbr` for backup management