expert_eval_cli 1.0.0 → 1.0.1

package/dist/index.js

@@ -12,7 +12,7 @@ function createProgram() {
     program
         .name('expert_eval')
         .description('AI-friendly CLI for ExpertEval API')
-        .version('1.0.0')
+        .version('1.0.1')
         .option('--format <type>', 'Output format: json, table, or auto (default: auto)', 'auto')
         .option('-q, --quiet', 'Suppress output (exit codes only)', false);
     program.addCommand((0, auth_js_1.makeAuthCommand)());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expert_eval_cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-friendly CLI for ExpertEval API — expert, version, eval-item and eval-record management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist/**/*",
+    "skill/**/*",
     "README.md",
     "LICENSE"
   ],

package/skill/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: expert-eval-cli
+version: "1.0.1"
+description: >
+  ExpertEval CLI 工具技能：帮助用户安装、更新 expert_eval_cli，完成认证，
+  并执行 experts、versions、eval-items、eval-records 的 CRUD 操作。
+  当用户提到 ExpertEval、专家评估、评审记录、版本管理、评估项目时触发。
+---
+
+# ExpertEval CLI 技能
+
+本技能帮助用户和 AI Agent 使用 `expert_eval_cli` 命令行工具与 ExpertEval API 交互。
+
+## 安装与更新
+
+### 首次安装
+
+```bash
+npm install -g expert_eval_cli
+```
+
+验证安装：
+
+```bash
+expert_eval --version
+```
+
+### 更新到最新版
+
+```bash
+npm update -g expert_eval_cli
+```
+
+或先卸载再安装：
+
+```bash
+npm uninstall -g expert_eval_cli
+npm install -g expert_eval_cli
+```
+
+## 认证
+
+ExpertEval CLI 支持两种方式提供 API Key：
+
+### 方式一：环境变量（推荐用于 CI/Agent）
+
+```bash
+export EXPERT_EVAL_API_KEY="your-api-key-here"
+export EXPERT_EVAL_BASE_URL="https://bytedance.feishuapp.com/app/app_17besd2kmya"
+```
+
+### 方式二：配置文件（推荐用于交互式使用）
+
+```bash
+expert_eval auth login your-api-key-here
+```
+
+可选指定 Base URL：
+
+```bash
+expert_eval auth login your-api-key-here --base-url https://bytedance-app_17besd2kmya-1872559030386954.aiforce.run/app/app_17besd2kmya
+```
+
+查看认证状态：
+
+```bash
+expert_eval auth status
+```
+
+登出（删除本地保存的 key）：
+
+```bash
+expert_eval auth logout
+```
+
+### Key 查找优先级
+
+1. `EXPERT_EVAL_API_KEY` 环境变量
+2. `~/.config/expert-eval/config.json` 配置文件
+
+### Base URL 切换
+
+- **线上环境**：`https://bytedance.feishuapp.com/app/app_17besd2kmya`（默认）
+- **开发环境**：`https://bytedance-app_17besd2kmya-1872559030386954.aiforce.run/app/app_17besd2kmya`
+
+切换方式：
+
+```bash
+# 临时切换（当前终端）
+export EXPERT_EVAL_BASE_URL=https://bytedance-app_17besd2kmya-1872559030386954.aiforce.run/app/app_17besd2kmya
+
+# 永久切换（重新登录）
+expert_eval auth login your-api-key --base-url https://bytedance-app_17besd2kmya-1872559030386954.aiforce.run/app/app_17besd2kmya
+```
+
+## AI Agent 使用指南
+
+Agent 调用 CLI 时，应优先使用 JSON 输出，便于解析：
+
+```bash
+# 强制 JSON 输出
+expert_eval --format json experts list
+
+# 或使用环境变量确保非交互式 JSON
+expert_eval experts list | cat
+```
+
+### 常用操作速查
+
+| 操作 | 命令 |
+|---|---|
+| 列出专家 | `expert_eval experts list` |
+| 创建专家 | `expert_eval experts create --expert-id exp-001 --name "AI安全专家"` |
+| 更新专家 | `expert_eval experts update --expert-id exp-001 --name "新名称"` |
+| 删除专家 | `expert_eval experts delete <id>` |
+| 列出版本 | `expert_eval versions list --expert-id exp-001` |
+| 创建版本 | `expert_eval versions create --expert-id exp-001 --hash abc123 --is-passed` |
+| 列出评估项 | `expert_eval eval-items list` |
+| 创建评估项 | `expert_eval eval-items create --title "接口规范性" --item-types structure,process` |
+| 列出评审记录 | `expert_eval eval-records list --version-id v-1` |
+| 创建评审记录 | `expert_eval eval-records create --version-id v-1 --eval-item-id ei-1 --is-passed` |
+
+### 分页查询
+
+所有 list 命令支持分页：
+
+```bash
+expert_eval experts list --page 2 --page-size 20
+```
+
+### 错误处理
+
+Agent 应检查 exit code：
+
+- `0` — 成功
+- `1` — 一般错误
+- `2` — 认证错误
+- `3` — 参数校验错误
+
+JSON 错误输出格式：
+
+```json
+{
+  "success": false,
+  "code": "HTTP_400",
+  "message": "Bad request",
+  "details": { "field": "name" }
+}
+```
+
+## 参考资料
+
+- `references/api-reference.md` — ExpertEval API 端点速查

