用途:回答 Slack 平台概念性或操作类问题时,先定位 docs.slack.dev 上的对应页面,再以干净的 Markdown 读取,使答案来自实时文档。无需认证,也不需要 Slack 工作区。
主要能力:站点提供三种机器可读入口。搜索 API:GET https://docs.slack.dev/api/v1/search?query=<q>&category=<c> 返回 JSON 排序结果,建议始终带 category,否则结果偏向 SDK 页面。逐页 Markdown:任意页面 URL 加 .md 即可获取。索引文件:/llms.txt 为精选概览,/llms-sitemap.md 列出全部 Markdown 页面。
使用方式:若已给出 docs.slack.dev 链接,直接抓取其 .md 版本阅读;否则先用搜索 API 发现页面,按意图选 category(guides 为默认,reference 用于具体方法、事件、权限、对象或 Block Kit 元素,工具类 category 如 python、javascript、java、slack_cli、slack_github_action、deno_slack_sdk 需先确认开发者所用工具)。搜索无果时改用 llms-sitemap.md,或参考索引页如 /reference/methods.md、events.md、scopes.md、objects.md、block-kit.md。抓取时把相对路径补全为 https://docs.slack.dev 并追加 .md,页面开头含 Source: <url> 行,应保留以便引用。
适用场景:Slack 平台概念与操作问答、API 参考查询、按工具(Slack CLI、Bolt for JS/Python/Java、Node/Python/Java SDK、GitHub Action)查阅实现细节。
限制:不得凭记忆回答事实性问题,不得编造文档 URL,不得转述未实际抓取的页面;抓取失败应如实说明。并非所有 URL 都有 .md 版本,失败时回退到搜索 API 或 sitemap。搜索端点有速率限制并缓存约 5 分钟,无 query 或 category 非法会返回 400。若开发者未说明所用工具,应先询问再假设。