📦 Backlog — 项目管理

技能文档

# Backlog Backlog 是一款项目和任务管理工具，开发团队用它来跟踪缺陷、管理代码并进行项目协作。 官方文档：https://developer.backlog.com/ ## Backlog 概览 - Backlog Space - Project - Issue - Comment - User 按需使用 action 名称与参数。 ## 使用 Backlog 本技能通过 Membrane CLI 与 Backlog 交互。Membrane 会自动处理身份验证与凭证刷新——你只需关注集成逻辑，无需操心鉴权细节。 ### 安装 CLI 安装 Membrane CLI，以便在终端运行 membrane： ``bash npm install -g @membranehq/cli ` ### 首次设置 `bash membrane login --tenant ` 浏览器会打开进行身份验证。 无头环境： 运行命令后，将打印出的 URL 复制给用户，在浏览器中打开，然后执行 membrane login complete 完成登录。 ### 连接到 Backlog 1. 创建新连接： `bash membrane search backlog --elementType=connector --json ` 从 output.items[0].element?.id 获取 connector ID，然后： `bash membrane connect --connectorId=CONNECTOR_ID --json ` 用户在浏览器中完成身份验证，输出将包含新的 connection ID。 ### 获取现有连接列表 不确定连接是否已存在时： 1. 检查现有连接： `bash membrane connection list --json ` 如果存在 Backlog 连接，记下其 connectionId ### 搜索 action 当你知道要做什么但不确定具体 action ID 时： `bash membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json ` 该命令会返回包含 id 和 inputSchema 的 action 对象，从而了解如何运行它。 ## 常用 action | 名称 | 键 | 描述 | | --- | --- | --- | | 获取 Issue 类型 | get-issue-types | | | 删除 Issue | delete-issue | | | 添加评论 | add-comment | | | 获取用户 | get-users | | | 列出评论 | list-comments | | | 获取当前用户 | get-current-user | | | 更新 Issue | update-issue | | | 创建 Issue | create-issue | | | 列出 Issue | list-issues | | | 获取项目列表 | get-projects | | | 获取项目 | get-project | | | 获取 Issue | get-issue | | ### 运行 action `bash membrane action run --connectionId=CONNECTION_ID ACTION_ID --json ` 如需传递 JSON 参数： `bash membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }" ` ### 代理请求 当现有 action 无法满足需求时，可通过 Membrane 代理直接向 Backlog API 发送请求。Membrane 会自动把基础 URL 追加到你提供的路径，并注入正确的身份验证头——包括凭证过期后的透明刷新。 `bash membrane request CONNECTION_ID /path/to/endpoint ` 常用选项： | 标志 | 描述 | |------|-------------| | -X, --method | HTTP 方法（GET、POST、PUT、PATCH、DELETE），默认 GET | | -H, --header | 添加请求头（可重复），如 -H "Accept: application/json" | | -d, --data | 请求体（字符串） | | --json | 快捷方式：发送 JSON 体并设置 Content-Type: application/json | | --rawData | 按原样发送请求体，不做任何处理 | | --query | 查询参数（可重复），如 --query "limit=10" | | --pathParam | 路径参数（可重复），如 --pathParam "id=123" | ## 最佳实践 - 始终优先通过 Membrane 与外部应用通信——Membrane 提供预置 action，内置鉴权、分页和错误处理，可节省 token 并提高安全性。 - 先发现，再构建——运行 membrane action list --intent=QUERY`（将 QUERY 替换为你的意图）查找现有 action，再编写自定义 API 调用。预置 action 已处理分页、字段映射及边界情况，而原始 API 调用容易遗漏。 - 让 Membrane 管理凭证——绝不要向用户索要 API 密钥或 token。创建连接即可；Membrane 在服务器端完整管理 Auth 生命周期，本地无敏感信息。