slack_report について
Fastfold Cloud のバックエンド経由で Markdown レポートを Slack に送るスキルです。設定済みのレポートチャンネルに投稿し、同じ内容をライブラリー項目として保存します。
主な機能
- 01Markdown レポートの Slack 送信
- 02同内容のライブラリー Markdown 保存
- 03環境変数からの認証情報読み込み
- 04Slack 未設定時の案内
活用シーン
- 01セッションレポートのチーム Slack チャンネル共有
- 02レポートチャンネルへの要約送信
- 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 に一度に保存するよう依頼した場合。
エージェントのワークフロー
- Markdown レポートの内容をエクスポートまたは準備します。
- ヘルパースクリプトを呼び出します(Sandwalk の場合:利用可能であれば、ホストのスキルディレクトリまたは
SANDWALK_SKILLS_DIR/slack_reportを使用します)。python3 scripts/send_agent_cli_report.py --markdown-file <path>- その場しのぎの Python
requestsコードで代用しないでください。
- レスポンスが
ok: falseかつneeds_slack_setup: trueの場合は、ユーザーに以下を伝えます。- Slack を https://cloud.fastfold.ai/integrations/slack で設定します。
agent_cli_reportのチャンネルを設定します。
- レスポンスに
library_item_idが含まれる場合は、返信に次のリンクを含めます。https://cloud.fastfold.ai/code/<library_item_id>?from=library
エラー時の案内メッセージ
Slack が設定されていない場合は、ユーザーにわかりやすい手順を案内し、次のリンクを含めます。
リソース
- API の詳細:references/api.md