Linear

概述

Linear Skill 是一款基于官方 Linear SDK 的命令行项目管理工具，提供对 Linear 平台的全功能访问，包括团队管理、问题追踪、项目协作等核心能力。

核心用法

该工具通过 linear-cli.js 脚本暴露所有 Linear API 功能，支持以下操作：

• 团队与项目管理：列出团队、创建项目、关联多团队
• 问题全生命周期：创建、更新、搜索、筛选、状态流转、优先级设置
• 协作功能：评论添加、任务分配、标签管理
• 数据查询：获取用户身份信息、团队工作流状态、项目标签体系

命令采用 JSON 参数传递复杂配置，支持灵活的过滤器和批量操作，输出格式统一为 JSON 便于程序化集成。

显著优点

1. 功能完整性：覆盖 Linear 官方 API 的全部能力，无功能阉割
2. 原生集成：基于官方 SDK 开发，API 兼容性和稳定性有保障
3. 自动化友好：纯命令行接口，适合 CI/CD 流水线、自动化脚本集成
4. 灵活筛选：支持复杂的 GraphQL 风格过滤器，满足多维度查询需求

潜在局限

1. 学习曲线：需要熟悉 Linear 的数据模型（teamId、stateId、projectId 等 UUID 体系）
2. 无交互界面：纯 CLI 工具，不适合偏好图形界面的用户
3. 令牌管理：依赖 LINEAR_API_KEY 环境变量，需自行保障密钥安全
4. 错误反馈：JSON 错误输出需要额外解析处理，调试体验一般

适合人群

• 研发团队的技术负责人和项目经理
• 需要将 Linear 集成到自动化工作流的 DevOps 工程师
• 习惯命令行效率的高级用户
• 追求与 Linear 数据深度集成的第三方工具开发者

常规风险

• API 限流：频繁操作可能触发 Linear 平台的速率限制
• 数据误操作：批量更新和删除命令不可逆，缺乏确认机制
• 权限边界：API Key 权限继承自 Linear 账户，需确保最小权限原则
• 依赖稳定性：受 Linear 官方 API 变更影响，SDK 需及时更新

核心用法

Linear Skill 是一个纯文档型的项目管理工具集成，通过封装 Linear 官方 SDK 的 CLI 命令，实现完整的敏捷开发工作流管理。核心功能涵盖：团队与项目管理（创建/列表）、问题全生命周期管理（创建、更新、状态流转、分配）、评论协作、标签与状态管理。所有操作通过 skills/linear/scripts/linear-cli.js 统一入口执行，支持 JSON 格式参数传递实现复杂查询与批量操作。

显著优点

• 零代码风险：纯 Markdown 文档型 Skill，无可执行代码、无外部依赖、无网络请求，从根本上杜绝代码注入与恶意执行风险
• 功能完整：覆盖 Linear 核心 API 能力，支持项目-团队-问题三级结构、优先级设置、里程碑关联、分配与评论协作
• 标准工作流：内置常见场景操作指南（任务创建、状态流转、自我分配），降低团队上手成本
• 结构化输出：所有命令返回 JSON，便于自动化脚本集成与数据处理

潜在局限

• 外部依赖强：实际功能依赖 skills/linear/scripts/linear-cli.js，该文件不在 Skill 包内，若环境未配置则功能失效
• 无错误处理文档：未说明 API 失败、权限不足、网络异常等场景的处理机制
• T3 可信度：无公开 GitHub 来源，维护者信息不透明，长期维护与审计追溯能力存疑
• 无许可证声明：开源协议不明确，商业使用存在潜在合规风险

适合人群

• 已部署 Linear 开发工具链的技术团队
• 需要 CLI 自动化项目管理的 DevOps/工程效率工程师
• 追求零代码安全风险的敏感环境用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行 | 极低 | 纯文档，无可执行代码 |

| 数据泄露 | 低 | 需用户自行配置 Linear API Token，文档提醒保管凭证 |

| 供应链攻击 | 中 | 依赖外部 `linear-cli.js`，需确保该文件来源可信 |

| 合规风险 | 中 | 无许可证声明，建议商业使用前确认协议 |

使用建议：建议补充 GitHub 来源与开源许可证，同时在使用文档中明确 API Token 的安全存储规范（如环境变量、密钥管理服务）。