SuperAPI AI 工具集

linear-expert

办公与效率

查看项目

更新于 10-15 17:28

技能介绍

用途:该技能用于在 Linear 这一强调固定数据模型与 GraphQL 公开 API 的问题追踪器中,完成从工作区搭建到程序化批量操作的各类任务。

主要能力:工作区与团队配置(URL key、SSO、团队 key、Cycle 节奏、估算刻度、工作流状态、标签体系);规划层级(Cycles、Projects 与 Milestones、Initiatives、Roadmap 视图);分类自动化(来自 Slack、支持渠道、GitHub Issues 的入站路由与每日分类 SOP);GraphQL API 查询与 mutation 编写、分页、批量 mutation、webhook 与速率限制管理;GitHub 集成(魔法词自动关联/自动关闭、分支自动关联、PR 状态同步);API 驱动的批量编辑与 Jira 到 Linear 的迁移规划。

使用方式:Linear API 仅提供 GraphQL,端点为 https://api.linear.app/graphql,可通过个人 API key(Authorization: <key>)或 OAuth2 认证。资料给出示例命令:linear_query() { curl -s -X POST https://api.linear.app/graphql -H "Authorization: $LINEAR_API_KEY" -H "Content-Type: application/json" -d "{"query": "$1"}" }。建议本地缓存 team/label/state 的 UUID,使用嵌套选择避免 N+1 调用,并优先使用 webhook 而非轮询。

适用场景:新建工作区、团队或项目;设计 Cycle 节奏、分类规则与 SLA 工作流;编写 GraphQL 查询与 mutation;配置 GitHub PR 自动关联/自动关闭与 Slack 通知;构建 Initiative/Project/Milestone 层级用于高管路线图;跨数百个 issue 执行批量操作;从 Jira 迁移且尽量保留历史;排查自动化、子 issue 或分类规则未按预期触发。

限制:Linear 没有自定义字段,扩展只能通过标签、描述或外部系统。免费版每工作区上限 250 个 issue,且不含 Initiatives 与 SAML。API 速率限制按工作区全局共享,重自动化需协调。导入器保留大部分历史,但无法重建 Jira 的自定义工作流状态,映射为多对五。GraphQL schema 持续演进,客户端代码需按弃用日历固定。Jira 侧配置、Notion 路线图文档、OKR 设定、发布说明生成等不在范围内。