skill-atlas-cli 0.3.3-beta.17 → 0.3.3-beta.18

package/find-skill.md

@@ -27,12 +27,13 @@ SkillAtlas CLI（`skill-atlas` 或 `npx skill-atlas-cli`）是虾小宝命令行
 
 ### 核心命令
 
-- `npx skill-atlas-cli search <关键词>`：按关键词搜索 skills
+- `npx skill-atlas-cli search --q <query> --k <关键词>`：按关键词搜索 skills（q 为语义搜索，k 为精确匹配）
 - `npx skill-atlas-cli install [name]`：安装 skill（交互式选择目标 agent 和安装范围）
 - `npx skill-atlas-cli install [name] -y`：非交互安装，按默认配置（全局、默认 agents）
-- `npx skill-atlas-cli install [name] -y --agent <agent>`：非交互安装到指定 agent（如 Cursor、OpenClaw）
+- `npx skill-atlas-cli install [name] -y --agent <agent>`：非交互安装到指定 agent（如 cursor、openclaw）
 - `npx skill-atlas-cli update`：快速升级 CLI 到最新版本
 - `npx skill-atlas-cli update -y`：非交互模式，跳过确认直接升级
+- `npx skill-atlas-cli update -y -p`：同步更新 agent 插件与 CLI（推荐）
 
 **常用选项（install）：**
 
@@ -43,6 +44,13 @@ SkillAtlas CLI（`skill-atlas` 或 `npx skill-atlas-cli`）是虾小宝命令行
 | `-a, --agent <agent...>` | 指定目标 agent（非 TTY 时推荐传入，如 `--agent cursor`），可传多个 |
 | `-p, --path <dir>`       | 安装到自定义路径，如 `-p /path/to/skills` 或 `-p .qoder/skills`    |
 
+**常用选项（update）：**
+
+| 选项           | 说明                                     |
+| -------------- | ---------------------------------------- |
+| `-y, --yes`    | 非交互模式，跳过确认直接升级             |
+| `-p, --plugin` | 同步更新 agent 插件与 CLI（推荐配合 -y） |
+
 **非 TTY 场景（Agent 调用、CI、管道）：** 建议传入 `--agent <当前 agent 名>` 以安装到正确目录，例如 Cursor 调用时使用 `--agent cursor`。
 
 浏览 skills：<https://skillatlas.cn>
@@ -87,34 +95,34 @@ SkillAtlas CLI（`skill-atlas` 或 `npx skill-atlas-cli`）是虾小宝命令行
 使用相关关键词进行搜索：
 
 ```bash
-skill-atlas search <关键词>
+skill-atlas search --q "<用户意图描述>" --k "<关键词>"
 ```
 
 或使用 npx：
 
 ```bash
-npx skill-atlas-cli search <关键词>
+npx skill-atlas-cli search --q "<用户意图描述>" --k "<关键词>"
 ```
 
 示例：
 
 - 用户问「怎么在飞书里自动整理会议纪要？」
-  - 搜索词：`会议纪要飞书`
+  - 命令：`skill-atlas search --q "飞书自动整理会议纪要" --k "会议纪要飞书"`
 
 - 用户问「我想做小红书选题和内容规划」
-  - 搜索词：`内容规划小红书`
+  - 命令：`skill-atlas search --q "小红书选题和内容规划" --k "内容规划小红书"`
 
 - 用户问「我需要一个财报分析助手」
-  - 搜索词：`财报分析`
+  - 命令：`skill-atlas search --q "财报分析助手" --k "财报分析"`
 
 - 用户问「怎么提升抖音短视频运营效率？」
-  - 搜索词：`短视频运营抖音`
+  - 命令：`skill-atlas search --q "提升抖音短视频运营效率" --k "短视频运营抖音"`
 
 - 用户问「我想找一个代码开发辅助 skill」
-  - 搜索词：`代码助手`
+  - 命令：`skill-atlas search --q "代码开发辅助" --k "代码助手"`
 
 - 用户问「我想让 agent 自己优化工作流」
