Pilot Share

基于 pilotctl 在代理间发送单个文件或目录；目录会先打包，命令可返回 JSON，并提供接收记录查询。示例包含失败重试流程。需要 pilot-protocol 技能、pilotctl、jq 与 tar，且守护进程应已运行。

teoslayer

热度 46.34

最近更新 2026-05-11 17:41:37

分类：自动化依赖：代码执行 / 读写文件应用场景：工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pilot-share

Metadata

name: pilot-share
description: One-click file sharing with progress tracking and automatic retry over Pilot Protocol. Use this skill when: 1. You need to quickly share a single file or directory with another agent 2. You want progress tracking and confirmation for file transfers 3. You need automatic retry on transfer failure Do NOT use this skill when: - You need bidirectional synchronization (use pilot-sync instead) - You need to stream data in real-time (use pilot-stream-data instead) - You need to maintain a persistent shared folder (use pilot-dropbox)
tags: ["pilot-protocol","file-transfer","sharing","one-shot"]
license: AGPL-3.0
compatibility: Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start).
metadata: {"author":"vulture-labs","version":"1.0","openclaw":{"requires":{"bins":["pilotctl"]},"homepage":"https://pilotprotocol.network"}}
allowed-tools: ["Bash"]

pilot-share

One-click file sharing between agents with progress tracking and automatic retry.

Commands

Share single file

pilotctl --json send-file 1:0001.AAAA.BBBB /path/to/document.pdf

Share directory

DIR="/path/to/share"
ARCHIVE="/tmp/$(basename $DIR).tar.gz"

tar czf "$ARCHIVE" -C "$(dirname $DIR)" "$(basename $DIR)"
pilotctl --json send-file "$DEST" "$ARCHIVE"
rm "$ARCHIVE"

List received shares

pilotctl --json received | jq -r '.received[] | "\(.timestamp) \(.filename) (\(.size) bytes)"'

Workflow Example

Share file with retry:

#!/bin/bash
DEST="1:0001.AAAA.BBBB"
FILE="/path/to/large-file.zip"
MAX_RETRIES=3

for RETRY in $(seq 1 $MAX_RETRIES); do
  echo "Attempt $RETRY/$MAX_RETRIES"

  if pilotctl --json send-file "$DEST" "$FILE" | jq -e '.success'; then
    echo "Transfer successful!"
    break
  fi

  [ $RETRY -lt $MAX_RETRIES ] && sleep 5
done

Dependencies

Requires pilot-protocol skill, pilotctl, jq, and tar.