mcpField
S
slack_report

slack_report

github.com/fastfold-ai生産性3130 回インストール12 週間前に更新
リポジトリ

slack_report について

Fastfold Cloud のバックエンド経由で Markdown レポートを Slack に送るスキルです。設定済みのレポートチャンネルに投稿し、同じ内容をライブラリー項目として保存します。

主な機能

  1. 01Markdown レポートの Slack 送信
  2. 02同内容のライブラリー Markdown 保存
  3. 03環境変数からの認証情報読み込み
  4. 04Slack 未設定時の案内

活用シーン

  1. 01セッションレポートのチーム Slack チャンネル共有
  2. 02レポートチャンネルへの要約送信
  3. 03レポート保存と Slack 投稿の同時実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fastfold-ai/skills --skill slack_report

インストール後、Claude Code で/slack_reportを入力して読み込まれたか確認します。

同梱ファイルscripts/send_agent_cli_report.pyreferences/api.md

詳細

Slack レポート共有

概要

このスキルを使用すると、Fastfold Cloud バックエンドエンドポイントを通じて Markdown レポートを Slack に送信できます。

  • POST /v1/slack/messages/agent-cli-report

このエンドポイントは、設定済みの agent_cli_report Slack チャンネルに投稿し、同じ Markdown をライブラリの Markdown アイテムとして保存します。

認証

推奨(Sandwalk エージェント): Integrations → Fastfold AI Cloud で公開される FASTFOLD_API_KEY を使用します。環境変数を使い、値をハードコードしたり、ホームディレクトリの設定パスを検索したりしないでください。

シークレットをチャットに貼り付けるようユーザーに求めないでください。ヘルパースクリプトが明確な認証エラーで失敗するまでは、.env やエクスポートを求めないでください。 printenv FASTFOLD_API_KEY を優先するか、スクリプトを実行してください。

環境変数: FASTFOLD_API_KEY、SANDWALK_SESSION_WORKSPACE、SANDWALK_SKILLS_DIR (設定されている場合)。

スクリプトの失敗後もキーが見つからない場合: Sandwalk Integrations(または .env / エクスポート)を案内してください。

使用する場面

  • ユーザーがセッションレポートを Slack に共有またはエクスポートするよう依頼した場合。
  • ユーザーが Markdown の要約をチームのレポートチャンネルに送信するよう依頼した場合。
  • ユーザーがレポートをライブラリと Slack に一度に保存するよう依頼した場合。

エージェントのワークフロー

  1. Markdown レポートの内容をエクスポートまたは準備します。
  2. ヘルパースクリプトを呼び出します(Sandwalk の場合:利用可能であれば、ホストのスキルディレクトリまたは SANDWALK_SKILLS_DIR/slack_report を使用します)。
    • python3 scripts/send_agent_cli_report.py --markdown-file <path>
    • その場しのぎの Python requests コードで代用しないでください。
  3. レスポンスが ok: false かつ needs_slack_setup: true の場合は、ユーザーに以下を伝えます。
  4. レスポンスに library_item_id が含まれる場合は、返信に次のリンクを含めます。
    • https://cloud.fastfold.ai/code/<library_item_id>?from=library

エラー時の案内メッセージ

Slack が設定されていない場合は、ユーザーにわかりやすい手順を案内し、次のリンクを含めます。

リソース

コメント