create-moviepilot-skill

MoviePilot スキルの作成

このスキルでは、このリポジトリに組み込まれた MoviePilot エージェントスキルを新規作成または更新する方法を説明します。

対象範囲

リポジトリに組み込むスキルには、次のワークフローを使用します。

• skills/<skill-id>/ 配下のファイルを新規作成または更新します
• スキルを MoviePilot リポジトリの一部としてコミットします
• ユーザーが組み込みスキルではなくローカルでの上書きを明示的に求めている場合を除き、実装を config/agent/skills のみに配置しないでください

MoviePilot 固有のルール

• リポジトリのルートにある skills/ ディレクトリが、組み込みスキルのバンドル元として信頼できる唯一のソースです。
• エージェントの起動時に、バンドルされたスキルは config/agent/skills に同期されます。
• 同期時の上書きは、SKILL.md の version フィールドによって決まります。既存の組み込みスキルを更新する場合は、version を増やしてください。そうしないと、ユーザーが古いコピーを使い続ける可能性があります。
• フォルダー名とフロントマターの name は同じにしてください。小文字、数字、ハイフンのみを使用します。
• 重複するスキルを作成するより、既存のスキルを拡張することを優先してください。

ワークフロー

ステップ 1：リクエストを把握する

• ユーザーが新しいスキルを求めているのか、既存スキルの変更を求めているのかを判断します。
• 対象のタスク、トリガーとなりそうなフレーズ、必要なツール、ヘルパースクリプトが必要かどうかを特定します。
• リクエストとローカルのコンテキストを確認しても目的が曖昧な場合は、焦点を絞った確認質問を 1 つします。それ以外の場合は、妥当な既定の方法で進めます。

ステップ 2：まず既存のスキルを確認する

• 新しいものを作成する前に、リポジトリの skills/ ディレクトリを調べます。
• 既存のスキルでワークフローの大部分をカバーできる場合は、類似スキルを追加するのではなく、既存のスキルを更新します。
• 簡潔な YAML フロントマター、トリガーとなる表現を含む説明、手順をまとめた本文セクションなど、リポジトリのスタイルを踏襲します。

ステップ 3：スキル ID とパスを選ぶ

• 新しい組み込みスキルのパス：skills/<skill-id>/SKILL.md
• <skill-id> は短く、ハイフン区切りにし、64 文字未満にします。
• transfer-failed-retry、moviepilot-api、create-moviepilot-skill のように、トリガーが明確になる動詞またはドメインを先頭にした名前を使用します。

ステップ 4：フロントマターを正しく記述する

次の形式を使用します。

---
name: create-moviepilot-skill
version: 1
description: >-
  Explain what the skill does and exactly when to use it.
allowed-tools: read_file write_file edit_file execute_command
---

ルール：

• description は主要なトリガーとなる部分です。具体的な「どのようなときに使用するか」のシナリオを記述します。
• 組み込みスキルには version を含めます。組み込みスキルの新しいリビジョンをリリースするたびに増やします。
• ワークフローで、範囲が明確で小規模なツールセットが必要な場合は、allowed-tools を追加します。
• 環境上の制約が実際に関係する場合にのみ、compatibility を追加します。

ステップ 5：本文を記述する

本文には次の内容を含めます。

• 短い目的の説明
• MoviePilot 固有のルールまたはガードレール
• 手順を追ったワークフロー
• 該当するユーザーリクエストの具体例
• 存在する場合は、関連ファイルへの参照

次の内容を優先します。

• 命令形の指示
• 具体的なファイルパス
• 実際の MoviePilot の規約に沿った例

次の内容は避けます。

• 実行方法を変えない一般論
• 大量に重複したドキュメント
• スキルディレクトリ内の README.md や CHANGELOG.md などの追加ファイル

ステップ 6：役立つ場合にのみ補助ファイルを追加する

• 同じ決定論的な処理を繰り返し書き直すことになる場合にのみ、scripts/ を追加します。
• ヘルパーファイルは、同じスキルディレクトリ内に配置します。
• SKILL.md からヘルパーのパスを明示的に参照します。
• 手順のみのスキルであれば、SKILL.md 1 つだけにします。

ステップ 7：スキルを実装する

新しい組み込みスキルの場合：

1. skills/<skill-id>/ を作成します
2. SKILL.md を作成します
3. 必要な場合にのみヘルパースクリプトを追加します

既存の組み込みスキルの場合：

1. skills/<skill-id>/SKILL.md を編集します
2. version を増やします
3. 必要に応じて同じディレクトリ内のヘルパーファイルを更新します

ステップ 8：完了前に検証する

• frontmatter を読み直し、name がディレクトリ名と一致することを確認します。
• description に実際のトリガーとなるシナリオが記載されていることを確認します。
• 既存の組み込みスキルを変更した場合は、version が増えていることを確認します。
• 可能であれば、MoviePilot のスキルローダーでファイルを解析できることを検証します。
• 最終的なパスを報告し、最新の組み込みスキルを config/agent/skills に同期するためにエージェントの再起動が必要かどうかを明記します。

最小限の例

ユーザーのリクエスト：

给 MoviePilot agent 加一个处理站点 Cookie 更新的内置技能

期待される結果：

• skills/update-site-cookie/ のようなディレクトリを作成または更新します。
• トリガーとなる状況を十分に記載した description を含む SKILL.md を作成します。
• そのワークフローに必要なツールのみを含めます。
• 既存の組み込みスキルを改訂する場合は、version を増やします。

最終チェックリスト

• スキルはリポジトリの skills/ ディレクトリにありますか？
• フォルダー名は frontmatter の name と一致していますか？
• description には、スキルがどのような場合にトリガーされるかが明確に記載されていますか？
• 既存のスキルを不必要に重複させていませんか？
• 組み込みスキルの更新時に version を増やしましたか？
• スキルを簡潔で手順に沿ったものにしましたか？