mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-07-20 05:27:59 +08:00
docs: add CLI system docs
This commit is contained in:
zhayujie
58
docs/ja/skills/create.mdx
Normal file
58
docs/ja/skills/create.mdx
Normal file
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: スキルの作成
|
||||
description: 会話を通じてカスタムスキルを作成
|
||||
---
|
||||
|
||||
CowAgent には Skill Creator が組み込まれており、自然言語の会話を通じてスキルの作成、インストール、更新を素早く行えます。
|
||||
|
||||
## 使い方
|
||||
|
||||
会話で作りたいスキルを説明するだけで、Agent が自動的に作成します：
|
||||
|
||||
- ワークフローをスキル化：「このデプロイプロセスからスキルを作成して」
|
||||
- サードパーティ API の統合：「この API ドキュメントに基づいてスキルを作成して」
|
||||
- リモートスキルのインストール：「xxx スキルをインストールして」
|
||||
|
||||
## 作成フロー
|
||||
|
||||
1. 作成したいスキルを Agent に伝えます
|
||||
2. Agent が自動的に `SKILL.md` の説明と実行スクリプトを生成します
|
||||
3. スキルはワークスペースの `~/cow/skills/` ディレクトリに保存されます
|
||||
4. 以降の会話で Agent が自動的にそのスキルを認識し使用します
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
|
||||
</Frame>
|
||||
|
||||
## SKILL.md のフォーマット
|
||||
|
||||
作成されたスキルは標準の SKILL.md フォーマットに従います：
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill
|
||||
description: Brief description of the skill
|
||||
metadata:
|
||||
emoji: 🔧
|
||||
requires:
|
||||
bins: ["curl"]
|
||||
env: ["MY_API_KEY"]
|
||||
primaryEnv: "MY_API_KEY"
|
||||
---
|
||||
|
||||
# My Skill
|
||||
|
||||
Detailed instructions...
|
||||
```
|
||||
|
||||
| フィールド | 説明 |
|
||||
| --- | --- |
|
||||
| `name` | スキル名。ディレクトリ名と一致する必要があります |
|
||||
| `description` | スキルの説明。Agent はこれに基づいて呼び出すかどうかを判断します |
|
||||
| `metadata.requires.bins` | 必要なシステムコマンド |
|
||||
| `metadata.requires.env` | 必要な環境変数 |
|
||||
| `metadata.always` | 常に読み込む（デフォルトは false） |
|
||||
|
||||
<Tip>
|
||||
詳細は [Skill Creator のドキュメント](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/skills/skill-creator/SKILL.md)をご覧ください。
|
||||
</Tip>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: Image Vision
|
||||
description: OpenAI の Vision モデルを使用して画像を認識
|
||||
---
|
||||
|
||||
OpenAI の GPT-4 Vision API を使用して画像の内容を分析し、画像内のオブジェクト、テキスト、色などの要素を理解します。
|
||||
|
||||
## 依存関係
|
||||
|
||||
| 依存関係 | 説明 |
|
||||
| --- | --- |
|
||||
| `OPENAI_API_KEY` | OpenAI API キー |
|
||||
| `curl`, `base64` | システムコマンド（通常プリインストール済み） |
|
||||
|
||||
設定方法：
|
||||
|
||||
- `env_config` Tool で `OPENAI_API_KEY` を設定
|
||||
- または `config.json` で `open_ai_api_key` を設定
|
||||
|
||||
## 対応モデル
|
||||
|
||||
- `gpt-4.1-mini`（推奨、コストパフォーマンスに優れる）
|
||||
- `gpt-4.1`
|
||||
|
||||
## 使い方
|
||||
|
||||
設定が完了したら、Agent に画像を送信すると自動的に画像認識がトリガーされます。
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202213219.png" width="800" />
|
||||
</Frame>
|
||||
@@ -1,35 +1,32 @@
|
||||
---
|
||||
title: Skill 概要
|
||||
description: CowAgent の Skill システム紹介
|
||||
title: スキル概要
|
||||
description: CowAgent のスキルシステム紹介
|
||||
---
|
||||
|
||||
Skill は Agent に無限の拡張性を提供します。各 Skill は説明ファイル（`SKILL.md`）、実行スクリプト（任意）、リソース（任意）で構成され、特定のタスクをどのように遂行するかを記述します。
|
||||
スキル（Skill）は Agent に無限の拡張性を提供します。各スキルは説明ファイル（`SKILL.md`）、実行スクリプト（任意）、リソース（任意）で構成され、特定のタスクをどのように遂行するかを記述します。
|
||||
|
||||
Skill と Tool の違い：Tool はコードで実装された原子的な操作（例：ファイルの読み書き、コマンドの実行）であるのに対し、Skill は説明ファイルに基づく高レベルなワークフローであり、複数の Tool を組み合わせて複雑なタスクを完遂できます。
|
||||
スキルとツールの違い：ツールはコードで実装された原子的な操作（例：ファイルの読み書き、コマンドの実行）であるのに対し、スキルは説明ファイルに基づく高レベルなワークフローであり、複数のツールを組み合わせて複雑なタスクを完遂できます。
|
||||
|
||||
## 組み込み Skill
|
||||
## スキルの取得
|
||||
|
||||
プロジェクトの `skills/` ディレクトリに配置されており、依存条件に基づいて自動的に有効化されます：
|
||||
CowAgent ではスキルを取得する複数の方法を提供しています：
|
||||
|
||||
| Skill | 説明 | 依存関係 |
|
||||
| --- | --- | --- |
|
||||
| [`skill-creator`](/ja/skills/skill-creator) | 会話を通じてカスタム Skill を作成 | なし |
|
||||
| [`openai-image-vision`](/ja/skills/image-vision) | OpenAI の Vision モデルを使用して画像を認識 | `OPENAI_API_KEY` |
|
||||
| [`linkai-agent`](/ja/skills/linkai-agent) | LinkAI プラットフォームの Agent を統合 | `LINKAI_API_KEY` |
|
||||
| [`web-fetch`](/ja/skills/web-fetch) | Web ページのテキストコンテンツを取得 | `curl`（デフォルトで有効） |
|
||||
- **Cow スキル広場** — `/skill list --remote` でコミュニティスキルを閲覧・インストール
|
||||
- **GitHub** — GitHub リポジトリから直接インストール、バッチインストールにも対応
|
||||
- **ClawHub** — `/skill install clawhub:名前` で ClawHub のスキルをインストール
|
||||
- **URL** — zip アーカイブや SKILL.md リンクからインストール
|
||||
- **会話で作成** — 自然言語の会話を通じて Agent にスキルを自動作成させる
|
||||
|
||||
## カスタム Skill
|
||||
詳細は[スキルのインストール](/ja/skills/install)と[スキル管理コマンド](/ja/commands/skill)を参照してください。会話を通じて[スキルを作成](/ja/skills/create)することもできます。
|
||||
|
||||
ユーザーが会話を通じて作成し、ワークスペース（`~/cow/skills/`）に保存されます。任意の複雑なビジネスプロセスやサードパーティシステムとの連携を実装できます。
|
||||
## スキルの読み込み優先順位
|
||||
|
||||
## Skill の読み込み優先順位
|
||||
1. **ワークスペースのスキル**（最高優先）：`~/cow/skills/`
|
||||
2. **プロジェクト組み込みスキル**（最低優先）：`skills/`
|
||||
|
||||
1. **ワークスペースの Skill**（最高優先）：`~/cow/skills/`
|
||||
2. **プロジェクト組み込み Skill**（最低優先）：`skills/`
|
||||
同名のスキルは優先順位に従って上書きされます。
|
||||
|
||||
同名の Skill は優先順位に従って上書きされます。
|
||||
|
||||
## Skill のファイル構成
|
||||
## スキルのファイル構成
|
||||
|
||||
```
|
||||
skills/
|
||||
@@ -60,8 +57,8 @@ Detailed instructions...
|
||||
|
||||
| フィールド | 説明 |
|
||||
| --- | --- |
|
||||
| `name` | Skill 名。ディレクトリ名と一致する必要があります |
|
||||
| `description` | Skill の説明。Agent はこれに基づいて呼び出すかどうかを判断します |
|
||||
| `name` | スキル名。ディレクトリ名と一致する必要があります |
|
||||
| `description` | スキルの説明。Agent はこれに基づいて呼び出すかどうかを判断します |
|
||||
| `metadata.requires.bins` | 必要なシステムコマンド |
|
||||
| `metadata.requires.env` | 必要な環境変数 |
|
||||
| `metadata.always` | 常に読み込む（デフォルトは false） |
|
||||
|
||||
53
docs/ja/skills/install.mdx
Normal file
53
docs/ja/skills/install.mdx
Normal file
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: スキルのインストール
|
||||
description: 統一コマンドで多様なソースからスキルをインストール
|
||||
---
|
||||
|
||||
CowAgent は統一された `install` コマンドで、**Cow スキル広場、GitHub、ClawHub** および任意の URL からスキルをインストールできます。チャットでは `/skill install`、ターミナルでは `cow skill install` を使用します。
|
||||
|
||||
## スキル広場からインストール
|
||||
|
||||
スキル広場を閲覧してインストール：
|
||||
|
||||
```text
|
||||
/skill list --remote
|
||||
/skill install pptx
|
||||
```
|
||||
|
||||
## GitHub からインストール
|
||||
|
||||
リポジトリからの一括インストールとサブディレクトリ指定に対応：
|
||||
|
||||
```text
|
||||
/skill install larksuite/cli
|
||||
/skill install https://github.com/larksuite/cli/tree/main/skills/lark-im
|
||||
```
|
||||
|
||||
## ClawHub からインストール
|
||||
|
||||
```text
|
||||
/skill install clawhub:baidu-search
|
||||
```
|
||||
|
||||
## URL からインストール
|
||||
|
||||
zip アーカイブと SKILL.md ファイルリンクに対応：
|
||||
|
||||
```text
|
||||
/skill install https://cdn.link-ai.tech/skills/pptx.zip
|
||||
/skill install https://example.com/path/to/SKILL.md
|
||||
```
|
||||
|
||||
## スキルの管理
|
||||
|
||||
```text
|
||||
/skill list # インストール済みスキルを表示
|
||||
/skill info pptx # スキルの詳細を表示
|
||||
/skill enable pptx # スキルを有効化
|
||||
/skill disable pptx # スキルを無効化
|
||||
/skill uninstall pptx # スキルをアンインストール
|
||||
```
|
||||
|
||||
<Tip>
|
||||
上記のすべてのコマンドは、ターミナルでは `/skill` を `cow skill` に置き換えて使用できます。完全なコマンドドキュメントは[スキル管理コマンド](/ja/commands/skill)を参照してください。
|
||||
</Tip>
|
||||
@@ -1,47 +0,0 @@
|
||||
---
|
||||
title: LinkAI Agent
|
||||
description: LinkAI プラットフォームのマルチ Agent Skill を統合
|
||||
---
|
||||
|
||||
[LinkAI](https://link-ai.tech/) プラットフォームの Agent を Skill として使用し、マルチ Agent の意思決定を行います。Agent は Agent 名と説明に基づいてインテリジェントに選択し、`app_code` を通じて対応するアプリケーションやワークフローを呼び出します。
|
||||
|
||||
## 依存関係
|
||||
|
||||
| 依存関係 | 説明 |
|
||||
| --- | --- |
|
||||
| `LINKAI_API_KEY` | LinkAI プラットフォームの API キー。[コンソール](https://link-ai.tech/console/interface)で作成 |
|
||||
| `curl` | システムコマンド（通常プリインストール済み） |
|
||||
|
||||
設定方法：
|
||||
|
||||
- `env_config` Tool で `LINKAI_API_KEY` を設定
|
||||
- または `config.json` で `linkai_api_key` を設定
|
||||
|
||||
## Agent の設定
|
||||
|
||||
`skills/linkai-agent/config.json` で利用可能な Agent を追加します：
|
||||
|
||||
```json
|
||||
{
|
||||
"apps": [
|
||||
{
|
||||
"app_code": "G7z6vKwp",
|
||||
"app_name": "LinkAI Customer Support",
|
||||
"app_description": "Select this assistant only when the user needs help with LinkAI platform questions"
|
||||
},
|
||||
{
|
||||
"app_code": "SFY5x7JR",
|
||||
"app_name": "Content Creator",
|
||||
"app_description": "Use this assistant only when the user needs to create images or videos"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 使い方
|
||||
|
||||
設定が完了すると、Agent はユーザーの質問に基づいて適切な LinkAI Agent を自動的に選択します。
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202234350.png" width="750" />
|
||||
</Frame>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: Skill Creator
|
||||
description: 会話を通じてカスタム Skill を作成
|
||||
---
|
||||
|
||||
自然言語の会話を通じて、Skill の作成、インストール、更新を素早く行えます。
|
||||
|
||||
## 依存関係
|
||||
|
||||
追加の依存関係は不要で、常に利用可能です。
|
||||
|
||||
## 使い方
|
||||
|
||||
- ワークフローを Skill 化：「このデプロイプロセスから Skill を作成して」
|
||||
- サードパーティ API の統合：「この API ドキュメントに基づいて Skill を作成して」
|
||||
- リモート Skill のインストール：「xxx Skill をインストールして」
|
||||
|
||||
## 作成フロー
|
||||
|
||||
1. 作成したい Skill を Agent に伝えます
|
||||
2. Agent が自動的に `SKILL.md` の説明と実行スクリプトを生成します
|
||||
3. Skill はワークスペースの `~/cow/skills/` ディレクトリに保存されます
|
||||
4. 以降の会話で Agent が自動的にその Skill を認識し使用します
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
|
||||
</Frame>
|
||||
|
||||
<Tip>
|
||||
詳細は [Skill Creator のドキュメント](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/skills/skill-creator/SKILL.md)をご覧ください。
|
||||
</Tip>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: Web Fetch
|
||||
description: Web ページのテキストコンテンツを取得
|
||||
---
|
||||
|
||||
curl を使用して Web ページを取得し、読み取り可能なテキストコンテンツを抽出します。ブラウザ自動化を必要としない軽量な Web アクセス方法です。
|
||||
|
||||
## 依存関係
|
||||
|
||||
| 依存関係 | 説明 |
|
||||
| --- | --- |
|
||||
| `curl` | システムコマンド（通常プリインストール済み） |
|
||||
|
||||
この Skill は `always: true` が設定されており、システムに `curl` コマンドがあればデフォルトで有効になります。
|
||||
|
||||
## 使い方
|
||||
|
||||
Agent が URL からコンテンツを取得する必要がある場合に自動的に呼び出されます。追加の設定は不要です。
|
||||
|
||||
## browser Tool との比較
|
||||
|
||||
| 機能 | web-fetch (Skill) | browser (Tool) |
|
||||
| --- | --- | --- |
|
||||
| 依存関係 | curl のみ | browser-use + playwright |
|
||||
| JS レンダリング | 非対応 | 対応 |
|
||||
| ページ操作 | 非対応 | クリック、入力などに対応 |
|
||||
| 最適な用途 | 静的ページのテキスト | 動的な Web ページ |
|
||||
|
||||
<Tip>
|
||||
ほとんどの Web コンテンツ取得シナリオでは、web-fetch で十分です。JS レンダリングやページ操作が必要な場合にのみ browser Tool を使用してください。
|
||||
</Tip>
|
||||
Reference in New Issue
Block a user