Linear — project and issue management via GraphQL API

[fatwang2]

Plugin name & target service / 插件名与目标服务

Linear — 基于 Linear 官方 GraphQL API 的项目与议题管理插件。

Scenario & scope / 场景与边界

用户可以让 Cindy：

• 查看当前 Linear 用户与组织；
• 列出团队和项目；
• 搜索、查看、创建和更新议题；
• 为议题添加评论。

明确不在首版范围内：自定义结果卡片、远程 MCP、OAuth、附件、删除操作以及 Linear API 的完整映射。插件使用 Cindy 默认工具调用 UI；首版只开放完成常见议题工作流所需的最小工具集。

Overlap check / 与现有插件的查重

已逐一检查仓库现有插件的 ghost.json（description、whenToUse、tools 与 network hosts），没有现有 Linear 插件或共享 api.linear.app 的插件。

最接近的是：

• cindy-notion：面向 Notion 页面与数据库内容，不管理 Linear 项目/议题；
• cindy-github / cindy-gitlab：面向代码托管平台的 issue/PR，不访问 Linear 工作区。

因此这是特定服务的产品集成，不是重复的通用项目管理能力。

Required capabilities / 所需能力声明

• Slots：仅 tool、network；
• Network：仅 api.linear.app；
• Credential：用户创建的 Linear Personal API Key，经 network.secrets[].inject 由 Host 以原始 Authorization header 注入；设置页只通过同源 PUT /secrets/api_key 保存；
• 不需要 Node Runtime、文件系统、通知、card/panel 或 MCP 能力。

首发计划使用 0.1.0，并在 provisioning.json 采用 staged audience（不默认自动安装给全部用户）。

Irreversible side effects / 不可逆副作用

以下工具会改变 Linear 外部状态：

• linear_create_issue：创建议题；
• linear_update_issue：修改议题；
• linear_add_comment：发布评论。

实现会在所有失败路径上明确区分 not_executed / executed / unknown，对 unknown 不建议盲目重试。其余 viewer、teams、projects、search、get 工具均为只读。

[nanaco666]

这个提案有明确用户价值，且查重与最小网络边界说明较完整；但它包含创建/更新 Issue、发表评论等外部写副作用，并使用可能覆盖 Linear workspace 的 API Key。需要人工审核，已通知运营，请等待；维护者确认前不允许直接提交 PR。

人工审核需重点确认 API Key 权限与 workspace/team 边界、允许的 GraphQL mutation 清单、所有失败路径的 not_executed / executed / unknown 三态语义（unknown 不得建议盲目重试），以及 staged audience。