docs: add CLI system docs

This commit is contained in:
zhayujie
2026-03-29 17:57:12 +08:00
parent e06925ab85
commit 3cb5a0fbd6
62 changed files with 2995 additions and 750 deletions

View File

@@ -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 |