スキル

スキルは、エージェントをよりスマートにする再利用可能な知識です。ドメインの専門知識、コーディング規約、レビューチェックリスト、またはエージェントに一貫して従わせたい指示を含みます。

Themisとチャットする際、利用可能なすべてのスキルが自動的に読み込まれます。手動で参照する必要はありません。

スキルの閲覧

サイドバーのスキルに移動して、スペースで利用可能なすべてのスキルを確認できます。以下でフィルタリングできます：

  • 有効 / 無効 — アクティブなスキルと無効化されたスキル
  • 自分のもの — あなたの個人スキル
  • スペース — すべてのスペースメンバーと共有
  • システム — すべてのスペースで利用可能（管理者が作成）

各スキルには、名前、スコープ、説明、作成者、最終更新日が表示されます。スキルをクリックすると、完全な内容と添付ファイルを確認できます。

チャットでのスキルの使用

特別なことをする必要はありません。エージェントは会話中に関連するスキルを自動的に発見し適用します。例えば、スペースに「code-review-checklist」スキルがあれば、PRをレビューする際にエージェントがそれに従います。

スラッシュコマンドパレット

特定のスキルを明示的に呼び出すには、チャット入力欄の空の行や新しい行の先頭で / を入力します。現在のスペースで利用できるすべてのスキルが、説明と例のプロンプトと共にパレットで一覧表示されます。

  • 文字を追加で入力して絞り込みます（例：/code）。
  • 矢印キーで移動、Enter または Tab で /<skill-name> をメッセージに挿入します。
  • 項目は Themis がスキルをロードする際と同じ優先順位（個人 > スペース > システム）で重複排除されます。例えば個人とスペース両方に summary スキルがある場合、パレットには個人のものが表示・挿入されます。

スマートフォンではソフトキーボードの自動補完が同じ役割を果たすため、パレットは表示されません。

例のプロンプト

各スキルには最大 10 件の例のプロンプト（各 200 文字以内）を含められます。これらはスラッシュコマンドパレットに表示されるため、ユーザーはスキルを開かずに何が得意かを把握できます。

スキルフォームの例フィールドで追加するか、チャット経由でも追加できます（「deployment-checklist に『支払いサービスのデプロイ手順を教えて』という例のプロンプトを追加して」）。例はスキルと一緒に保存され、同じバージョン履歴で更新されます。

よい例は、抽象的な説明ではなく、ユーザーが実際に入力するであろう具体的なプロンプトです：

  • ✅ 「支払いサービスのデプロイ手順を教えて」
  • ❌ 「デプロイガイド」

チャットでエージェントに個人スキルの管理を直接依頼することもできます：

  • 「deployment-checklistというスキルを以下の手順で作成して…」 — あなたの指示で個人スキルを作成します
  • 「deployment-checklistスキルにデータベースマイグレーションの手順を追加して」 — SKILL.mdの内容を更新します
  • 「deployment-checklistのバージョンをv0.2に変更して」 — ファイル全体を書き換えずに高速な検索置換編集
  • 「スキルを一覧表示して」 — リンク付きであなたの個人スキルをすべて表示します

チャットでのスキルファイル管理

スキルにはSKILL.md以外にも複数のファイルを含めることができます — テンプレート、スクリプト、参考ドキュメント、設定ファイルなど。すべてチャットから管理できます：

  • 「deployment-checklistのファイルを一覧表示して」 — パス、サイズ、編集可否を含むすべてのファイルを表示
  • 「deployment-checklistにreferences/api.mdファイルをこの内容で追加して…」 — スキルに新しいファイルを作成
  • 「deployment-checklistのtemplate.htmlの色を#333から#1a1a1aに変更して」 — テキストファイル（HTML、CSS、Python、JS、YAMLなど）を検索置換で編集
  • 「deployment-checklistからold-notes.mdを削除して」 — ファイルを削除（SKILL.mdは削除不可）

チャットで作成されたスキルは常に個人スコープです。スペースまたはシステムスキルを作成するには、スキルUIを使用してください。

