huaweicloud-devkit 1.0.2-next.3 → 1.0.3-dev.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/.agents/plugins/marketplace.json +20 -20
  2. package/LICENSE +201 -201
  3. package/README.md +139 -163
  4. package/README.zh-CN.md +139 -161
  5. package/bin/setup.cjs +8 -8
  6. package/integrations/opencode/commands/huaweicloud-doctor.md +14 -14
  7. package/integrations/opencode/opencode.json +14 -14
  8. package/integrations/opencode/skills/huaweicloud-core/SKILL.md +32 -32
  9. package/package.json +44 -47
  10. package/plugins/huaweicloud-core/.claude-plugin/plugin.json +44 -44
  11. package/plugins/huaweicloud-core/.codex-plugin/plugin.json +43 -43
  12. package/plugins/huaweicloud-core/.cursor-plugin/plugin.json +44 -44
  13. package/plugins/huaweicloud-core/.mcp.json +15 -15
  14. package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json +44 -44
  15. package/plugins/huaweicloud-core/hooks/hooks.json +26 -26
  16. package/plugins/huaweicloud-core/hooks/huaweicloud-safety.py +136 -136
  17. package/plugins/huaweicloud-core/safety/policy.json +99 -99
  18. package/plugins/huaweicloud-core/safety/rules/cloud-risk-rules.json +199 -199
  19. package/plugins/huaweicloud-core/skills/huawei-apig/SKILL.md +164 -164
  20. package/plugins/huaweicloud-core/skills/huawei-billing/SKILL.md +48 -48
  21. package/plugins/huaweicloud-core/skills/huawei-cbr/SKILL.md +50 -50
  22. package/plugins/huaweicloud-core/skills/huawei-cce/SKILL.md +101 -101
  23. package/plugins/huaweicloud-core/skills/huawei-cloud-eye/SKILL.md +90 -90
  24. package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/SKILL.md +190 -190
  25. package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/scripts/search-skills.mjs +124 -124
  26. package/plugins/huaweicloud-core/skills/huawei-cts/SKILL.md +55 -55
  27. package/plugins/huaweicloud-core/skills/huawei-dds-dcs/SKILL.md +70 -70
  28. package/plugins/huaweicloud-core/skills/huawei-deployment/SKILL.md +56 -56
  29. package/plugins/huaweicloud-core/skills/huawei-dew/SKILL.md +97 -97
  30. package/plugins/huaweicloud-core/skills/huawei-dew/references/csms-usage.md +29 -29
  31. package/plugins/huaweicloud-core/skills/huawei-dew/references/kms-usage.md +23 -23
  32. package/plugins/huaweicloud-core/skills/huawei-ecs/SKILL.md +185 -185
  33. package/plugins/huaweicloud-core/skills/huawei-ecs/references/create-instance.md +133 -133
  34. package/plugins/huaweicloud-core/skills/huawei-ecs/references/evs.md +31 -31
  35. package/plugins/huaweicloud-core/skills/huawei-ecs/references/flavors.md +55 -55
  36. package/plugins/huaweicloud-core/skills/huawei-ecs/references/troubleshooting.md +52 -52
  37. package/plugins/huaweicloud-core/skills/huawei-functiongraph/SKILL.md +131 -131
  38. package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/apig-event-format.md +58 -58
  39. package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/create-function.md +71 -71
  40. package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/deploy-workflow.md +119 -119
  41. package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/triggers.md +142 -142
  42. package/plugins/huaweicloud-core/skills/huawei-gaussdb/SKILL.md +56 -56
  43. package/plugins/huaweicloud-core/skills/huawei-getting-started/SKILL.md +65 -65
  44. package/plugins/huaweicloud-core/skills/huawei-iam/SKILL.md +111 -111
  45. package/plugins/huaweicloud-core/skills/huawei-iam/references/policy-examples.md +122 -122
  46. package/plugins/huaweicloud-core/skills/huawei-iam/references/quick-ref.md +56 -56
  47. package/plugins/huaweicloud-core/skills/huawei-modelarts/SKILL.md +65 -65
  48. package/plugins/huaweicloud-core/skills/huawei-obs/SKILL.md +127 -133
  49. package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-create.md +49 -49
  50. package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-lifecycle.md +26 -26
  51. package/plugins/huaweicloud-core/skills/huawei-obs/references/common-pitfalls.md +100 -100
  52. package/plugins/huaweicloud-core/skills/huawei-obs/references/single-file-share.md +40 -40
  53. package/plugins/huaweicloud-core/skills/huawei-obs/references/static-website.md +56 -56
  54. package/plugins/huaweicloud-core/skills/huawei-rds/SKILL.md +224 -224
  55. package/plugins/huaweicloud-core/skills/huawei-sandbox/SKILL.md +134 -139
  56. package/plugins/huaweicloud-core/skills/huawei-smn-dms/SKILL.md +69 -69
  57. package/plugins/huaweicloud-core/skills/huawei-vpc/SKILL.md +84 -84
  58. package/plugins/huaweicloud-core/skills/huawei-vpc/references/network.md +76 -76
  59. package/plugins/huaweicloud-core/skills/huawei-vpc/references/security-group.md +59 -59
  60. package/plugins/huaweicloud-core/skills/huawei-vpc/references/subnet.md +50 -50
  61. package/plugins/huaweicloud-core/skills/huawei-waf-aad/SKILL.md +63 -63
  62. package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/SKILL.md +56 -56
  63. package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/agents/openai.yaml +4 -4
  64. package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/SKILL.md +47 -51
  65. package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/agents/openai.yaml +4 -4
  66. package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md +128 -128
  67. package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/agents/openai.yaml +4 -4
  68. package/plugins/huaweicloud-core/skills/huaweicloud-core/SKILL.md +95 -110
  69. package/plugins/huaweicloud-core/skills/huaweicloud-core/agents/openai.yaml +4 -4
  70. package/plugins/huaweicloud-core/skills/huaweicloud-core/references/report-issue.md +19 -19
  71. package/plugins/huaweicloud-core/skills/huaweicloud-core/references/select.md +27 -27
  72. package/plugins/huaweicloud-core/skills/huaweicloud-safety/SKILL.md +60 -60
  73. package/plugins/huaweicloud-core/skills/huaweicloud-safety/agents/openai.yaml +4 -4
  74. package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/SKILL.md +83 -83
  75. package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/agents/openai.yaml +4 -4
  76. package/plugins/huaweicloud-core/src/auth/agent-registration.mjs +87 -105
  77. package/plugins/huaweicloud-core/src/auth/credentials.mjs +95 -95
  78. package/plugins/huaweicloud-core/src/auth/service.mjs +63 -63
  79. package/plugins/huaweicloud-core/src/hcloud-cli.mjs +265 -265
  80. package/plugins/huaweicloud-core/src/mcp-server.mjs +129 -129
  81. package/plugins/huaweicloud-core/src/risk-rule-engine.mjs +137 -137
  82. package/plugins/huaweicloud-core/src/safety-policy.mjs +302 -302
  83. package/plugins/huaweicloud-core/src/sandbox/hdkitservice-api.mjs +87 -91
  84. package/plugins/huaweicloud-core/src/sandbox/hwlink-api.mjs +153 -162
  85. package/plugins/huaweicloud-core/src/sandbox/session-manager.mjs +105 -112
  86. package/plugins/huaweicloud-core/src/search-market.mjs +169 -174
  87. package/plugins/huaweicloud-core/src/setup-cli.mjs +1594 -2017
  88. package/plugins/huaweicloud-core/src/tools.mjs +993 -1008
  89. package/plugins/huaweicloud-core/src/ws-exec/hwlink-exec-client.js +427 -427
  90. package/plugins/huaweicloud-core/src/ws-exec/hwlink-fair-queue.js +132 -132
  91. package/plugins/huaweicloud-core/src/ws-exec/hwlink-multiplexer.js +227 -227
  92. package/plugins/huaweicloud-core/src/ws-exec/hwlink-packet.js +202 -202
  93. package/plugins/huaweicloud-core/src/ws-exec/hwlink-terminal-channel.js +158 -158
  94. package/plugins/huaweicloud-core/src/ws-exec/index.js +19 -19
  95. package/plugins/huaweicloud-core/src/ws-exec/ws-exec-client.js +338 -338
  96. package/plugins/huaweicloud-core/src/proxy/proxy-agent.mjs +0 -155
  97. package/plugins/huaweicloud-core/src/proxy/proxy-config.mjs +0 -87
