cline/linear-sdk-scripting

linear-sdk-scripting 是做什麼的？

來自 cline/skills 的代理技能 'linear-sdk-scripting'。

概述

此技能賦予 AI 代理使用 Linear SDK 以程式化方式與 Linear 專案管理平台互動的能力。它允許自動化常見的工作流程，例如建立議題、更新狀態、指派負責人，以及管理專案。

運作方式

1. 安裝: 確保已在您的環境中安裝 @linear/sdk npm 套件。
2. 驗證: 透過設定 LINEAR_API_KEY 環境變數來提供 Linear API 金鑰。
3. 腳本化: 撰寫或要求 AI 代理產生使用 SDK 的 JavaScript/TypeScript 腳本，以執行特定操作。

支援的平台

• Claude Code
• Cursor
• Codex
• 任何支援 Node.js 並能執行 TypeScript/JavaScript 腳本的環境

使用案例

• 自動化錯誤記錄: 當 CI/CD 管道發生失敗時，自動在 Linear 中建立議題。
• 狀態同步: 將 GitHub Pull Request 的狀態與 Linear 議題同步。
• 批次操作: 執行大量議題的批次更新，例如重新指派或修改優先順序。
• 報告產生: 查詢議題並產生客製化的進度報告。

快速入門

# 安裝 Linear SDK
npm install @linear/sdk

# 設定 API 金鑰
export LINEAR_API_KEY="你的_linear_api_金鑰"

範例腳本

const { LinearClient } = require('@linear/sdk');

const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });

async function createIssue() {
  const team = await client.team('團隊ID');
  const issue = await client.createIssue({
    teamId: team.id,
    title: '新議題',
    description: '這是一個由腳本建立的議題。',
  });
  console.log(`議題已建立: ${issue.url}`);
}

createIssue();

安全考量

• API 金鑰管理: 切勿將 API 金鑰直接寫入程式碼。請使用環境變數或安全的金鑰管理服務。
• 權限: 確保您的 API 金鑰僅具備執行所需操作的最低權限。