Nacos CLI Skill

Nacos 配置中心命令行工具，用于管理 Nacos 配置和技能。

触发条件

当用户需要：

查看/管理 Nacos 配置
上传/下载技能到 Nacos
同步技能配置
管理多环境配置

环境要求

已安装 nacos-cli 命令行工具
配置文件位置: ~/.nacos-cli/<profile>.conf

命令速查

1. 配置管理

| 命令 | 说明 | 示例 | |------|------|------| | config-get | 获取配置 | nacos-cli config-get application.yaml DEFAULT_GROUP | | config-list | 列出配置 | nacos-cli config-list --group skill_* | | config-set | 发布配置 | nacos-cli config-set app.yaml DEFAULT_GROUP -f ./app.yaml |

config-get（获取配置）

# 基本用法
nacos-cli config-get <dataId> <group>

# 示例
nacos-cli config-get application.yaml DEFAULT_GROUP
nacos-cli config-get skill.json skill_skill-creator

# 指定环境
nacos-cli config-get application.yaml DEFAULT_GROUP --profile prod

config-list（列出配置）

# 列出所有配置
nacos-cli config-list

# 按 dataId 过滤（支持通配符）
nacos-cli config-list --data-id resource*

# 按 group 过滤（支持通配符）
nacos-cli config-list --group skill_*

# 组合过滤 + 分页
nacos-cli config-list --data-id *config* --group DEFAULT_GROUP --page 1 --size 50

config-set（发布配置）

# 从文件发布
nacos-cli config-set <dataId> <group> -f <filePath>

# 示例
nacos-cli config-set application.yaml DEFAULT_GROUP -f ./application.yaml

# 从标准输入发布
echo 'key: value' | nacos-cli config-set app.yaml DEFAULT_GROUP

# 发布技能配置
nacos-cli config-set skill.json skill_my-skill -f ./skill.json

2. 技能管理

| 命令 | 说明 | 示例 | |------|------|------| | skill-list | 列出技能 | nacos-cli skill-list --name creator | | skill-get | 下载技能 | nacos-cli skill-get skill-creator | | skill-upload | 上传技能 | nacos-cli skill-upload ./my-skill | | skill-sync | 实时同步 | nacos-cli skill-sync skill-creator |

skill-list（列出技能）

# 列出所有技能
nacos-cli skill-list

# 按名称搜索（支持通配符）
nacos-cli skill-list --name "creator"

# 分页查询
nacos-cli skill-list --page 2 --size 10

skill-get（下载技能）

# 下载单个技能到 ~/.skills/
nacos-cli skill-get <skillName>

# 下载多个技能
nacos-cli skill-get skill-creator skill-analyzer

# 指定输出目录
nacos-cli skill-get skill-creator -o ./my-skills

下载后的目录结构：

~/.skills/<skillName>/
├── SKILL.md        # 文档
├── scripts/        # 脚本文件
└── references/     # 参考文档

skill-upload（上传技能）

# 上传单个技能
nacos-cli skill-upload <skillPath>

# 示例
nacos-cli skill-upload ./my-skill

# 上传目录下所有技能
nacos-cli skill-upload --all ./skills-folder

要求：

技能目录必须包含 SKILL.md
技能名称：仅支持字母、下划线(_)、连字符(-)

skill-sync（实时同步）

# 同步单个技能（实时监听更新）
nacos-cli skill-sync <skillName>

# 同步多个技能
nacos-cli skill-sync skill-creator skill-analyzer

# 同步所有技能
nacos-cli skill-sync --all

# 指定输出目录
nacos-cli skill-sync skill-creator -d ./my-skills

按 Ctrl+C 停止同步。

3. Profile 管理

管理多环境配置（开发、测试、生产等）。

# 编辑默认配置
nacos-cli profile edit

# 编辑指定环境配置
nacos-cli profile edit dev
nacos-cli profile edit prod

# 查看配置
nacos-cli profile show
nacos-cli profile show dev

配置文件位置：~/.nacos-cli/<profile>.conf

4. 交互模式

启动交互式终端：

nacos-cli interactive

全局参数

| 参数 | 说明 | 示例 | |------|------|------| | --profile | 环境配置 | --profile prod | | --host | Nacos 地址 | --host 127.0.0.1 | | --port | Nacos 端口 | --port 8848 | | --namespace | 命名空间 | --namespace dev | | --username | 用户名 | --username nacos | | --password | 密码 | --password nacos | | --auth-type | 认证类型 | --auth-type nacos 或 --auth-type aliyun | | --access-key | 阿里云 AK | --access-key xxx | | --secret-key | 阿里云 SK | --secret-key xxx | | -c, --config | 配置文件路径 | -c ./nacos.conf |

常用场景

场景1：查看所有技能配置

nacos-cli config-list --group skill_*

场景2：下载并同步技能

# 下载技能
nacos-cli skill-get skill-creator

# 实时同步（开发时使用）
nacos-cli skill-sync skill-creator

场景3：多环境切换

# 使用开发环境
nacos-cli --profile dev skill-list

# 使用生产环境
nacos-cli --profile prod config-get application.yaml DEFAULT_GROUP

场景4：批量上传技能

# 上传当前目录下所有技能
nacos-cli skill-upload --all .

配置文件格式

~/.nacos-cli/default.conf:

host = 127.0.0.1
port = 8848
namespace = 
username = nacos
password = nacos
auth_type = nacos

阿里云 MSE Nacos：

host = mse-xxx.nacos.aliyuncs.com
port = 8848
namespace = your-namespace-id
auth_type = aliyun
access_key = your-access-key
secret_key = your-secret-key

输出格式

执行命令后，我会：

运行对应的 nacos-cli 命令
解析输出结果
以友好格式呈现给用户

注意事项

确保 nacos-cli 已安装且在 PATH 中
首次使用需要配置连接信息：nacos-cli profile edit
命名空间使用 ID 而非名称
技能名称仅支持字母、下划线、连字符
skill-sync 会持续运行，需手动 Ctrl+C 停止