package/skill/references/api-reference.md

@@ -0,0 +1,123 @@
+# ExpertEval API Reference
+
+Base URLs:
+- Production: `https://bytedance.feishuapp.com/app/app_17besd2kmya`
+- Development: `https://bytedance-app_17besd2kmya-1872559030386954.aiforce.run/app/app_17besd2kmya`
+
+Auth: Bearer token via `Authorization: Bearer <API_KEY>` header.
+
+## Experts
+
+### `GET /openapi/experts`
+List experts (paginated).
+
+Query params:
+- `page` (int, default 1)
+- `pageSize` (int, default 50)
+- `keyword` (string, optional)
+
+Response: `{ items: Expert[], total, page, pageSize }`
+
+### `POST /openapi/experts`
+Create expert (idempotent by `expertId`).
+
+Body: `{ expertId, name, avatar?, tags?, description?, recommendedQuestion?, aiTags?, owner?, latestVersionId? }`
+
+### `PUT /openapi/experts`
+Update expert (idempotent by `expertId`, creates if absent).
+
+Body: same as POST, all fields required except those marked optional.
+
+### `GET /openapi/experts/{id}`
+Get expert by primary ID.
+
+### `DELETE /openapi/experts/{id}`
+Delete expert by primary ID.
+
+Response: `{ id }`
+
+## Versions
+
+### `GET /openapi/versions`
+List versions (paginated).
+
+Query params:
+- `page` (int, default 1)
+- `pageSize` (int, default 50)
+- `expertId` (string, optional filter)
+
+### `POST /openapi/versions`
+Create version (idempotent by `expertId` + `hash`).
+
+Body: `{ expertId, hash, commitMessage?, author?, versionDate?, isPassed, bac?, dcg? }`
+
+### `PUT /openapi/versions`
+Update version (idempotent by `expertId` + `hash`).
+
+Body: same shape as POST.
+
+### `GET /openapi/versions/{id}`
+Get version by primary ID.
+
+### `DELETE /openapi/versions/{id}`
+Delete version by primary ID.
+
+Response: `{ id }`
+
+## Eval Items
+
+### `GET /openapi/eval-items`
+List eval items (paginated).
+
+Query params:
+- `page` (int, default 1)
+- `pageSize` (int, default 50)
+
+### `POST /openapi/eval-items`
+Create eval item.
+
+Body: `{ title, itemTypes?, query?, acceptanceCriteria?, isVeto? }`
+
+`itemTypes` enum values: `structure`, `bac`, `dcg`, `process`, `deliver`.
+
+### `GET /openapi/eval-items/{id}`
+Get eval item by primary ID.
+
+### `PUT /openapi/eval-items/{id}`
+Update eval item by primary ID.
+
+Body: `{ title?, itemTypes?, query?, acceptanceCriteria?, isVeto? }`
+
+### `DELETE /openapi/eval-items/{id}`
+Delete eval item by primary ID.
+
+Response: `{ id }`
+
+## Eval Records
+
+### `GET /openapi/eval-records`
+List eval records (paginated).
+
+Query params:
+- `page` (int, default 1)
+- `pageSize` (int, default 50)
+- `versionId` (string, optional filter)
+- `evalItemId` (string, optional filter)
+
+### `POST /openapi/eval-records`
+Create eval record.
+
+Body: `{ versionId, evalItemId, query?, result?, isPassed, bac?, dcg? }`
+
+### `GET /openapi/eval-records/{id}`
+Get eval record by primary ID.
+
+### `PUT /openapi/eval-records/{id}`
+Update eval record by primary ID.
+
+Body: `{ versionId?, evalItemId?, query?, result?, isPassed?, bac?, dcg? }`
+
+### `DELETE /openapi/eval-records/{id}`
+Delete eval record by primary ID.
+
+Response: `{ id }`