pipefy-skill-template について
pipefy-skill-template は、Pipefy のドメインスキルを記述するための空のテンプレートです。利用条件、前提条件、MCP ツールと CLI の対応、手順、成功基準、障害対応の項目があります。
主な機能
- 01標準化されたスキル文書の構成
- 02利用条件と対象外の項目
- 03前提条件とツール対応表
- 04MCP と CLI の手順用プレースホルダー
- 05成功基準と障害対応の項目
活用シーン
- 01新しい Pipefy ドメインスキルの作成
- 02MCP ツールと CLI 対応コマンドの記録
- 03設定要件と復旧手順の文書化
MCP 対応
MCP ツール、CLI の対応コマンド、呼び出し例を記録する欄があります。テンプレート自体が MCP ツールを提供するわけではありません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pipefy/ ai-toolkit --skill pipefy-skill-templateインストール後、Claude Code で/pipefy-skill-templateを入力して読み込まれたか確認します。
詳細
[スキルのタイトル]
[このスキルでできることと、エージェントがいつ読み込むべきかを1〜2文で説明します。] [任意:MCP ツールの数。例:N 個の MCP ツール。]
使用するタイミング
- [このスキルを呼び出すべきユーザーの意図/発話の例。]
- [別の呼び出し条件。]
このスキルを使用しないケース:
- [対象外のケース。関連する場合は、別のスキルまたは方法を案内します。]
前提条件
- [事前に必要な ID、ロール、設定。例:
pipe_id、組織へのアクセス権。] - [必要なインストール方法があれば記載します:ホスト型 MCP、ローカル MCP、CLI。]
必要なツール
| ツール(MCP) | CLI 相当 | 読み取り専用 |
|---|---|---|
[mcp_tool_name] | pipefy [domain] [action] | はい/いいえ |
角括弧のプレースホルダーは、実際の MCP サーバーに存在する MCP ツール名
(または docs/parity.md)と、提供されている CLI コマンドだけに置き換えてください。
不明な名前があると、このリポジトリの CI は失敗します。
手順
-
[手順名] — [何をするのか、その理由を説明します。]
MCP:
[mcp_tool_name] [arg]=[value]CLI:
pipefy [domain] [action] --[flag] [value] -
[次の手順] — ...
成功条件
- [エージェントまたは人間が確認できる、観察可能な結果。]
失敗する場合
| 症状 | 考えられる原因 | 復旧方法 |
|---|---|---|
| [エラーまたは不適切な状態] | [原因] | [修正方法または代替スキル] |
関連項目
- [関連するスキルのパス。例:
skills/pipes-and-cards/pipefy-pipes-and-cards/SKILL.md]
コメント
Markdown 対応