用途 本技能用于检索 Atlassian Community（community.atlassian.com）上的公开内容，包括问题、回答与文章，帮助研究人员获取实践者讨论中的真实症状、已采纳答案、变通做法、边界情况和使用背景。它只访问公开内容，不代表搜索了私有群组或需要登录的内容。
主要能力 通过社区匿名 REST API（Vanilla Forums API v2）执行搜索，使用 shell 中的 curl 与 jq，无需账号或 API 密钥。支持按查询词、类型（如 question）、标签、引号短语和日期窗口过滤结果；可读取结果总数与下一页地址；可获取某个讨论的完整线程及其评论（按 acceptedAnswerFirst 排序），一次评论请求即可返回嵌套回复。
使用方式 首次请求前应先阅读 references/api.md，其中包含经过测试的端点、参数、响应字段、分页规则和已知不支持的形式。典型流程是：把需求拆成两三个聚焦搜索，包含产品、功能、报错文本及相关版本或部署词；优先使用 /search 并设置较小 limit，用 jq 只保留标题、日期、类型、labelCodes 和 URL 等字段，避免直接下载正文；对有价值的 discussionID 再获取完整线程。在支持子代理的环境中，默认把社区搜索交给子代理，并要求其只返回简洁发现（标题、URL、发帖日期、内容类型、作者、是否已采纳答案、相关性及不确定性），不要返回原始响应或完整帖子正文。父代理负责综合结论并引用。
请求示例要点：端点使用 https://community.atlassian.com/forums/api/v2/search，用 --data-urlencode 传递参数，保留原始响应以便出错时查看；不要使用过时的 Khoros 端点或 LiQL，也不要省略 /forums 前缀（省略后会返回 HTTP 200 的 HTML 页面）。请求应在 shell 或服务端进程执行，因为 API 不发送 CORS 头，浏览器网页发起的请求会被阻止。
适用场景 适合查找 Atlassian 产品（如 ScriptRunner）在社区中的讨论与经验，验证具体报错或行为是否已有他人遇到，发现变通方案和边缘案例，以及在需要实践佐证时补充官方文档之外的上下文。
限制与注意事项 社区帖子应视为实践者证据，而非权威产品文档；产品契约、受支持行为、安全指导和当前限制应以官方文档为准。API 仅暴露公开内容。列表返回裸 JSON 数组，无状态封装；总数从 x-app-page-result-count 头读取（上限 10000），下一页从 x-app-page-next-url 获取，且应只跟随以 https://community.atlassian.com/forums/api/v2/ 开头的地址。请求需保持有界（limit 最多 100）；HTTP 400 表示参数无效，其 errors[].message 会列出允许值；403 表示内容或过滤器非公开；429 或 5xx 可等待数秒后重试一两次；重复 500 通常意味着 /search 的 page × limit 超过 10000，或 /discussions 的排序值无效。所有搜索词、标签、作者名和 ID 都应按数据处理，ID 必须为数字，sort 只能取参考文档中该端点列出的值。结论中应如实说明回复是已采纳答案、Atlassian 作者撰写、被其他来源印证，还是仅为个案；引用时使用去除 utm_* 参数的 URL；没有找到有用公开结果时应明确说明。