Skip to main content

スキルシステム

ℹ️Note

スキルは実験的な機能です。設定 → 機能 → 「スキルを有効にする」で有効にしてください。

スキル（Skills）は特定のタスクのための再利用可能な指示セットです。各スキルは詳細なガイダンス、ワークフロー、追加リソースをパッケージ化し、リクエストに関連する場合にのみロードされます。

ルール（常にアクティブ）とは異なり、スキルはオンデマンドでロードされます。数十のスキルをインストールしても、Caretiは実際に必要になるまでスキル名と説明のみを表示するため、コンテキストやパフォーマンスに影響しません。

なぜスキルなのか？​

新しいチームメンバーをオンボーディングする方法を考えてみてください。すべてのドキュメントを一度に渡すのではなく、概要を説明してから、特定のタスクに取り組む際に詳細なガイドを示します。

スキルも同様に機能します：

  • 起動時: Caretiは各スキルの簡単な説明のみを表示
  • トリガー時: そのスキルの完全な指示がロードされます
  • 必要に応じて: スキルにバンドルされた追加ファイルは参照された時のみ読み込まれます

この段階的なロードにより、現在のタスクに関連しない情報にコンテキストトークンを消費することなく、広範なドメイン知識をパッケージ化できます。

スキルの作成​

すべてのスキルはSKILL.mdファイルを含むディレクトリです：

my-skill/
├── SKILL.md          # 必須: メイン指示
├── docs/             # オプション: 追加ドキュメント
│   └── advanced.md
└── scripts/          # オプション: ユーティリティスクリプト
    └── helper.sh

SKILL.mdファイルはYAMLフロントマターと指示の2つの部分で構成されます。

---
name: my-skill
description: このスキルが何をするか、いつ使用するかの簡単な説明。
---

# My Skill

このスキルがアクティブ化されたときにCaretが従う詳細な指示。

## ステップ

1. まずこれを行います
2. 次にそれを行います
3. 高度な使用法は[advanced.md](docs/advanced.md)を参照

必須フィールド:

  • name: ディレクトリ名と正確に一致する必要があります
  • description: Caretiがこのスキルをいつ使用するかを決定します（最大1024文字）

スキルの保存場所​

スキルは2つの場所に保存できます：

グローバルスキルはすべてのプロジェクトに適用されます：

  • macOS/Linux: ~/Documents/.agents/skills/
  • Windows: C:\Users\USERNAME\Documents\.agents\skills\

プロジェクトスキルは現在のワークスペースにのみ適用されます：

  • .agents/skills/（推奨）

グローバルスキルとプロジェクトスキルが同じ名前の場合、グローバルスキルが優先されます。

ℹ️Note

Careti標準化: Caretiはデュアルディレクトリアーキテクチャを使用します。

  • .agents/ - AI用（トークン最適化）
  • .users/ - 人間用（詳細説明）

標準構造を初期化するには/initコマンドを使用してください。詳細は高度なルールシステムおよびAI-開発者の知識同期を参照してください。

スキルの管理​

チャット入力の下にあるスケールアイコンをクリックすると、ルールとワークフローパネルが開きます。スキルが有効になっている場合、スキルタブで以下が可能です：

  • 利用可能なすべてのスキルの表示
  • 個別のスキルのオン/オフ切り替え
  • テンプレートから新しいスキルを作成
  • 不要なスキルの削除

関連機能​