bfi-cli 0.1.26 → 0.1.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bfi-cli",
-  "version": "0.1.26",
+  "version": "0.1.35",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {

package/skills/skillhub-skills/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: skillhub-skills
+description: 使用 bfi CLI 在 SkillHub 上搜索、安装、发布和管理技能。当用户需要查找技能、从任意来源安装技能、发布技能到 SkillHub 或管理技能包时使用。
+---
+
+# skillhub-skills — SkillHub 命令行工具
+
+bfi 是 SkillHub 生态的统一命令行工具。融合了开源 agent skills 生态能力和 SkillHub 专有功能。
+
+## ⚠️ 第零步：检查 bfi CLI 是否安装（最早执行）
+
+**在执行任何 SkillHub 操作之前，必须先确认 bfi CLI 已安装。**
+
+静默运行 `bfi --version`。如果返回错误或未找到命令：
+
+```
+需要安装 bfi CLI 工具。正在安装：
+
+```bash
+npm install -g bfi-cli
+```
+
+安装完成后，继续执行后续步骤。
+
+**在做任何操作之前，必须先确认用户已登录。**
+
+静默运行 `bfi whoami`。如果返回错误或未认证：
+
+```
+你需要登录 SkillHub 才能继续。请提供你的 API Token。
+
+获取 Token 方式：打开 https://bfi.yyuap.com:811/ → 控制台 → 个人设置 → API Token
+
+请直接回复你的 Token，我会自动完成登录。
+```
+
+用户提供 Token 后，立即静默执行：
+```bash
+bfi auth login --token <用户提供的Token>
+```
+
+登录成功后，继续执行用户原本请求的操作，无需用户再次输入。如果登录失败，告知用户 Token 无效，请重新提供。
+
+## 判断场景
+
+根据用户意图选择对应场景：
+
+### 场景 1：使用技能（搜索、安装、使用、查看）
+
+用户想找技能、安装技能、试用技能、查看已安装的技能。
+
+**1.1 搜索技能**
+```bash
+bfi skills search <关键词>                      # 搜索 SkillHub（默认）
+bfi skills search <关键词> --marketplace        # 搜索 skills.sh 公开市场
+```
+
+**1.2 查看技能详情**
+```bash
+bfi skills info <@namespace/slug 或 namespace--slug>
+```
+
+**1.3 安装技能**
+```bash
+# SkillHub
+bfi skills add @命名空间/技能名
+bfi skills add 命名空间--技能名
+
+# Git 仓库（默认 git.yyrd.com）
+bfi skills add owner/repo --skill <name>        # 指定仓库中的某个技能
+bfi skills add owner/repo                       # 安装全部技能
+bfi skills add owner/repo --branch <分支>        # 指定分支
+
+# GitHub
+bfi skills add github:owner/repo                # 强制走 github.com
+
+# 安装选项
+bfi skills add <来源> -y                         # 跳过交互确认
+bfi skills add <来源> --list                     # 仅列出技能，不安装
+```
+
+**1.4 安装技能包**
+```bash
+bfi skills package install @namespace/package-name
+```
+
+**1.5 查看已安装**
+```bash
+bfi skills list
+bfi skills ls -g                                # 全局安装的技能
+```
+
+**1.6 使用技能（不安装）**
+```bash
+bfi skills use <来源>                            # 生成 prompt 文本
+```
+
+### 场景 2：管理技能（发布、更新、卸载、包管理）
+
+用户想发布技能、管理包、更新/卸载技能。
+
+**2.1 发布技能**
+```bash
+# 从 Git 发布（推荐，自动发现所有技能）
+bfi skills publish owner/repo --from git --namespace <ns>
+
+# 从本地目录发布
+bfi skills publish <路径> --namespace <ns>
+
+# 从 ZIP 发布
+bfi skills publish <路径> --from zip --namespace <ns>
+
+# 选项
+# --visibility public   公开发布（默认）
+# --branch <分支>        指定分支（默认 main）
+# --skill <name>         只发布指定技能
+# -y                     跳过确认
+```
+
+**2.2 卸载技能**
+```bash
+bfi skills remove <技能名> -y
+```
+
+**2.3 更新技能**
+```bash
+bfi skills update                                # 更新全部
+bfi skills update <技能名>
+# Git 来源的技能会检查远端更新
+# SkillHub 来源的技能请用 bfi skills add 重新安装
+```
+
+**2.4 技能包管理**
+```bash
+# 创建包
+bfi skills package create <slug> --namespace <ns>
+
+# 添加技能到包
+bfi skills package add-skills @ns/pkg <skill...>
+
+# 从包移除技能
+bfi skills package remove-skills @ns/pkg <skill...>
+
+# 安装包
+bfi skills package install @ns/pkg
+
+# 卸载包
+bfi skills package uninstall @ns/pkg
+
+# 查看已安装的包
+bfi skills package list
+```
+
+### 场景 3：记录技能调用
+
+**每次使用技能时必须记录：**
+```bash
+bfi skills log <技能名> "简要描述"
+```
+
+## 技能引用格式
+
+| 格式 | 示例 | 说明 |
+|------|------|------|
+| `@ns/slug` | `@retail/skill-pm` | SkillHub 技能 |
+| `ns--slug` | `retail--skill-pm` | 兼容格式 |
+| `owner/repo` | `bfi/bfi-skill` | Git 仓库（默认 git.yyrd.com） |
+| `github:owner/repo` | `github:vercel-labs/agent-skills` | 强制 GitHub |
+
+## 配置
+
+```bash
+bfi config get                     # 查看全部配置
+bfi config set registry <url> --global  # 设置 API 地址
+bfi config set namespace <ns>      # 设置默认命名空间
+```
+
+## 常见问题
+
+**Q: 公司 GitLab 仓库中的技能找不到？**
+A: 默认从 git.yyrd.com 克隆。如果是 GitHub 上的技能，使用 `github:` 前缀。
+
+**Q: 如何更新 SkillHub 上的技能？**
+A: 用 `bfi skills publish` 重新发布即可，服务端自动版本管理。
+
+**Q: 发布失败？**
+A: 确保 SKILL.md 文件在发布目录或仓库中，且包含 name 和 description 字段。

package/skills/bfi-skill/SKILL.md

@@ -1,176 +0,0 @@
----
-name: bfi-skill
-description: 使用 bfi CLI 在 SkillHub 上搜索、安装、发布和管理技能。当用户需要查找技能、从任意来源安装技能、发布技能到 SkillHub 或管理技能包时使用。
----
-
-# bfi-skill — SkillHub 命令行工具
-
-bfi 是 SkillHub 生态的统一命令行工具。融合了开源 agent skills 生态能力（70+ AI agent 支持、GitHub/GitLab/URL 多源安装）和 SkillHub 专有功能（发布、包管理、认证）。
-
-## 何时使用
-
-当用户有以下需求时使用 bfi：
-- 搜索技能（"帮我找个 React 技能"、"搜索数据库相关的技能"）
-- 安装技能（"安装这个技能"、"把 db-explore 装上"）
-- 发布技能（"发布我的技能"、"把这个技能上传到 SkillHub"）
-- 管理技能包（"创建一个技能包"、"把几个技能打包"）
-- 认证操作（"登录 skillhub"、"查看当前用户"）
-- 查看/卸载已安装技能（"我装了哪些技能"、"卸载某某技能"）
-
-## 全局选项
-
-```
---token <token>      API Token（也可通过 BFI_TOKEN 环境变量设置）
---registry <url>     API 地址（默认: https://bfi.yyuap.com:811）
---namespace <ns>     默认命名空间（默认: global）
---help, -h           显示帮助
---version, -v        显示版本
-```
-
-Token 解析优先级：CLI `--token` → 环境变量 `BFI_TOKEN` → 项目配置 `.bfirc` → 全局配置 `~/.bfirc`
-
-## 命令参考
-
-### 认证
-
-```bash
-bfi auth login --token <token>    # 保存 API Token 到本地
-bfi auth logout                   # 清除已保存的 Token
-bfi auth whoami                   # 查看当前登录用户信息
-```
-
-### 搜索
-
-```bash
-bfi skills search <关键词>                    # 搜索 SkillHub 市场（默认）
-bfi skills search <关键词> --namespace <ns>   # 在指定命名空间搜索
-bfi skills search <关键词> --marketplace      # 搜索 skills.sh 公开市场
-bfi skills search <关键词> --all              # 同时搜索 SkillHub + skills.sh
-bfi skills search <关键词> --json             # JSON 格式输出
-bfi skills search <关键词> --limit 50         # 最大返回数（默认 20）
-```
-
-### 安装
-
-```bash
-# 从 SkillHub 安装
-bfi skills add @命名空间/技能名                # 从 SkillHub 安装指定技能
-bfi skills add 命名空间--技能名                # 兼容格式
-bfi skills add 技能名                          # 跨命名空间搜索并安装
-
-# 从 GitHub/GitLab 安装
-bfi skills add owner/repo                    # GitHub 简写
-bfi skills add owner/repo/路径/到/技能       # 指定子目录
-bfi skills add owner/repo@技能名             # 指定仓库中的某个技能
-bfi skills add https://github.com/owner/repo # 完整 URL
-bfi skills add gitlab:owner/repo             # GitLab 简写
-
-# 安装选项
-bfi skills add <来源> --skill <名称>          # 安装指定技能
-bfi skills add <来源> --agent <agent>        # 安装到指定 agent
-bfi skills add <来源> -g                      # 全局安装
-bfi skills add <来源> --all                   # 安装全部技能到全部 agent
-bfi skills add <来源> --list                   # 仅列出可用技能，不安装
-```
-
-### 查看
-
-```bash
-bfi skills list                   # 列出项目已安装技能
-bfi skills ls -g                  # 列出全局已安装技能
-bfi skills ls --json              # JSON 格式输出
-bfi skills ls -a claude-code      # 按 agent 过滤
-
-bfi skills info @命名空间/技能名    # 查看 SkillHub 技能详情
-bfi skills info 命名空间--技能名    # 兼容格式
-bfi skills info <引用> --json      # JSON 格式输出
-```
-
-### 卸载
-
-```bash
-bfi skills remove                 # 交互式选择卸载
-bfi skills remove 技能名           # 卸载指定技能
-bfi skills rm -g 技能名            # 从全局卸载
-bfi skills remove --all           # 卸载全部技能
-```
-
-### 更新
-
-```bash
-bfi skills update                 # 更新全部已安装技能
-bfi skills update 技能名           # 更新指定技能
-bfi skills update -g              # 更新全局技能
-```
-
-### 发布
-
-```bash
-bfi skills publish                          # 发布当前目录的技能
-bfi skills publish <路径>                    # 从指定目录发布
-bfi skills publish <路径> --from zip         # 从 .zip 压缩包发布
-bfi skills publish <url> --from git          # 走服务端 Git API（parse → publish）
-bfi skills publish <路径> --namespace <ns>    # 指定目标命名空间
-bfi skills publish <路径> --visibility public # 公开发布
-bfi skills publish <路径> --yes              # 跳过确认提示
-```
-
-### 技能包管理
-
-```bash
-bfi skills package list [--namespace <ns>]           # 列出技能包
-bfi skills package info @ns/包名                     # 查看包详情
-bfi skills package create <slug> [--name] [--desc]   # 创建技能包
-bfi skills package add <包名> <技能...>               # 添加技能到包
-bfi skills package remove <包名> <技能...>             # 从包移除技能
-```
-
-### 初始化
-
-```bash
-bfi skills init                  # 在当前目录创建 SKILL.md
-bfi skills init 技能名            # 在子目录中创建 SKILL.md
-```
-
-## 技能引用格式
-
-SkillHub 技能使用带命名空间的引用格式：
-
-| 格式 | 示例 | 说明 |
-|------|------|------|
-| `@ns/slug` | `@myteam/db-explore` | 命名空间 myteam，技能 db-explore |
-| `ns--slug` | `myteam--db-explore` | 同上（兼容旧格式） |
-| `slug` | `db-explore` | 仅 slug，安装时自动搜索全部命名空间 |
-
-## 配置管理
-
-```bash
-bfi config get                   # 查看全部配置
-bfi config get registry          # 查看指定配置项
-bfi config set registry <url>    # 设置项目配置
-bfi config set registry <url> --global  # 设置全局配置
-bfi config set namespace <ns>    # 设置默认命名空间
-```
-
-## 典型用法示例
-
-```bash
-# 完整流程：搜索 → 安装 → 查看
-bfi skills search react
-bfi skills add @myteam/react-best-practices
-bfi skills list
-
-# 发布技能
-bfi skills init my-skill
-# ... 编辑 my-skill/SKILL.md ...
-bfi auth login --token sk-xxx
-bfi skills publish my-skill --namespace myteam --visibility public
-
-# 技能包管理
-bfi skills package create frontend-kit --namespace myteam
-bfi skills package add @myteam/frontend-kit @myteam/react-best-practices @myteam/css-guide
-bfi skills package info @myteam/frontend-kit
-
-# 从 GitHub 安装
-bfi skills add vercel-labs/agent-skills --skill pr-review --agent claude-code
-```