[Skill 名] lark-skill-maker

Skill Maker

lark-cli に基づいて新しい Skill を作成します。Skill とは、AI が CLI コマンドを使用してタスクを完了する方法を教える SKILL.md ファイルのことです。

CLI のコア機能

lark-cli <service> <resource> <method>          # 登録済み API
lark-cli <service> +<verb>                      # ショートカット（高度なカプセル化）
lark-cli api <METHOD> <path> [--data/--params]  # 任意の飛書 OpenAPI
lark-cli schema <service.resource.method>       # パラメータ定義の確認

優先順位：ショートカット > 登録済み API > api 直接呼び出し。

API の調査

# 1. 既存の API リソースとショートカットを表示
lark-cli <service> --help

# 2. パラメータ定義を確認
lark-cli schema <service.resource.method>

# 3. 未登録の API は、api を使って直接呼び出す
lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'
lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'

上記のコマンドで要件をカバーできない場合（CLI に対応する登録済み API やショートカットがない場合）は、lark-openapi-explorer を使用して、飛書公式ドキュメントライブラリからネイティブ OpenAPI インターフェースを階層的に掘り下げ、完全なメソッド、パス、パラメータ、および権限情報を取得し、lark-cli api を直接呼び出してタスクを完了してください。

上記のプロセスを通じて、必要な API、パラメータ、およびスコープを特定します。

SKILL.md テンプレート

ファイルは skills/lark-<name>/SKILL.md に配置します。

---
name: lark-<name>
version: 1.0.0
description: "<機能の説明>。ユーザーが<トリガーシナリオ>を必要とするときに使用します。"
metadata:
  requires:
    bins: ["lark-cli"]
---


# <タイトル>

> **前提条件：** まず [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) をお読みください。

## コマンド

\```bash
# 単一ステップ操作
lark-cli api POST /open-apis/xxx --data '{...}'

# 複数ステップのオーケストレーション：ステップ間のデータ転送を説明
# Step 1: ...（返された xxx_id を記録）
# Step 2: Step 1 の xxx_id を使用
\```

## 権限

| 操作 | 必要なスコープ |
|------|-----------|
| xxx | `scope:name` |

重要な原則

• description がトリガーを決定する — 機能キーワードと「ユーザーが...を必要とするときに使用する」を含めます。
• 認証 — 必要なスコープを説明し、ログインには lark-cli auth login --domain <name> を使用します。
• セキュリティ — 書き込み操作の前にユーザーの意図を確認し、--dry-run でプレビューすることをお勧めします。
• オーケストレーション — データ転送、失敗時のロールバック、並行可能なステップを説明します。