用途:让智能体直接以 curl 调用 Confluence Cloud v2 与 Jira Cloud v3 的 REST API,完成页面、空间、附件、问题、评论、JQL 搜索等读写操作,不依赖 SDK 或 pip 包。
主要能力:内置 OpenAPI 规范与端点索引,可按 operationId 解析出方法、路径、参数与请求/响应结构,并生成 curl 骨架;提供 Confluence 与 Jira 各自的认证、分页、错误与富文本处理模式;附带 Markdown 转 ADF 的脚本。
使用方式:凭据由调用方注入(base_url、email 及 token 变量名),token 仅以 $<token_env> 形式在 curl -u 中引用,不读取或打印其值。流程为:接收凭据 → 在 assets/endpoint-index.md 查找端点 → 运行 python3 scripts/endpoint.py <confluence|jira> <operationId> 解析调用结构 → 按 references/patterns.md 构造并执行 curl → 处理分页与错误。认证用 curl -u "$email:$<token_env>";Confluence 路径前缀为 <base_url>/wiki/api/v2/,Jira 路径已含 /rest/api/3/。
适用场景:需要以编程方式对 Atlassian Cloud 执行读写,例如创建 Confluence 页面、搜索 Jira 问题、添加评论等。
限制:仅适用于 Cloud + API token,不适用于 Server / Data Center;不负责凭据的创建或解析;富文本格式不可混用(Jira 用原始 ADF 对象,Confluence atlas_doc_format 的 value 为字符串化 ADF);Jira /search/jql 不接受无限制 JQL;Confluence 删除为两阶段(先入回收站,再 purge=true 永久删除);Jira 遇 429 需按 Retry-After 退避。