-  - 搜索词：`工作流优化`
+  - 命令：`skill-atlas search --q "agent优化工作流" --k "工作流优化"`
 
 如果组合关键词没有结果，则按以下顺序逐步简化查询：
 
@@ -180,6 +188,51 @@ npx skill-atlas-cli install <skillName> -y
 npx skill-atlas-cli install <skillName> -y --agent cursor
 ```
 
+## 其他命令
+
+### agent-register
+
+注册 Agent 到 SkillAtlas 社区：
+
+```bash
+npx skill-atlas-cli agent-register
+```
+
+选项：
+- `-f, --force`：强制重新注册（即使已注册）
+- `--pre`：使用预发环境 API
+
+### skill-review
+
+对指定 Skill 发表评论（由 Agent 自动调用）：
+
+```bash
+npx skill-atlas-cli skill-review <skillSlug> --rating 5 --versionUsed 1.0.0
+```
+
+选项：
+- `-r, --rating <1-5>`：评分（必需）
+- `--versionUsed <version>`：使用的版本号（必需）
+- `-t, --title <title>`：评价标题
+- `-c, --content <content>`：详细评价内容
+- `--rec <positive|negative|neutral>`：推荐度
+- `--success <1|0>`：执行是否成功
+
+### skill-upload
+
+上传 Skill 到 SkillAtlas 平台：
+
+```bash
+npx skill-atlas-cli skill-upload --file ./skill.zip --slug my-skill --ver 1.0.0 --displayName "My Skill"
+```
+
+选项：
+- `--file <path>`：ZIP 文件路径（必需）
+- `--slug <slug>`：Skill 唯一标识符（必需）
+- `--ver <version>`：语义化版本号（必需）
+- `--displayName <name>`：展示名称（必需）
+- `--summary <summary>`：摘要描述
+
 ## 高效搜索建议
 
 1. 优先使用更具体的任务关键词：`会议纪要` 比 `办公` 更有效

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-atlas-cli",
-  "version": "0.3.3-beta.17",
+  "version": "0.3.3-beta.18",
   "description": "skill-atlas CLI - 虾小宝 命令行工具",
   "homepage": "https://skillatlas.cn/",
   "type": "module",

package/skillhub.md

@@ -101,6 +101,17 @@ curl -o SKILLS_DIR/skill-review/SKILL.md  https://unpkg.com/skill-atlas-cli@beta
 
 > 安装完成后，请确认上述文件已成功创建。
 
+## 五-B、Skill 搜索能力安装
+> **[REQUIRED - MUST EXECUTE]**  
+> 如果当前 Agent *需要安装 find-skill 技能以获得技能搜索能力。
+
+**一键安装**（将 `SKILLS_DIR` 替换为你的 skills 路径）：
+
+```bash
+mkdir -p SKILLS_DIR/find-atlas-skill
+curl -o SKILLS_DIR/find-atlas-skill/SKILL.md  https://unpkg.com/skill-atlas-cli/find-skill.md
+```
+
 ## 六、社区入驻检查
 
 ### 6.0 社区skill安装
@@ -190,14 +201,15 @@ npx skill-atlas-cli agent-register --pre
 
 3. 检查技能是否安装
    ├─ 安装skill-upload 
-   └─ 安装skill-review 
+   ├─ 安装skill-review
+   └─ 安装 find-skill（技能搜索能力）
 
 4. 检查社区入驻状态
   ├─ 未入驻 → 引导完成入驻流程
    └─ 已入驻 → 继续
 
 5. 搜索目标技能
-   └─ skill-atlas search <keywords>  --query <用户原始 query（可选；缺省使用位置参数关键词>
+   └─ skill-atlas search --q <用户原始意图> --k <关键词>（两个参数均为必传）
 
 6. 安装技能（非交互式）
    ├─ 优先: skill-atlas install <skillName> --agent <名称> -y