📦 Linear — 线性

Linear Linear 是一款面向软件开发团队的项目管理工具，用于跟踪问题、冲刺和路线图。它帮助简化工作流、自动化任务，并在整个开发生命周期中提升协作。 官方文档：https://developers.linear.app/

Linear 概览 Issue Comment Project Cycle User Team Label Filter View 按需使用动作名称与参数。

使用 Linear 本技能通过 Membrane CLI 与 Linear 交互。Membrane 自动处理身份验证与凭证刷新——你只需关注集成逻辑，无需操心 auth plumbing。

安装 CLI 全局安装 Membrane CLI，以便在终端运行 membrane： npm install -g @membranehq/cli@latest

身份验证 membrane login --tenant --clientName= 若支持交互模式，将自动打开浏览器；否则在控制台打印授权 URL。 无头环境：命令会打印授权 URL，请用户用浏览器打开。登录完成后看到验证码，再执行： membrane login complete 任意命令加 --json 可输出机器可读 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于根据你的 harness 自动调整工具。

连接 Linear 使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接： membrane connection ensure "https://linear.app/" --json 用户在浏览器完成认证，输出包含新连接 id。这是最快获取连接的方式。 URL 会被归一化为域名并与已知应用匹配；若未找到，则自动创建应用并构建连接器。 若返回的连接 state 为 "READY"，直接跳到第 2 步。

1b. 等待连接就绪 若连接处于 BUILDING 状态，轮询直到就绪： npx @membranehq/cli connection get --wait --json --wait 会长轮询（默认 --timeout 30 秒）直到状态变化。持续轮询直到状态不再是 BUILDING。 结果状态指示下一步： READY — 连接已就绪，跳到第 2 步。 CLIENT_ACTION_REQUIRED — 用户或 agent 需执行操作。clientAction 对象说明所需动作： clientAction.type — 动作类型： "connect" — 用户需认证（OAuth、API key 等），包括首次认证与重新认证。 "provide-input" — 需补充信息（如选择要连接的应用）。 clientAction.description — 人类可读说明。 clientAction.uiUrl（可选）— 预构建 UI 的 URL，可展示给用户。 clientAction.agentInstructions（可选）— 给 AI agent 的编程指令。 用户完成动作后，再次执行 membrane connection get --json 检查状态是否变为 READY。 CONFIGURATION_ERROR 或 SETUP_FAILED — 出错，查看 error 字段详情。

搜索动作 用自然语言描述你想做的事来搜索： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 务必在特定连接上下文中搜索。每条结果包含 id、name、description、inputSchema、outputSchema。

常用动作 Name Key Description Create Label create-label 创建新标签 List Cycles list-cycles 列出组织内所有周期（冲刺） List Workflow States list-workflow-states 列出所有工作流状态 List Labels list-labels 列出所有标签 Get Current User get-current-user 获取当前认证用户 List Users list-users 列出组织内所有用户 Create Project create-project 创建新项目 List Projects list-projects 列出所有项目 Get Team get-team 按 ID 获取单个团队 List Teams list-teams 列出所有团队 List Comments list-comments 列出问题的评论 Create Comment create-comment 在问题上创建评论 Search Issues search-issues 按文本搜索问题 List Issues list-issues 带过滤与分页列出问题 Delete Issue delete-issue 将问题移至回收站 Update Issue update-issue 更新现有问题 Get Issue get-issue 按 ID 获取单个问题 Create Issue create-issue 创建新问题

执行动作 membrane action run --connectionId=CONNECTION_ID --json 传递 JSON 参数： membrane action run --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 结果位于返回对象的 output 字段。