linear

Linear Issues Skill 是一款专为开发者设计的命令行工具，用于与 Linear 项目管理平台进行深度集成。该 Skill 通过封装 Linear GraphQL API，提供了一套完整的 issue 管理解决方案，涵盖查询、创建、更新、评论等核心功能。

核心用法：用户需先将 Linear API 密钥配置于 ~/.clawdbot/credentials/linear.json，随后即可通过 scripts/linear.sh 脚本执行各类操作。主要功能包括：查看个人分配任务（--mine）、按团队筛选（--team）、搜索 issues、创建新任务（支持设置优先级）、更新状态与指派人、添加评论等。所有命令均支持 --json 标志输出原始 API 响应，便于与其他工具链集成。

显著优点：首先，该 Skill 完全开源透明，代码托管于 GitHub，采用 MIT 许可证，社区可自由审计。其次，功能聚焦且实用，覆盖了开发者日常 90% 以上的 Linear 使用场景，无需打开浏览器即可完成 issue 流转。第三，架构轻量，仅依赖系统自带的 curl、jq 等工具，无重型运行时负担。第四，数据流向清晰，所有交互仅限于 Linear 官方 API，无第三方数据中转。

潜在缺点与局限性：最突出的问题是用户输入缺乏充分转义，存在 GraphQL 注入风险——当 issue 标题或描述包含引号等特殊字符时，可能破坏查询结构甚至导致非预期行为。此外，功能相对基础，不支持批量操作、自定义视图、时间追踪等高级特性。错误处理机制较为简单，API 限流或网络异常时的用户体验有待优化。最后，作为社区贡献项目，长期维护承诺不明确。

适合的目标群体：该 Skill 最适合已采用 Linear 作为项目管理工具的技术团队，尤其是偏好命令行工作流的开发者、DevOps 工程师及技术负责人。对于需要快速创建/更新 issue、在终端环境中保持专注的工程师尤为合适。不适合需要复杂项目管理功能或非技术背景的用户。

使用风险：除前述注入风险外，还需注意：API 密钥以明文形式存储于本地文件，若设备共享或权限配置不当存在泄露可能；依赖 Linear API 的稳定性，服务中断将直接影响功能可用性；高频操作可能触发 API 速率限制；作为社区 Skill，安全更新响应速度可能不及官方工具。