UIでのスキル作成

  1. スキルに移動し、新規をクリック
  2. 以下を入力：
    • 名前 — ハイフン区切りの小文字（例：api-design-guidelines）
    • 説明 — エージェントがこのスキルの関連性を判断するのに役立ちます
    • 例 — スラッシュコマンドパレットに表示される短い例のプロンプト（最大10件、各200文字以内）
    • SKILL.md — Markdownでのメイン指示
    • ファイル — オプションで補足ドキュメントのフォルダをアップロード
  3. スコープを選択：
    • 個人 — 自分だけが利用可能
    • スペース — すべてのスペースメンバーと共有（マネージャーとオーナー）
    • システム — すべてのスペースで利用可能（管理者のみ）
  4. 保存 — スキルは即座にエージェントで利用可能になります

共同編集（チェックアウト / チェックイン）

スペーススキルとシステムスキルは共有リソースです。編集の競合を防ぐために、Themisはチェックアウト/チェックインワークフローを使用します — 一度に1人の編集者のみ。

仕組み

  1. チェックアウト — スペーススキルまたはシステムスキルのチェックアウトをクリックします。スキルがロックされ（他の人が編集できなくなり）、編集用の個人コピーが作成されます。
  2. 編集 — UIまたはチャットを通じて個人コピーを変更します。個人コピーは元のバージョンを自動的にシャドウイングするため、テスト中はエージェントがあなたのバージョンを使用します。
  3. チェックイン — 変更に満足したら、元のスキルのチェックインをクリックします。変更の差分プレビューが表示されます。確認すると、共有スキルがあなたのバージョンに置き換わります。
  4. 破棄 — 気が変わった場合は破棄をクリックして、変更なしで個人コピーを削除しスキルのロックを解除します。

チェックアウトできる人

  • スペーススキル — マネージャーとオーナーのみがチェックアウトできます。一般メンバーはスキルを閲覧できますが、編集用にロックすることはできません。
  • システムスキル — 管理者のみがチェックアウトできます。システムスキルはすべてのスペースで共有されるため、編集には管理者権限が必要です。

強制ロック解除

チェックアウトが放置された場合、マネージャーはスペーススキルの、管理者はシステムスキルの強制ロック解除でチェックアウトを破棄し、スキルを他の人が使えるようにできます。クリーンアップジョブも7日以上経過したロックを自動的に期限切れにします。

チャットツール

チャットでもチェックアウトを管理できます：

  • 「code-review-checklistスキルをチェックアウトして」 — ロックして個人コピーを作成
  • 「code-review-checklistの変更をチェックインして」 — 編集内容を共有スキルに適用
  • 「code-review-checklistのチェックアウトを破棄して」 — 変更なしでロック解除
  • 「code-review-checklistのバージョンをv0.2に変更して」 — 高速な検索置換編集（ファイル全体の書き換えを回避）

バージョン履歴

スキルへのすべての変更が追跡され、スキル詳細ページに表示されます。バージョン履歴セクションには以下が表示されます：

  • 誰が変更を行い、いつ行ったか
  • ソース — 変更がWeb UI、チャット、またはチェックインから行われたかどうか
  • 何が変わったか — 変更された各フィールドのバッジ（説明、SKILL.mdなど）
  • 差分プレビュー — 「変更を表示」をクリックして、変更前後のサイドバイサイド比較を確認

バージョン履歴は監査ログです — スキルがどのように進化したかを理解するのに役立ちます。注意：メタデータとSKILL.mdの内容変更のみが追跡されます。他の添付ファイルの変更はバージョン履歴に含まれません。

有効化 / 無効化

スキルテーブルからスキルの有効/無効を切り替えることができ、削除する必要はありません。無効化されたスキルはエージェントに読み込まれません。

例

スキルの良い候補：

  • コーディング規約 — 言語固有のスタイルガイドとパターン
  • レビューチェックリスト — セキュリティチェック、パフォーマンスの考慮事項、アクセシビリティ要件
  • ドメイン知識 — ビジネスルール、APIドキュメント、システムアーキテクチャ
  • ワークフロー指示 — バグのトリアージ方法、ユーザーストーリーの書き方、レポートの構成方法