Skip to content

Commit 252f85c

Browse files
committed
feat: Fix the generation format of skills
1 parent db5a961 commit 252f85c

21 files changed

Lines changed: 614 additions & 615 deletions

packages/cli/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
"registry": "https://registry.npmjs.org/"
3737
},
3838
"scripts": {
39-
"generate:reference": "node --experimental-strip-types ../../tools/generate-reference.ts",
39+
"generate:reference": "node --experimental-strip-types ../../tools/generate-reference.ts && sh -c 'cd ../.. && vp check --fix skills/bailian-cli/reference'",
4040
"build": "pnpm run generate:reference && vp pack",
4141
"dev": "node src/main.ts",
4242
"test": "vp test",

skills/bailian-cli/reference/advisor.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,27 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
10+
| Command | Description |
11+
| ---------------------- | ---------------------------------------------------------------------------------------------- |
1212
| `bl advisor recommend` | Recommend the best models for your use case (intent analysis → candidate recall → LLM ranking) |
1313

1414
## Command details
1515

1616
### `bl advisor recommend`
1717

18-
| Field | Value |
19-
| --- | --- |
20-
| **Name** | `advisor recommend` |
18+
| Field | Value |
19+
| --------------- | ---------------------------------------------------------------------------------------------- |
20+
| **Name** | `advisor recommend` |
2121
| **Description** | Recommend the best models for your use case (intent analysis → candidate recall → LLM ranking) |
22-
| **Usage** | `bl advisor recommend <prompt> [flags]` |
22+
| **Usage** | `bl advisor recommend <prompt> [flags]` |
2323

2424
#### Options
2525

26-
| Flag | Type | Required | Description |
27-
| --- | --- | --- | --- |
28-
| `--message <text>` | string | no | Describe your requirements (alternative to positional prompt) |
29-
| `--dry-run` | boolean | no | Show intent analysis and candidate list without LLM ranking |
30-
| `--output <format>` | string | no | Output format: text (default in TTY), json, yaml |
26+
| Flag | Type | Required | Description |
27+
| ------------------- | ------- | -------- | ------------------------------------------------------------- |
28+
| `--message <text>` | string | no | Describe your requirements (alternative to positional prompt) |
29+
| `--dry-run` | boolean | no | Show intent analysis and candidate list without LLM ranking |
30+
| `--output <format>` | string | no | Output format: text (default in TTY), json, yaml |
3131

3232
#### Examples
3333

skills/bailian-cli/reference/app.md

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -7,35 +7,35 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
10+
| Command | Description |
11+
| ------------- | ---------------------------------------------- |
1212
| `bl app call` | Call a Bailian application (agent or workflow) |
13-
| `bl app list` | List Bailian applications |
13+
| `bl app list` | List Bailian applications |
1414

1515
## Command details
1616

1717
### `bl app call`
1818

19-
| Field | Value |
20-
| --- | --- |
21-
| **Name** | `app call` |
22-
| **Description** | Call a Bailian application (agent or workflow) |
23-
| **Usage** | `bl app call --app-id <id> --prompt <text> [flags]` |
19+
| Field | Value |
20+
| --------------- | --------------------------------------------------- |
21+
| **Name** | `app call` |
22+
| **Description** | Call a Bailian application (agent or workflow) |
23+
| **Usage** | `bl app call --app-id <id> --prompt <text> [flags]` |
2424

2525
#### Options
2626

27-
| Flag | Type | Required | Description |
28-
| --- | --- | --- | --- |
29-
| `--app-id <id>` | string | yes | Application ID (required) |
30-
| `--prompt <text>` | string | yes | Input prompt text |
31-
| `--image <url>` | array | no | Image URL(s) to pass to the app (repeatable) |
32-
| `--file-id <id>` | array | no | Pre-uploaded file ID(s) (repeatable) |
33-
| `--session-id <id>` | string | no | Session ID for multi-turn conversation |
34-
| `--stream` | boolean | no | Stream response (default: on in TTY) |
35-
| `--pipeline-ids <ids>` | string | no | Knowledge base pipeline IDs (comma-separated) |
36-
| `--memory-id <id>` | string | no | Memory ID for long-term memory |
37-
| `--biz-params <json>` | string | no | Business parameters JSON (workflow variables) |
38-
| `--has-thoughts` | boolean | no | Show agent thinking process |
27+
| Flag | Type | Required | Description |
28+
| ---------------------- | ------- | -------- | --------------------------------------------- |
29+
| `--app-id <id>` | string | yes | Application ID (required) |
30+
| `--prompt <text>` | string | yes | Input prompt text |
31+
| `--image <url>` | array | no | Image URL(s) to pass to the app (repeatable) |
32+
| `--file-id <id>` | array | no | Pre-uploaded file ID(s) (repeatable) |
33+
| `--session-id <id>` | string | no | Session ID for multi-turn conversation |
34+
| `--stream` | boolean | no | Stream response (default: on in TTY) |
35+
| `--pipeline-ids <ids>` | string | no | Knowledge base pipeline IDs (comma-separated) |
36+
| `--memory-id <id>` | string | no | Memory ID for long-term memory |
37+
| `--biz-params <json>` | string | no | Business parameters JSON (workflow variables) |
38+
| `--has-thoughts` | boolean | no | Show agent thinking process |
3939

4040
#### Examples
4141

@@ -65,20 +65,20 @@ bl app call --app-id abc123 --prompt "开始" --biz-params '{"key":"value"}'
6565

6666
### `bl app list`
6767

68-
| Field | Value |
69-
| --- | --- |
70-
| **Name** | `app list` |
68+
| Field | Value |
69+
| --------------- | ------------------------- |
70+
| **Name** | `app list` |
7171
| **Description** | List Bailian applications |
72-
| **Usage** | `bl app list [flags]` |
72+
| **Usage** | `bl app list [flags]` |
7373

7474
#### Options
7575

76-
| Flag | Type | Required | Description |
77-
| --- | --- | --- | --- |
78-
| `--name <name>` | string | no | Filter by app name (keyword search) |
79-
| `--page <n>` | number | no | Page number (default: 1) |
80-
| `--page-size <n>` | number | no | Results per page (default: 30) |
81-
| `--region <region>` | string | no | API region (default: cn-beijing) |
76+
| Flag | Type | Required | Description |
77+
| ------------------- | ------ | -------- | ----------------------------------- |
78+
| `--name <name>` | string | no | Filter by app name (keyword search) |
79+
| `--page <n>` | number | no | Page number (default: 1) |
80+
| `--page-size <n>` | number | no | Results per page (default: 30) |
81+
| `--region <region>` | string | no | API region (default: cn-beijing) |
8282

8383
#### Examples
8484

skills/bailian-cli/reference/auth.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -7,28 +7,28 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
12-
| `bl auth login` | Authenticate with API key or console browser login (credentials can coexist) |
13-
| `bl auth logout` | Clear stored credentials |
14-
| `bl auth status` | Show current authentication state |
10+
| Command | Description |
11+
| ---------------- | ---------------------------------------------------------------------------- |
12+
| `bl auth login` | Authenticate with API key or console browser login (credentials can coexist) |
13+
| `bl auth logout` | Clear stored credentials |
14+
| `bl auth status` | Show current authentication state |
1515

1616
## Command details
1717

1818
### `bl auth login`
1919

20-
| Field | Value |
21-
| --- | --- |
22-
| **Name** | `auth login` |
20+
| Field | Value |
21+
| --------------- | ---------------------------------------------------------------------------- |
22+
| **Name** | `auth login` |
2323
| **Description** | Authenticate with API key or console browser login (credentials can coexist) |
24-
| **Usage** | `bl auth login --api-key <key> \| bl auth login --console` |
24+
| **Usage** | `bl auth login --api-key <key> \| bl auth login --console` |
2525

2626
#### Options
2727

28-
| Flag | Type | Required | Description |
29-
| --- | --- | --- | --- |
30-
| `--api-key <key>` | string | no | DashScope API key to store |
31-
| `--console` | boolean | no | Sign in via browser; opens the console login URL in your default browser |
28+
| Flag | Type | Required | Description |
29+
| ----------------- | ------- | -------- | ------------------------------------------------------------------------ |
30+
| `--api-key <key>` | string | no | DashScope API key to store |
31+
| `--console` | boolean | no | Sign in via browser; opens the console login URL in your default browser |
3232

3333
#### Examples
3434

@@ -42,18 +42,18 @@ bl auth login --console
4242

4343
### `bl auth logout`
4444

45-
| Field | Value |
46-
| --- | --- |
47-
| **Name** | `auth logout` |
48-
| **Description** | Clear stored credentials |
49-
| **Usage** | `bl auth logout [--console] [--yes] [--dry-run]` |
45+
| Field | Value |
46+
| --------------- | ------------------------------------------------ |
47+
| **Name** | `auth logout` |
48+
| **Description** | Clear stored credentials |
49+
| **Usage** | `bl auth logout [--console] [--yes] [--dry-run]` |
5050

5151
#### Options
5252

53-
| Flag | Type | Required | Description |
54-
| --- | --- | --- | --- |
55-
| `--console` | boolean | no | Only clear the console access_token, keep api_key intact |
56-
| `--yes` | boolean | no | Skip confirmation prompt |
53+
| Flag | Type | Required | Description |
54+
| ----------- | ------- | -------- | -------------------------------------------------------- |
55+
| `--console` | boolean | no | Only clear the console access_token, keep api_key intact |
56+
| `--yes` | boolean | no | Skip confirmation prompt |
5757

5858
#### Examples
5959

@@ -75,11 +75,11 @@ bl auth logout --yes
7575

7676
### `bl auth status`
7777

78-
| Field | Value |
79-
| --- | --- |
80-
| **Name** | `auth status` |
78+
| Field | Value |
79+
| --------------- | --------------------------------- |
80+
| **Name** | `auth status` |
8181
| **Description** | Show current authentication state |
82-
| **Usage** | `bl auth status` |
82+
| **Usage** | `bl auth status` |
8383

8484
#### Options
8585

skills/bailian-cli/reference/config.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,27 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
10+
| Command | Description |
11+
| ------------------------- | ----------------------------------------------------------------------------------- |
1212
| `bl config export-schema` | Export all (or one) CLI command(s) as Anthropic/OpenAI-compatible JSON tool schemas |
13-
| `bl config set` | Set a config value |
14-
| `bl config show` | Display current configuration |
13+
| `bl config set` | Set a config value |
14+
| `bl config show` | Display current configuration |
1515

1616
## Command details
1717

1818
### `bl config export-schema`
1919

20-
| Field | Value |
21-
| --- | --- |
22-
| **Name** | `config export-schema` |
20+
| Field | Value |
21+
| --------------- | ----------------------------------------------------------------------------------- |
22+
| **Name** | `config export-schema` |
2323
| **Description** | Export all (or one) CLI command(s) as Anthropic/OpenAI-compatible JSON tool schemas |
24-
| **Usage** | `bl config export-schema [--command "<name>"]` |
24+
| **Usage** | `bl config export-schema [--command "<name>"]` |
2525

2626
#### Options
2727

28-
| Flag | Type | Required | Description |
29-
| --- | --- | --- | --- |
30-
| `--command <name>` | string | no | Export schema for a specific command only (e.g. "image generate") |
28+
| Flag | Type | Required | Description |
29+
| ------------------ | ------ | -------- | ----------------------------------------------------------------- |
30+
| `--command <name>` | string | no | Export schema for a specific command only (e.g. "image generate") |
3131

3232
#### Examples
3333

@@ -41,18 +41,18 @@ bl config export-schema --command "video generate"
4141

4242
### `bl config set`
4343

44-
| Field | Value |
45-
| --- | --- |
46-
| **Name** | `config set` |
47-
| **Description** | Set a config value |
48-
| **Usage** | `bl config set --key <key> --value <value>` |
44+
| Field | Value |
45+
| --------------- | ------------------------------------------- |
46+
| **Name** | `config set` |
47+
| **Description** | Set a config value |
48+
| **Usage** | `bl config set --key <key> --value <value>` |
4949

5050
#### Options
5151

52-
| Flag | Type | Required | Description |
53-
| --- | --- | --- | --- |
54-
| `--key <key>` | string | no | Config key (region, base_url, output, output_dir, timeout, api_key, access_token, default_*_model, access_key_id, access_key_secret, workspace_id) |
55-
| `--value <value>` | string | no | Value to set |
52+
| Flag | Type | Required | Description |
53+
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
54+
| `--key <key>` | string | no | Config key (region, base*url, output, output_dir, timeout, api_key, access_token, default*\*\_model, access_key_id, access_key_secret, workspace_id) |
55+
| `--value <value>` | string | no | Value to set |
5656

5757
#### Examples
5858

@@ -70,11 +70,11 @@ bl config set --key base_url --value https://dashscope.aliyuncs.com
7070

7171
### `bl config show`
7272

73-
| Field | Value |
74-
| --- | --- |
75-
| **Name** | `config show` |
73+
| Field | Value |
74+
| --------------- | ----------------------------- |
75+
| **Name** | `config show` |
7676
| **Description** | Display current configuration |
77-
| **Usage** | `bl config show` |
77+
| **Usage** | `bl config show` |
7878

7979
#### Options
8080

skills/bailian-cli/reference/console.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,27 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
10+
| Command | Description |
11+
| ----------------- | ---------------------------------------------- |
1212
| `bl console call` | Call a Bailian console API via the CLI gateway |
1313

1414
## Command details
1515

1616
### `bl console call`
1717

18-
| Field | Value |
19-
| --- | --- |
20-
| **Name** | `console call` |
21-
| **Description** | Call a Bailian console API via the CLI gateway |
22-
| **Usage** | `bl console call --api <api> --data <json> [flags]` |
18+
| Field | Value |
19+
| --------------- | --------------------------------------------------- |
20+
| **Name** | `console call` |
21+
| **Description** | Call a Bailian console API via the CLI gateway |
22+
| **Usage** | `bl console call --api <api> --data <json> [flags]` |
2323

2424
#### Options
2525

26-
| Flag | Type | Required | Description |
27-
| --- | --- | --- | --- |
28-
| `--api <api>` | string | yes | API name (e.g. zeldaEasy.broadscope-bailian.memory-library.getLibraries) |
29-
| `--data <json>` | string | yes | Request data as JSON string |
30-
| `--region <region>` | string | no | API region (default: cn-beijing) |
26+
| Flag | Type | Required | Description |
27+
| ------------------- | ------ | -------- | ------------------------------------------------------------------------ |
28+
| `--api <api>` | string | yes | API name (e.g. zeldaEasy.broadscope-bailian.memory-library.getLibraries) |
29+
| `--data <json>` | string | yes | Request data as JSON string |
30+
| `--region <region>` | string | no | API region (default: cn-beijing) |
3131

3232
#### Examples
3333

skills/bailian-cli/reference/file.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,27 @@ Index: [index.md](index.md)
77

88
## Commands in this group
99

10-
| Command | Description |
11-
| --- | --- |
10+
| Command | Description |
11+
| ---------------- | -------------------------------------------------------- |
1212
| `bl file upload` | Upload a local file to DashScope temporary storage (48h) |
1313

1414
## Command details
1515

1616
### `bl file upload`
1717

18-
| Field | Value |
19-
| --- | --- |
20-
| **Name** | `file upload` |
21-
| **Description** | Upload a local file to DashScope temporary storage (48h) |
22-
| **Usage** | `bl file upload --file <path> --model <model>` |
23-
| **API docs** | [/developer-reference/get-temporary-file-url](https://help.aliyun.com/zh/model-studio/developer-reference/get-temporary-file-url) |
18+
| Field | Value |
19+
| --------------- | --------------------------------------------------------------------------------------------------------------------------------- |
20+
| **Name** | `file upload` |
21+
| **Description** | Upload a local file to DashScope temporary storage (48h) |
22+
| **Usage** | `bl file upload --file <path> --model <model>` |
23+
| **API docs** | [/developer-reference/get-temporary-file-url](https://help.aliyun.com/zh/model-studio/developer-reference/get-temporary-file-url) |
2424

2525
#### Options
2626

27-
| Flag | Type | Required | Description |
28-
| --- | --- | --- | --- |
29-
| `--file <path>` | string | yes | Local file to upload (image, video, audio) |
30-
| `--model <model>` | string | yes | Target model name (file is bound to this model) |
27+
| Flag | Type | Required | Description |
28+
| ----------------- | ------ | -------- | ----------------------------------------------- |
29+
| `--file <path>` | string | yes | Local file to upload (image, video, audio) |
30+
| `--model <model>` | string | yes | Target model name (file is bound to this model) |
3131

3232
#### Examples
3333

0 commit comments

Comments
 (0)