bfi-cli 0.1.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "bfi-cli",
+  "version": "0.1.0",
+  "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
+  "type": "module",
+  "bin": {
+    "bfi": "./bin/bfi.mjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "obuild",
+    "dev": "node src/cli.ts",
+    "test": "vitest",
+    "type-check": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "skillhub",
+    "skills",
+    "ai-agents",
+    "bfi"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@clack/prompts": "^1.2.0",
+    "@types/bun": "latest",
+    "@types/node": "^22.10.0",
+    "obuild": "^0.4.22",
+    "picocolors": "^1.1.1",
+    "prettier": "^3.8.1",
+    "simple-git": "^3.27.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17",
+    "xdg-basedir": "^5.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@vercel/detect-agent": "^1.2.3",
+    "yaml": "^2.8.3"
+  }
+}

package/skills/gbfi-skill/SKILL.md

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