用途:通过内置 CLI({baseDir}/scripts/linear-cli.js)管理 Linear 的议题与项目,基于官方 @linear/sdk 调用 Linear GraphQL(https://api.linear.app/graphql)。
主要能力:覆盖团队与项目(teams、projects、createProject)、议题(issues、issue、createIssue、updateIssue)、评论(createComment)、状态与标签(states、labels)以及用户(user)等操作。
使用方式:需先安装 Node.js 与 npm,并安装脚本依赖:cd {baseDir}/scripts && npm install;设置环境变量 export LINEAR_API_KEY="lin_api_...",密钥从 https://linear.app/settings/api 获取。命令示例:node {baseDir}/scripts/linear-cli.js teams、node {baseDir}/scripts/linear-cli.js issue ENG-123、node {baseDir}/scripts/linear-cli.js createIssue "Title" "Description" "team-id" '{"priority":2}'。
推荐流程:先明确团队/项目、标签、周期、负责人、截止日期与优先级;先读取当前状态,再执行变更;最后准确总结变更内容(ID、状态、负责人、阻塞项与后续动作)。
适用场景:紧急缺陷分诊、迭代规划、发布准备、文档清理等。
限制与安全:依赖缺失或未设置 LINEAR_API_KEY 时须先完成配置;不要臆造 ID,更新前先获取确认;优先小范围更新,批量编辑前说明分组逻辑;不要在评论或描述中包含密钥;不要将数据发送到 Linear API 范围之外的端点。优先级取值与工作流模式见 references/API.md。