Back to Details

slack_report

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slack Report Share

Slack报告分享

Overview

概述

Use this skill to send markdown reports to Slack through the Fastfold Cloud backend endpoint:
  • POST /v1/slack/messages/agent-cli-report
The endpoint posts to the configured 
agent_cli_report
Slack channel and stores the same markdown as a library markdown item.
使用此skill通过Fastfold Cloud后端端点将markdown报告发送至Slack：
  • POST /v1/slack/messages/agent-cli-report
该端点会将内容发布到已配置的
agent_cli_report
Slack频道，并将相同的markdown存储为库中的markdown项。

Authentication

认证方式

  • Resolve key in this order: 
    1. FASTFOLD_API_KEY
      from environment
    2. FastFold CLI config 
      ~/.fastfold-cli/config.json
      (
      api.fastfold_cloud_key
      )
  • Do not ask users to paste secrets into chat.
  • If key is still missing:
    • Default guidance (generic agents): ask the user to set 
      FASTFOLD_API_KEY
      in environment or 
      .env
      .
    • Only if user is explicitly using FastFold CLI, you may suggest: 
      • fastfold setup
      • fastfold config set api.fastfold_cloud_key <key>
  • 按以下顺序解析密钥：
    1. 从环境变量中获取
      FASTFOLD_API_KEY
    2. 从FastFold CLI配置文件
      ~/.fastfold-cli/config.json
      中获取
      api.fastfold_cloud_key
  • 不要要求用户在聊天中粘贴密钥。
  • 如果仍然缺少密钥：
    • 默认指引（通用Agent）：请用户在环境变量或
      .env
      文件中设置
      FASTFOLD_API_KEY
      。
    • 仅当用户明确使用FastFold CLI时，可建议： 
      • fastfold setup
      • fastfold config set api.fastfold_cloud_key <key>

When to Use

适用场景

  • User asks to share/export a session report to Slack.
  • User asks to send markdown summary to the team's report channel.
  • User asks to save a report in the library and Slack in one step.
  • 用户要求将会话报告分享/导出到Slack。
  • 用户要求将markdown摘要发送至团队报告频道。
  • 用户要求一步完成报告保存到库和Slack的操作。

Agent Workflow

Agent工作流程

  1. Export or prepare markdown report content.
  2. Call the helper script: 
    • python scripts/send_agent_cli_report.py --markdown-file <path>
    • Do not replace this with ad-hoc Python 
      requests
      code.
  3. If response has 
    ok: false
    and 
    needs_slack_setup: true
    , tell user:
  4. If response includes 
    library_item_id
    , include this open link in the reply: 
    • https://cloud.fastfold.ai/code/<library_item_id>?from=library
  1. 导出或准备markdown报告内容。
  2. 调用辅助脚本： 
    • python 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

Friendly Failure Message

友好失败提示

If Slack is not configured, return a user-friendly instruction and include:
如果未配置Slack，返回用户友好的指引并包含：

Resources

资源

  • API details: references/api.md
  • API详情：references/api.md