apiskill 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/MCP.md +5 -5
  2. package/README.ja.md +8 -8
  3. package/README.ko.md +8 -8
  4. package/README.md +25 -13
  5. package/README.zh.md +25 -13
  6. package/dist/assets/{index-CPxVZ06Y.js → index-CV6e3HAP.js} +55 -55
  7. package/dist/assets/index-slFOragU.css +1 -0
  8. package/dist/index.html +2 -2
  9. package/docs/cli.ja.md +1 -1
  10. package/docs/cli.ko.md +1 -1
  11. package/docs/cli.md +3 -1
  12. package/docs/cli.zh.md +3 -1
  13. package/docs/mcp.ja.md +1 -1
  14. package/docs/mcp.ko.md +1 -1
  15. package/docs/mcp.md +3 -1
  16. package/docs/mcp.zh.md +3 -1
  17. package/docs/web.ja.md +1 -1
  18. package/docs/web.ko.md +1 -1
  19. package/docs/web.md +1 -1
  20. package/docs/web.zh.md +1 -1
  21. package/package.json +1 -1
  22. package/src/App.tsx +12 -0
  23. package/src/styles.css +12 -3
  24. package/dist/assets/index-BeAJ1G-n.css +0 -1
package/MCP.md CHANGED
@@ -2,11 +2,11 @@
2
2
 
3
3
  The detailed MCP documentation has moved to standalone docs:
4
4
 
