Linear项目读取工具Skill linear-projects-read

这是一个用于通过命令行接口(CLI)查询和获取Linear项目管理平台中项目信息的只读工具。它支持按状态、负责人等条件筛选项目列表,以及通过ID或名称精确或模糊查询特定项目的详细信息。关键词:Linear API, 项目管理, CLI工具, 项目查询, 只读操作, 自动化脚本

DevOps 0 次安装 0 次浏览 更新于 3/2/2026

名称: linear-projects-read 描述: 通过CLI列出和获取Linear项目(只读操作) 版本: 1.0.0 许可证: MIT 兼容性: opencode

概述

用于读取Linear项目的CLI工具。需要在 <git-root>/.env 文件中设置或环境变量中导出 LINEAR_API_KEY

先决条件

  • 已安装 bun 运行时
  • <git-root>/.env 或环境变量中设置 LINEAR_API_KEY

命令

列出项目

bun .opencode/skill/linear-projects-read/list-projects.js [选项]

选项:

  • --status <状态> - 按状态筛选 (planned, started, paused, completed, canceled)
  • --lead <负责人姓名> - 按项目负责人姓名筛选
  • --limit <数量> - 最大结果数 (默认: 25)
  • --json - 以JSON格式输出

示例:

bun .opencode/skill/linear-projects-read/list-projects.js --limit 10
bun .opencode/skill/linear-projects-read/list-projects.js --status started
bun .opencode/skill/linear-projects-read/list-projects.js --lead "James Madison" --json

获取项目

bun .opencode/skill/linear-projects-read/get-project.js <项目ID或名称> [选项]

参数:

  • project-id-or-name - 项目UUID或名称(支持部分匹配)

选项:

  • --json - 以JSON格式输出

示例:

bun .opencode/skill/linear-projects-read/get-project.js "Mount Vernon"
bun .opencode/skill/linear-projects-read/get-project.js "Monticello" --json

输出行为

  • 命令输出直接显示在用户终端中
  • 请勿重新总结或重新格式化表格输出 - 用户已经可以看到
  • 仅当用户明确请求分析、筛选或总结时,才提供额外评论
  • 当使用 --json 输出配合 jq 等工具时,处理后的结果对用户已经可见

备注

  • 项目名称支持部分匹配(不区分大小写)