Skills CLI

初期設定

初期設定ツールはゲートウェイ URL、API キー、任意の認証プレフィックス、タイムアウトを尋ね、.env に書き込み、既定で /api/ping を呼び出します。

npx skills add scrumball/skills

確認

python3 scripts/scrumball_cli.py doctor

成功すると次が返ります。

{
  "ok": true
}

タスクを探す

python3 scripts/scrumball_cli.py tasks --search creator

呼び出しをプレビュー

python3 scripts/scrumball_cli.py demo \
  --task lead.find-tiktok-creators \
  --param query=nike \
  --dry-run

呼び出しを実行

タスク、パラメータ、対象環境を確認したら --dry-run を外します。

python3 scripts/scrumball_cli.py demo \
  --task lead.find-tiktok-creators \
  --param query=nike

認証情報の管理

• .env や実際の API キーをリポジトリにコミットしないでください。
• 本番環境ではシークレット管理サービスか CI/CD のシークレットを使用します。
• ログ、エラー、プロンプト、業務レポートに API キー全体を出力しないでください。
• 開発・テスト・本番で別々の認証情報を使用します。
• API キーを定期的に更新し、最小権限の原則に従います。

呼び出しの安全性

• 初回は --dry-run でマッピングとパラメータを確認します。
• ドキュメントのサンプル値を実際のユーザー入力として扱わないでください。
• 監視タスクの作成・更新・停止には確認と監査を追加します。
• バッチ呼び出しでは同時実行数、リトライ、タイムアウトを制御します。
• レート制限とクォータは実際の Scrumball ゲートウェイのポリシーに従います。クライアント側で仮定しないでください。
• プラットフォーム間を比較する際は指標の定義差を示し、単純に同一視しないでください。

データ品質

• リアルタイム API がデータを返さない場合は 1 回再試行し、縮退結果を記録します。
• オーディエンス指標が欠けていてもスコアリングは継続できますが、信頼度は下げてください。
• 検索結果が無い場合は条件を一度に 1 つだけ緩め、その変更を記録します。
• 監視データに遅延がある場合は、データの鮮度を明示します。
• 業務上の結論には、元の識別子、呼び出し時刻、operationId を残して監査可能にします。