5
- - [English MCP documentation](docs/mcp.md)
6
- - [中文 MCP 文档](docs/mcp.zh.md)
5
+ - [English MCP documentation](https://unpkg.com/apiskill@latest/docs/mcp.md)
6
+ - [中文 MCP 文档](https://unpkg.com/apiskill@latest/docs/mcp.zh.md)
7
7
 
8
8
  Project overview:
9
9
 
10
- - [README](README.md)
11
- - [Web app docs](docs/web.md) / [Web 中文文档](docs/web.zh.md)
12
- - [CLI docs](docs/cli.md) / [CLI 中文文档](docs/cli.zh.md)
10
+ - [README](https://unpkg.com/apiskill@latest/README.md)
11
+ - [Web app docs](https://unpkg.com/apiskill@latest/docs/web.md) / [Web 中文文档](https://unpkg.com/apiskill@latest/docs/web.zh.md)
12
+ - [CLI docs](https://unpkg.com/apiskill@latest/docs/cli.md) / [CLI 中文文档](https://unpkg.com/apiskill@latest/docs/cli.zh.md)
package/README.ja.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # API Skill
2
2
 
3
- [English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
3
+ [English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
4
4
 
5
- API Skill は、フロントエンド開発と AI 支援開発のためのローカル OpenAPI/Swagger ワークスペースです。3 つの入口が同じキャッシュ済み API ドキュメントを共有します。
5
+ API Skill は、フロントエンド開発と AI 支援開発のためのローカル OpenAPI/Swagger ワークスペースです。人向けの Web ワークスペースと AI Agent 向けの CLI/MCP インターフェースが、同じキャッシュ済み API ドキュメントを共有します。
6
6
 
7
- - Web アプリ: API ドキュメントのインポート、閲覧、検索、確認、テスト、手動 API 操作の管理。
8
- - CLI: ターミナルからドキュメントをインポートし、ローカル API バージョンを管理または照会。
9
- - MCP サーバー: 同じ API コンテキストと保守操作を Codex や他の MCP クライアントへ公開。
7
+ - Web アプリ: 人が API ドキュメントをインポート、閲覧、検索、確認、テストし、バージョンと API 操作を管理するための画面。
8
+ - CLI: AI Agent や自動化処理がドキュメント状態を確認し、必要な API コンテキストを取得・保守するためのコマンド。
9
+ - MCP サーバー: 同じ API の照会・保守機能を Codex や他の AI Agent クライアントへ公開。
10
10
 
11
11
  ## Web アプリの使い方
12
12
 
@@ -92,9 +92,9 @@ Agent ワークフローでは MCP が最も効果的です。コーディング
92
92
 
93
93
  ## ドキュメント
94
94
 
95
- - Web アプリ: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
96
- - CLI 設定と使い方: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
97
- - MCP 設定と使い方: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
95
+ - Web アプリ: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
96
+ - CLI 設定と使い方: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
97
+ - MCP 設定と使い方: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
98
98
 
99
99
  ## データモデル
100
100
 
package/README.ko.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # API Skill
2
2
 
3
- [English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
3
+ [English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
4
4
 
5
- API Skill은 프론트엔드 개발과 AI 보조 코딩을 위한 로컬 OpenAPI/Swagger 작업 공간입니다. 세 가지 진입점이 같은 캐시된 API 문서를 공유합니다.
5
+ API Skill은 프론트엔드 개발과 AI 보조 코딩을 위한 로컬 OpenAPI/Swagger 작업 공간입니다. 사람을 위한 Web 작업 공간과 AI Agent를 위한 CLI/MCP 인터페이스가 같은 캐시된 API 문서를 공유합니다.
6
6
 
7
- - Web 앱: API 문서를 가져오고, 탐색하고, 검색하고, 검사하고, 테스트하며, 수동 API 작업을 관리합니다.
8
- - CLI: 터미널에서 문서를 가져오고 로컬 API 버전을 관리하거나 조회합니다.
9
- - MCP 서버: 같은 API 컨텍스트와 유지 관리 기능을 Codex 또는 다른 MCP 클라이언트에 제공합니다.
7
+ - Web 앱: 사람이 API 문서를 가져오고, 탐색하고, 검색하고, 검사하고, 테스트하며 버전과 API 작업을 관리합니다.
8
+ - CLI: AI Agent와 자동화 작업이 문서 상태를 확인하고 필요한 API 컨텍스트를 조회하거나 유지 관리합니다.
9
+ - MCP 서버: 같은 API 조회 및 유지 관리 기능을 Codex 또는 다른 AI Agent 클라이언트에 제공합니다.
10
10
 
11
11
  ## Web 앱 사용
12
12
 
@@ -92,9 +92,9 @@ Agent 워크플로는 MCP에서 가장 큰 이점을 얻습니다. 코딩 agent
92
92
 
93
93
  ## 문서
94
94
 
95
- - Web 앱: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
96
- - CLI 구성 및 사용법: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
97
- - MCP 구성 및 사용법: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
95
+ - Web 앱: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
96
+ - CLI 구성 및 사용법: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
97
+ - MCP 구성 및 사용법: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
98
98
 
99
99
  ## 데이터 모델
100
100
 
package/README.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # API Skill
2
2
 
3
- [English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
3
+ [English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
4
4
 
5
- API Skill is a local OpenAPI/Swagger workspace for frontend and agent-assisted development. It has three surfaces that share the same cached API documents:
5
+ API Skill is a local OpenAPI/Swagger workspace for frontend and agent-assisted development. It has one human-facing workspace and two agent-facing interfaces that share the same cached API documents:
6
6
 
7
- - Web app: import, browse, search, inspect, test, and manually maintain API operations.
8
- - CLI: import documents, manage/query local API versions, and start a MOCK server from a terminal.
9
- - MCP server: expose the same API context and maintenance actions to Codex or other MCP clients.
7
+ - Web app, for people: import, browse, search, inspect, test, version, and manually maintain API operations.
8
+ - CLI, for AI agents and automation: check document availability, retrieve focused API context, maintain documents, and start local services with predictable commands.
9
+ - MCP server, for AI agents: expose the same query and maintenance actions directly to Codex or other MCP clients.
10
10
 
11
11
  ## Web App Usage
12
12
 
@@ -30,15 +30,27 @@ After importing or creating a blank document, use the version selector to switch
30
30
 
31
31
  After API document data exists, click Start MOCK Service in the web app or run `apiskill mock` in CLI to start a local random-data MOCK API server from the current interface definitions.
32
32
 
33
- For CLI and MCP usage, run the built-in checks first:
33
+ ### AI Agent Quick Start
34
34
 
35
35
  ```bash
36
- npm run cli -- check
37
- ```
36
+ # 1. Check whether API documentation is ready
37
+ apiskill check
38
+
39
+ # 2. Initialize the cache when no document exists
40
+ apiskill import https://example.com/openapi.json
41
+ apiskill crawl https://example.com/swagger
42
+ apiskill import-file ./openapi.yaml
43
+ apiskill document create --title "My API" --doc-version 1.0.0
38
44
 
39
- After npm installation, the equivalent command is `apiskill check`.
45
+ # 3. Retrieve only the API context needed for the current coding task
46
+ apiskill versions
47
+ apiskill query /api/v1/users --method GET
48
+
49
+ # 4. Start a local random-data API from the active document
50
+ apiskill mock
51
+ ```
40
52
 
41
- To start from zero in CLI, run `npm run cli -- document create --title "My API" --doc-version 1.0.0`, then add endpoints with `api create`. In MCP clients, call `apiskill_check` to verify the cache, `apiskill_create_document` to create a blank document when no upstream docs exist, and `apiskill_help` to list available tools.
53
+ CLI and MCP are primarily designed for AI coding agents. Agents should check the cache first, initialize it only when needed, and query a focused endpoint instead of reading the entire OpenAPI document. Run `apiskill --help` for all CLI commands. In MCP clients, start with `apiskill_check`, use `apiskill_search_endpoints` or `apiskill_query_api` to locate an API, and call `apiskill_help` for the complete tool list.
42
54
 
43
55
  ## Why This Tool Exists
44
56
 
@@ -103,9 +115,9 @@ Agent workflows benefit most from MCP. A coding agent can call `apiskill_search_
103
115
 
104
116
  ## Documentation
105
117
 
106
- - Web app: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
107
- - CLI configuration and usage: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
108
- - MCP configuration and usage: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
118
+ - Web app: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
119
+ - CLI configuration and usage: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
120
+ - MCP configuration and usage: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
109
121
 
110
122
  ## Data Model
111
123
 
package/README.zh.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # API Skill
2
2
 
3
- [English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
3
+ [English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
4
4
 
5
- API Skill 是一个本地 OpenAPI/Swagger 工作区，面向前端开发和 AI 辅助编码。它提供三种入口，并共享同一份本地缓存接口文档：
5
+ API Skill 是一个本地 OpenAPI/Swagger 工作区，面向前端开发和 AI 辅助编码。它提供一个面向人的工作台和两个面向 AI Agent 的接口，并共享同一份本地缓存接口文档：
6
6
 
7
- - Web 端：导入、浏览、搜索、查看、测试和手动维护接口。
8
- - CLI：在终端里导入文档、管理版本、查询和维护本地接口，并启动 MOCK 服务。
9
- - MCP 服务：把同一套接口上下文和维护能力暴露给 Codex 或其他 MCP 客户端。
7
+ - Web 端，主要给人使用：导入、浏览、搜索、查看、测试、版本管理和手动维护接口。
8
+ - CLI，主要给 AI Agent 和自动化任务使用：检查文档状态、按需获取接口上下文、维护文档并启动本地服务。
9
+ - MCP 服务，主要给 AI Agent 使用：把同一套查询和维护能力直接暴露给 Codex 或其他 MCP 客户端。
10
10
 
11
11
  ## Web 端使用
12
12
 
@@ -30,15 +30,27 @@ npm run dev
30
30
 
31
31
  已有 API 文档数据后，可以在 Web 端点击“启动MOCK服务”，或在 CLI 里运行 `apiskill mock`，根据当前接口定义启动本地随机数据 MOCK API 服务。
32
32
 
33
- CLI 和 MCP 使用前建议先运行内置检查：
33
+ ### AI Agent 快速使用
34
34
 
35
35
  ```bash
36
- npm run cli -- check
37
- ```
36
+ # 1. 检查 API 文档是否可用
37
+ apiskill check
38
+
39
+ # 2. 没有文档时初始化缓存
40
+ apiskill import https://example.com/openapi.json
41
+ apiskill crawl https://example.com/swagger
42
+ apiskill import-file ./openapi.yaml
43
+ apiskill document create --title "My API" --doc-version 1.0.0
38
44
 
39
- npm 安装后的等价命令是 `apiskill check`。
45
+ # 3. 只获取当前开发任务需要的接口上下文
46
+ apiskill versions
47
+ apiskill query /api/v1/users --method GET
48
+
49
+ # 4. 根据当前文档启动本地随机数据接口
50
+ apiskill mock
51
+ ```
40
52
 
41
- 如果要通过 CLI 从零开始，运行 `npm run cli -- document create --title "My API" --doc-version 1.0.0` 创建空白文档，再用 `api create` 追加接口。在 MCP 客户端里，先调用 `apiskill_check` 检查缓存；没有上游文档时调用 `apiskill_create_document` 创建空白文档；再调用 `apiskill_help` 查看可用工具。
53
+ CLI 和 MCP 主要面向 AI 编码 Agent。Agent 应先检查缓存，只在缺少文档时初始化，然后按当前任务精确查询接口，避免每次读取整份 OpenAPI 文档。运行 `apiskill --help` 可以查看全部 CLI 命令；在 MCP 客户端中先调用 `apiskill_check`，再使用 `apiskill_search_endpoints` 或 `apiskill_query_api` 定位接口，调用 `apiskill_help` 可查看完整工具列表。
42
54
 
43
55
  ## 为什么开发这个工具
44
56
 
@@ -103,9 +115,9 @@ Agent 工作流最适合接入 MCP。编码 agent 可以先调用 `apiskill_sear
103
115
 
104
116
  ## 文档
105
117
 
106
- - Web 端：[English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
107
- - CLI 配置和使用：[English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
108
- - MCP 配置和使用：[English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
118
+ - Web 端：[English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
119
+ - CLI 配置和使用：[English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
120
+ - MCP 配置和使用：[English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
109
121
 
110
122
  ## 数据模型
111
123