@@ -1,55 +1,55 @@
1
- ---
2
- name: huawei-cts
3
- 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)."
4
- version: 1
5
- ---
6
-
7
- # Huawei Cloud CTS
8
-
9
- **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
-
11
- Always run `hcloud CTS <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
-
13
- ## Overview
14
-
15
- Domain expertise for Cloud Trace Service. Covers trackers, traces, notifications, and resource tags.
16
-
17
- ## Critical Warnings
18
-
19
- | Trap | Why |
20
- |------|-----|
21
- | Tracker required for traces | Must create a tracker before traces are recorded |
22
- | OBS bucket prerequisite | Tracker needs an OBS bucket for log delivery |
23
- | 7-day retention default | Trace data retained 7 days by default. Create LTS tracker for longer retention |
24
- | Organization tracker | Cross-account auditing requires organization tracker |
25
-
26
- ## Common Workflows
27
-
28
- | Task | Operation |
29
- |------|-----------|
30
- | List operations | `ListOperations --cli-region=<r> --project_id=<p>` |
31
- | List traces | `ListTraces --cli-region=<r> --project_id=<p>` |
32
- | Create tracker | `CreateTracker --cli-region=<r> --project_id=<p>` |
33
- | List trackers | `ListTrackers --cli-region=<r> --project_id=<p>` |
34
- | Delete tracker | `DeleteTracker --cli-region=<r> --project_id=<p>` |
35
- | Create notification | `CreateNotification --cli-region=<r> --project_id=<p>` |
36
- | List notifications | `ListNotifications --cli-region=<r> --project_id=<p>` |
37
- | List trace resources | `ListTraceResources --cli-region=<r> --project_id=<p>` |
38
-
39
- Discover exact parameters with `--help` before executing any command.
40
-
41
- ## Troubleshooting
42
-
43
- | Error | Fix |
44
- |-------|-----|
45
- | No traces found | Check tracker is created and enabled. Filter by time range |
46
- | Tracker creation fails | Ensure OBS bucket exists and has correct permissions |
47
-
48
- ## Security
49
-
50
- - SHOULD enable CTS for all production accounts
51
- - MUST use OBS server-side encryption for trace logs
52
-
53
- ## Cross-Skill References
54
-
55
- - **OBS**: See `huawei-obs` for tracker log delivery bucket
1
+ ---
2
+ name: huawei-cts
3
+ 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)."
4
+ version: 1
5
+ ---
6
+
7
+ # Huawei Cloud CTS
8
+
9
+ **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
+
11
+ Always run `hcloud CTS <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
+
13
+ ## Overview
14
+
15
+ Domain expertise for Cloud Trace Service. Covers trackers, traces, notifications, and resource tags.
16
+
17
+ ## Critical Warnings
18
+
19
+ | Trap | Why |
20
+ |------|-----|
21
+ | Tracker required for traces | Must create a tracker before traces are recorded |
22
+ | OBS bucket prerequisite | Tracker needs an OBS bucket for log delivery |
23
+ | 7-day retention default | Trace data retained 7 days by default. Create LTS tracker for longer retention |
24
+ | Organization tracker | Cross-account auditing requires organization tracker |
25
+
26
+ ## Common Workflows
27
+
28
+ | Task | Operation |
29
+ |------|-----------|
30
+ | List operations | `ListOperations --cli-region=<r> --project_id=<p>` |
31
+ | List traces | `ListTraces --cli-region=<r> --project_id=<p>` |
32
+ | Create tracker | `CreateTracker --cli-region=<r> --project_id=<p>` |
33
+ | List trackers | `ListTrackers --cli-region=<r> --project_id=<p>` |
34
+ | Delete tracker | `DeleteTracker --cli-region=<r> --project_id=<p>` |
35
+ | Create notification | `CreateNotification --cli-region=<r> --project_id=<p>` |
36
+ | List notifications | `ListNotifications --cli-region=<r> --project_id=<p>` |
37
+ | List trace resources | `ListTraceResources --cli-region=<r> --project_id=<p>` |
38
+
39
+ Discover exact parameters with `--help` before executing any command.
40
+
41
+ ## Troubleshooting
42
+
43
+ | Error | Fix |
44
+ |-------|-----|
45
+ | No traces found | Check tracker is created and enabled. Filter by time range |
46
+ | Tracker creation fails | Ensure OBS bucket exists and has correct permissions |
47
+
48
+ ## Security
49
+
50
+ - SHOULD enable CTS for all production accounts
51
+ - MUST use OBS server-side encryption for trace logs
52
+
53
+ ## Cross-Skill References
54
+
55
+ - **OBS**: See `huawei-obs` for tracker log delivery bucket
@@ -1,70 +1,70 @@
1
- ---
2
- name: huawei-dds-dcs
3
- 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)."
4
- version: 1
5
- ---
6
-
7
- # Huawei Cloud DDS / DCS
8
-
9
- **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
-
11
- Always run `hcloud DDS <Operation> --help` or `hcloud DCS <Operation> --help` before constructing commands.
12
-
13
- ## DDS (Document Database Service — MongoDB Compatible)
14
-
15
- ## DDS Critical Warnings
16
-
17
- | Trap | Why |
18
- |------|-----|
19
- | Requires 3-node replica | Minimum production deployment needs 3 nodes |
20
- | Shard key permanent | Once selected, shard key cannot be changed |
21
- | Storage auto-scaling off | Enable before storage fills |
22
-
23
- ### Common Workflows
24
-
25
- | Task | Operation |
26
- |------|-----------|
27
- | List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
28
- | Create instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
29
- | Delete instance | `DeleteInstance --cli-region=<r> --project_id=<p>` |
30
- | Add readonly node | `AddReadonlyNode --cli-region=<r> --project_id=<p>` |
31
- | Add shard | `AddShardingNode --cli-region=<r> --project_id=<p>` |
32
- | Create backup | `CreateBackup --cli-region=<r> --project_id=<p>` |
33
-
34
- Discover exact parameters with `--help` before executing any command.
35
-
36
- ## DCS (Distributed Cache Service — Redis/Memcached)
37
-
38
- ## DCS Critical Warnings
39
-
40
- | Trap | Why |
41
- |------|-----|
42
- | Redis password required | Cannot create Redis instance without password |
43
- | Memcached no password | Memcached has no auth — only accessible within VPC |
44
- | Cache persistence costs | AOF/RDB persistence uses additional storage |
45
-
46
- ### Common Workflows
47
-
48
- | Task | Operation |
49
- |------|-----------|
50
- | List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
51
- | Create Redis instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
52
- | Delete instance | `DeleteInstances --cli-region=<r> --project_id=<p>` |
53
- | Restart instance | `RestartInstance --cli-region=<r> --project_id=<p>` |
54
- | Show node information | `BatchShowNodesInformation --cli-region=<r> --project_id=<p>` |
55
- | Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>` |
56
-
57
- Discover exact parameters with `--help` before executing any command.
58
-
59
- ## Troubleshooting
60
-
61
- | Error | Fix |
62
- |-------|-----|
63
- | DDS instance creation fails | Check 3-node minimum, VPC/subnet availability |
64
- | DCS connection refused | Redis instances need password. Memcached only accessible within VPC |
65
- | DCS auto-expire not working | Enable auto-expire scan task for Redis |
66
-
67
- ## Cross-Skill References
68
-
69
- - **VPC/Subnet**: See `huawei-vpc` for instance networking
70
- - **Backup/CBR**: See `huawei-cbr` for backup management
1
+ ---
2
+ name: huawei-dds-dcs
3
+ 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)."
4
+ version: 1
5
+ ---
6
+
7
+ # Huawei Cloud DDS / DCS
8
+
9
+ **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
+
11
+ Always run `hcloud DDS <Operation> --help` or `hcloud DCS <Operation> --help` before constructing commands.
12
+
13
+ ## DDS (Document Database Service — MongoDB Compatible)
14
+
15
+ ## DDS Critical Warnings
16
+
17
+ | Trap | Why |
18
+ |------|-----|
19
+ | Requires 3-node replica | Minimum production deployment needs 3 nodes |
20
+ | Shard key permanent | Once selected, shard key cannot be changed |
21
+ | Storage auto-scaling off | Enable before storage fills |
22
+
23
+ ### Common Workflows
24
+
25
+ | Task | Operation |
26
+ |------|-----------|
27
+ | List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
28
+ | Create instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
29
+ | Delete instance | `DeleteInstance --cli-region=<r> --project_id=<p>` |
30
+ | Add readonly node | `AddReadonlyNode --cli-region=<r> --project_id=<p>` |
31
+ | Add shard | `AddShardingNode --cli-region=<r> --project_id=<p>` |
32
+ | Create backup | `CreateBackup --cli-region=<r> --project_id=<p>` |
33
+
34
+ Discover exact parameters with `--help` before executing any command.
35
+
36
+ ## DCS (Distributed Cache Service — Redis/Memcached)
37
+
38
+ ## DCS Critical Warnings
39
+
40
+ | Trap | Why |
41
+ |------|-----|
42
+ | Redis password required | Cannot create Redis instance without password |
43
+ | Memcached no password | Memcached has no auth — only accessible within VPC |
44
+ | Cache persistence costs | AOF/RDB persistence uses additional storage |
45
+
46
+ ### Common Workflows
47
+
48
+ | Task | Operation |
49
+ |------|-----------|
50
+ | List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
51
+ | Create Redis instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
52
+ | Delete instance | `DeleteInstances --cli-region=<r> --project_id=<p>` |
53
+ | Restart instance | `RestartInstance --cli-region=<r> --project_id=<p>` |
54
+ | Show node information | `BatchShowNodesInformation --cli-region=<r> --project_id=<p>` |
55
+ | Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>` |
56
+
57
+ Discover exact parameters with `--help` before executing any command.
58
+
59
+ ## Troubleshooting
60
+
61
+ | Error | Fix |
62
+ |-------|-----|
63
+ | DDS instance creation fails | Check 3-node minimum, VPC/subnet availability |
64
+ | DCS connection refused | Redis instances need password. Memcached only accessible within VPC |
65
+ | DCS auto-expire not working | Enable auto-expire scan task for Redis |
66
+
67
+ ## Cross-Skill References
68
+
69
+ - **VPC/Subnet**: See `huawei-vpc` for instance networking
70
+ - **Backup/CBR**: See `huawei-cbr` for backup management
@@ -1,56 +1,56 @@
1
- ---
2
- name: huawei-deployment
3
- description: "Use when creating, managing, or running deployment tasks and pipelines on Huawei Cloud CloudDeploy. Triggers: CloudDeploy, deployment, CI/CD, pipeline, release, artifact deployment, deploy task. NOT for: CodeArts Build (build pipeline), SWR container registry."
4
- version: 1
5
- ---
6
-
7
- # Huawei Cloud CloudDeploy
8
-
9
- **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
-
11
- Always run `hcloud <Service> <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
-
13
- ## Overview
14
-
15
- Domain expertise for Huawei Cloud CloudDeploy. Covers application creation, deployment task management, pipeline execution, and artifact configuration.
16
-
17
- ## Critical Warnings
18
-
19
- | Trap | Why |
20
- |------|-----|
21
- | Service name may be `CodeArtsDeploy` | hcloud service name for deployment may be `CodeArtsDeploy` instead of `CloudDeploy`. Run `hcloud --help` to verify |
22
- | Deployment hosts need agent | Install CloudDeploy agent on target hosts first |
23
- | Task must reference application first | Create application before task |
24
- | Artifact source defaults to OBS | Most deployment tasks pull artifacts from OBS. Ensure bucket and object exist |
25
- | Parallel deployments may conflict | Lock resources or use deployment groups |
26
-
27
- ## Common Workflows
28
-
29
- | Task | Operation |
30
- |------|-----------|
31
- | Create application | `CreateApp --name=<n> --platform=<p> --cli-region=<r>` |
32
- | Create deployment task | `CreateTask --name=<n> --app_id=<id> --artifact_source_type=OBS` |
33
- | Start deployment | `StartTask --task_id=<id>` |
34
- | List tasks | `ListTasks --app_id=<id>` |
35
- | Delete task | `DeleteTask --task_id=<id>` |
36
-
37
- ## Troubleshooting
38
-
39
- | Error | Fix |
40
- |-------|-----|
41
- | Agent offline | Check agent service on target host, network connectivity, firewall rules |
42
- | Deployment timeout | Check artifact size, increase task timeout, verify target host resources |
43
- | Artifact not found | Verify OBS bucket and object path, check artifact permissions |
44
- | Permission denied | Verify IAM roles for deployment: `CodeArtsDeploy FullAccess` or custom policy |
45
-
46
- ## Security
47
-
48
- - MUST use IAM roles for deployment permissions
49
- - MUST verify artifact integrity before deployment
50
- - MUST not store credentials in deployment scripts
51
-
52
- ## Cross-Skill References
53
-
54
- - **OBS artifact storage**: See `huawei-obs`
55
- - **ECS deployment target**: See `huawei-ecs`
56
- - **IAM permissions**: See `huawei-iam`
1
+ ---
2
+ name: huawei-deployment
3
+ description: "Use when creating, managing, or running deployment tasks and pipelines on Huawei Cloud CloudDeploy. Triggers: CloudDeploy, deployment, CI/CD, pipeline, release, artifact deployment, deploy task. NOT for: CodeArts Build (build pipeline), SWR container registry."
4
+ version: 1
5
+ ---
6
+
7
+ # Huawei Cloud CloudDeploy
8
+
9
+ **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
+
11
+ Always run `hcloud <Service> <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
+
13
+ ## Overview
14
+
15
+ Domain expertise for Huawei Cloud CloudDeploy. Covers application creation, deployment task management, pipeline execution, and artifact configuration.
16
+
17
+ ## Critical Warnings
18
+
19
+ | Trap | Why |
20
+ |------|-----|
21
+ | Service name may be `CodeArtsDeploy` | hcloud service name for deployment may be `CodeArtsDeploy` instead of `CloudDeploy`. Run `hcloud --help` to verify |
22
+ | Deployment hosts need agent | Install CloudDeploy agent on target hosts first |
23
+ | Task must reference application first | Create application before task |
24
+ | Artifact source defaults to OBS | Most deployment tasks pull artifacts from OBS. Ensure bucket and object exist |
25
+ | Parallel deployments may conflict | Lock resources or use deployment groups |
26
+
27
+ ## Common Workflows
28
+
29
+ | Task | Operation |
30
+ |------|-----------|
31
+ | Create application | `CreateApp --name=<n> --platform=<p> --cli-region=<r>` |
32
+ | Create deployment task | `CreateTask --name=<n> --app_id=<id> --artifact_source_type=OBS` |
33
+ | Start deployment | `StartTask --task_id=<id>` |
34
+ | List tasks | `ListTasks --app_id=<id>` |
35
+ | Delete task | `DeleteTask --task_id=<id>` |
36
+
37
+ ## Troubleshooting
38
+
39
+ | Error | Fix |
40
+ |-------|-----|
41
+ | Agent offline | Check agent service on target host, network connectivity, firewall rules |
42
+ | Deployment timeout | Check artifact size, increase task timeout, verify target host resources |
43
+ | Artifact not found | Verify OBS bucket and object path, check artifact permissions |
44
+ | Permission denied | Verify IAM roles for deployment: `CodeArtsDeploy FullAccess` or custom policy |
45
+
46
+ ## Security
47
+
48
+ - MUST use IAM roles for deployment permissions
49
+ - MUST verify artifact integrity before deployment
50
+ - MUST not store credentials in deployment scripts
51
+
52
+ ## Cross-Skill References
53
+
54
+ - **OBS artifact storage**: See `huawei-obs`
55
+ - **ECS deployment target**: See `huawei-ecs`
56
+ - **IAM permissions**: See `huawei-iam`
@@ -1,97 +1,97 @@
1
- ---
2
- name: huawei-dew
3
- description: "Use when managing secrets, credentials, encryption keys, certificates, or any sensitive data on Huawei Cloud. Covers CSMS (Cloud Secret Management Service) for secrets, KMS for encryption keys, and credential rotation. Triggers on: secret, credential, API key, token, password, encrypt, decrypt, KMS, CSMS, DEW, certificate, CSR, rotation. Activates for ANY task involving secrets or credentials — load this skill first before touching secrets."
4
- version: 1
5
- ---
6
-
7
- # Huawei Cloud DEW (Data Encryption Workshop)
8
-
9
- **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
-
11
- Always run `hcloud <Service> <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
-
13
- ## Overview
14
-
15
- Domain expertise for Huawei Cloud Data Encryption Workshop (DEW). Covers CSMS for secret lifecycle management, KMS for encryption key management, credential rotation, and secure application integration patterns.
16
-
17
- ## Critical Warnings
18
-
19
- | Trap | Why |
20
- |------|-----|
21
- | NEVER fetch secret values into agent context | Use {{resolve:csms:secret-id:SecretString:key}} runtime injection |
22
- | NEVER echo credentials in conversation | AK/SK, passwords, tokens must never appear in chat |
23
- | KMS key deletion is irreversible | 7-30 day pending deletion window. Once gone, data is unrecoverable |
24
- | Secret rotation requires automation | Manual rotation risks stale credentials |
25
- | Cross-account KMS needs grants | KMS keys are regional. Cross-region data needs grant setup |
26
-
27
- ## CSMS Operations
28
-
29
- ### Read-only (safe — metadata only)
30
- | Operation | Description |
31
- |-----------|-------------|
32
- | ListSecrets | List all secrets (names only, no values) |
33
- | DescribeSecret | Get secret metadata (rotation config, KMS key, status) |
34
- | ListSecretVersions | List version IDs and stages (no values) |
35
-
36
- ### Secret Value (blocked by policy — use runtime injection)
37
- | Operation | Safe Alternative |
38
- |-----------|-----------------|
39
- | DownloadSecret | Use {{resolve:csms:secret-id}} in IaC or SDK |
40
- | ShowSecretVersion | Use runtime injection, never in agent context |
41
- | GetSecretValue | Blocked. Use MCP proxy resolve pattern |
42
-
43
- ## KMS Operations
44
-
45
- | Task | Command | Notes |
46
- |------|---------|-------|
47
- | List keys | hcloud KMS ListKeys | Read-only |
48
- | Create key | hcloud KMS CreateKey --key_alias=<name> | Requires write approval |
49
- | Encrypt | hcloud KMS EncryptData --key_id=<id> --plaintext=<b64> | Prefer SDK offline encrypt |
50
- | Decrypt | hcloud KMS DecryptData (**BLOCKED**) | Use runtime injection |
51
-
52
- ## Runtime Injection Pattern
53
-
54
- `ash
55
- # Terraform / IaC
56
- resource "huaweicloud_csms_secret" "db_password" {
57
- secret_string = var.db_password # NEVER hardcode
58
- }
59
-
60
- # SDK
61
- secret_value = client.get_secret(secret_id="my-secret")
62
- # Use immediately, never print or store in context
63
-
64
- # hcloud (for approved automation only)
65
- hcloud CSMS DownloadSecret --secret_name=<name>
66
- # WARNING: Output goes to stdout. Pipe directly, never capture in agent.
67
- `
68
-
69
- ## Troubleshooting
70
-
71
- | Error | Root Cause -> Fix |
72
- |-------|------------------|
73
- | Secret not found | Wrong region or project -> Verify secret ARN includes region/project |
74
- | AccessDenied on CSMS | Missing IAM CSMS policy -> Add csms:DescribeSecret + kms:Decrypt |
75
- | KMS key disabled | Key scheduled for deletion or manually disabled -> Enable or create new key |
76
- | Rotation stuck | Lambda/Python function error -> Check rotation function logs |
77
-
78
- ## Security Considerations
79
-
80
- - MUST use runtime injection. NEVER fetch secrets into agent context
81
- - MUST rotate credentials every 90 days
82
- - MUST enable automatic rotation for CSMS secrets
83
- - MUST audit KMS key usage via CTS
84
- - SHOULD use customer-managed keys (CMK) for sensitive data
85
- - MUST NOT use default KMS keys for production workloads
86
-
87
- ## MCP Tools
88
-
89
- - huaweicloud_list_operations service=DEW or CSMS or KMS
90
- - huaweicloud_run_readonly_command for ListSecrets/ListKeys (metadata only)
91
- - huaweicloud_safety policy blocks all secret value reads
92
-
93
- ## References
94
-
95
- - DEW Docs: https://support.huaweicloud.com/dew/
96
- - CSMS usage: references/csms-usage.md
97
- - KMS usage: references/kms-usage.md
1
+ ---
2
+ name: huawei-dew
3
+ description: "Use when managing secrets, credentials, encryption keys, certificates, or any sensitive data on Huawei Cloud. Covers CSMS (Cloud Secret Management Service) for secrets, KMS for encryption keys, and credential rotation. Triggers on: secret, credential, API key, token, password, encrypt, decrypt, KMS, CSMS, DEW, certificate, CSR, rotation. Activates for ANY task involving secrets or credentials — load this skill first before touching secrets."
4
+ version: 1
5
+ ---
6
+
7
+ # Huawei Cloud DEW (Data Encryption Workshop)
8
+
9
+ **STOP - Do not answer from general knowledge.** Follow the procedure below.
10
+
11
+ Always run `hcloud <Service> <Operation> --help` before constructing commands to discover exact parameter names and requirements.
12
+
13
+ ## Overview
14
+
15
+ Domain expertise for Huawei Cloud Data Encryption Workshop (DEW). Covers CSMS for secret lifecycle management, KMS for encryption key management, credential rotation, and secure application integration patterns.
16
+
17
+ ## Critical Warnings
18
+
19
+ | Trap | Why |
20
+ |------|-----|
21
+ | NEVER fetch secret values into agent context | Use {{resolve:csms:secret-id:SecretString:key}} runtime injection |
22
+ | NEVER echo credentials in conversation | AK/SK, passwords, tokens must never appear in chat |
23
+ | KMS key deletion is irreversible | 7-30 day pending deletion window. Once gone, data is unrecoverable |
24
+ | Secret rotation requires automation | Manual rotation risks stale credentials |
25
+ | Cross-account KMS needs grants | KMS keys are regional. Cross-region data needs grant setup |
26
+
27
+ ## CSMS Operations
28
+
29
+ ### Read-only (safe — metadata only)
30
+ | Operation | Description |
31
+ |-----------|-------------|
32
+ | ListSecrets | List all secrets (names only, no values) |
33
+ | DescribeSecret | Get secret metadata (rotation config, KMS key, status) |
34
+ | ListSecretVersions | List version IDs and stages (no values) |
35
+
36
+ ### Secret Value (blocked by policy — use runtime injection)
37
+ | Operation | Safe Alternative |
38
+ |-----------|-----------------|
39
+ | DownloadSecret | Use {{resolve:csms:secret-id}} in IaC or SDK |
40
+ | ShowSecretVersion | Use runtime injection, never in agent context |
41
+ | GetSecretValue | Blocked. Use MCP proxy resolve pattern |
42
+
43
+ ## KMS Operations
44
+
45
+ | Task | Command | Notes |
46
+ |------|---------|-------|
47
+ | List keys | hcloud KMS ListKeys | Read-only |
48
+ | Create key | hcloud KMS CreateKey --key_alias=<name> | Requires write approval |
49
+ | Encrypt | hcloud KMS EncryptData --key_id=<id> --plaintext=<b64> | Prefer SDK offline encrypt |
50
+ | Decrypt | hcloud KMS DecryptData (**BLOCKED**) | Use runtime injection |
51
+
52
+ ## Runtime Injection Pattern
53
+
54
+ `ash
55
+ # Terraform / IaC
56
+ resource "huaweicloud_csms_secret" "db_password" {
57
+ secret_string = var.db_password # NEVER hardcode
58
+ }
59
+
60
+ # SDK
61
+ secret_value = client.get_secret(secret_id="my-secret")
62
+ # Use immediately, never print or store in context
63
+
64
+ # hcloud (for approved automation only)
65
+ hcloud CSMS DownloadSecret --secret_name=<name>
66
+ # WARNING: Output goes to stdout. Pipe directly, never capture in agent.
67
+ `
68
+
69
+ ## Troubleshooting
70
+
71
+ | Error | Root Cause -> Fix |
72
+ |-------|------------------|
73
+ | Secret not found | Wrong region or project -> Verify secret ARN includes region/project |
74
+ | AccessDenied on CSMS | Missing IAM CSMS policy -> Add csms:DescribeSecret + kms:Decrypt |
75
+ | KMS key disabled | Key scheduled for deletion or manually disabled -> Enable or create new key |
76
+ | Rotation stuck | Lambda/Python function error -> Check rotation function logs |
77
+
78
+ ## Security Considerations
79
+
80
+ - MUST use runtime injection. NEVER fetch secrets into agent context
81
+ - MUST rotate credentials every 90 days
82
+ - MUST enable automatic rotation for CSMS secrets
83
+ - MUST audit KMS key usage via CTS
84
+ - SHOULD use customer-managed keys (CMK) for sensitive data
85
+ - MUST NOT use default KMS keys for production workloads
86
+
87
+ ## MCP Tools
88
+
89
+ - huaweicloud_list_operations service=DEW or CSMS or KMS
90
+ - huaweicloud_run_readonly_command for ListSecrets/ListKeys (metadata only)
91
+ - huaweicloud_safety policy blocks all secret value reads
92
+
93
+ ## References
94
+
95
+ - DEW Docs: https://support.huaweicloud.com/dew/
96
+ - CSMS usage: references/csms-usage.md
97
+ - KMS usage: references/kms-usage.md
@@ -1,29 +1,29 @@
1
- # CSMS Usage Guide
2
-
3
- ## Create Secret
4
- hcloud CSMS CreateSecret --secret_name=prod-db-password --secret_string='{"password":"CHANGE_ME"}'
5
-
6
- ## List Secrets (metadata only)
7
- hcloud CSMS ListSecrets
8
-
9
- ## Describe Secret
10
- hcloud CSMS DescribeSecret --secret_name=prod-db-password
11
-
12
- ## List Versions
13
- hcloud CSMS ListSecretVersions --secret_name=prod-db-password
14
-
15
- ## Runtime Injection (Terraform)
16
- data "huaweicloud_csms_secret" "db" {
17
- secret_name = "prod-db-password"
18
- }
19
- Use: data.huaweicloud_csms_secret.db.secret_string
20
-
21
- ## Rotation
22
- - Enable auto-rotation: hcloud CSMS EnableSecretRotation --secret_name=<name> --rotation_interval=30
23
- - Rotation function ARN: provide Lambda to generate new secret value
24
-
25
- ## Policy Rules
26
- - hcloud CSMS DownloadSecret -> BLOCKED (use runtime injection)
27
- - hcloud CSMS ShowSecretVersion -> BLOCKED
28
- - hcloud CSMS ListSecrets -> ALLOWED (metadata only)
29
- - hcloud CSMS DescribeSecret -> ALLOWED (metadata only)
1
+ # CSMS Usage Guide
2
+
3
+ ## Create Secret
4
+ hcloud CSMS CreateSecret --secret_name=prod-db-password --secret_string='{"password":"CHANGE_ME"}'
5
+
6
+ ## List Secrets (metadata only)
7
+ hcloud CSMS ListSecrets
8
+
9
+ ## Describe Secret
10
+ hcloud CSMS DescribeSecret --secret_name=prod-db-password
11
+
12
+ ## List Versions
13
+ hcloud CSMS ListSecretVersions --secret_name=prod-db-password
14
+
15
+ ## Runtime Injection (Terraform)
16
+ data "huaweicloud_csms_secret" "db" {
17
+ secret_name = "prod-db-password"
18
+ }
19
+ Use: data.huaweicloud_csms_secret.db.secret_string
20
+
21
+ ## Rotation
22
+ - Enable auto-rotation: hcloud CSMS EnableSecretRotation --secret_name=<name> --rotation_interval=30
23
+ - Rotation function ARN: provide Lambda to generate new secret value
24
+
25
+ ## Policy Rules
26
+ - hcloud CSMS DownloadSecret -> BLOCKED (use runtime injection)
27
+ - hcloud CSMS ShowSecretVersion -> BLOCKED
28
+ - hcloud CSMS ListSecrets -> ALLOWED (metadata only)
29
+ - hcloud CSMS DescribeSecret -> ALLOWED (metadata only)