集成

Linear

通过自带的 Node CLI 读取与修改 Linear 的 issue、项目和评论。

它能做什么

基于官方 `@linear/sdk` 封装的 Node 命令行工具，用于管理 Linear 的 issue、项目、评论、标签、状态和 cycle。先读取当前状态，再发起创建或更新操作，使用本地环境变量中的 `LINEAR_API_KEY` 调用 Linear GraphQL API。覆盖的命令包括 `teams`、`projects`、`issues`、`issue`、`states`、`labels`、`user`，以及 `createProject`、`createIssue`、`updateIssue`、`createComment`。每次写入后会返回受影响的 ID、状态、负责人和后续动作，便于核对结果。

什么时候用它

  • 把高优先级 bug 转交负责人并推进到 In Progress，附上分诊评论
  • 梳理 sprint cycle 范围，补齐缺失的 issue 并设置优先级和经办人
  • 发布前核对阻塞项，更新项目状态，补齐里程碑任务和上线评论
  • 整理过期文档和 issue，开出后续跟进任务并关联相关记录

技能文档

Linear Workflow Management

Manage Linear issues and projects through the bundled CLI at {baseDir}/scripts/linear-cli.js.

Scope and Runtime Model

  • This skill runs node {baseDir}/scripts/linear-cli.js ....
  • The CLI uses the official @linear/sdk.
  • Authentication is LINEAR_API_KEY from the local environment.
  • Expected API destination is Linear GraphQL (https://api.linear.app/graphql) through the official SDK.

Prerequisites

  1. Node.js and npm are installed.
  2. Install script dependencies once:
    • cd {baseDir}/scripts && npm install
  3. Set your API key:
    • export LINEAR_API_KEY="lin_api_..."

If dependencies or LINEAR_API_KEY are missing, stop and complete setup before issue/project operations.

Authentication and Credentials

  • Required credential: LINEAR_API_KEY.
  • Get it from https://linear.app/settings/api.
  • Use least-privilege access and a dedicated token for automation.

Required Workflow

  1. Clarify intent and scope:
    • Team/project, labels, cycle, assignee, due date, priority.
  2. Read current state first:
    • List/get issues, projects, statuses, labels, users, cycles.
  3. Apply mutations second:
    • Create/update issues, comments, projects, milestones, labels.
  4. Summarize exactly what changed:
    • Mention IDs, states, assignees, blockers, and follow-up actions.

Command Coverage

  • Teams and projects: teams, projects, createProject
  • Issues: issues, issue, createIssue, updateIssue
  • Comments: createComment
  • States and labels: states, labels
  • User: user

Quick Examples

node {baseDir}/scripts/linear-cli.js teams
node {baseDir}/scripts/linear-cli.js projects
node {baseDir}/scripts/linear-cli.js issues
node {baseDir}/scripts/linear-cli.js issue ENG-123
node {baseDir}/scripts/linear-cli.js createIssue "Title" "Description" "team-id" '{"priority":2}'
node {baseDir}/scripts/linear-cli.js updateIssue "issue-id" '{"stateId":"state-id"}'

Practical Workflows

  • Triage urgent bugs: list high-priority open issues, assign owners, move state to In Progress, add triage comments.
  • Sprint planning: review cycle scope, create missing issues, set priorities and estimates, align assignees.
  • Release prep: verify blockers, update project status, create milestone tasks, add rollout comments.
  • Documentation cleanup: find stale docs/issues, open follow-up tasks, link related records.

Safety and Operational Rules

  • Never invent IDs; fetch and confirm before updates.
  • Prefer narrow updates over broad bulk edits.
  • For bulk edits, explain grouping logic before applying changes.
  • Do not include secrets in issue comments or descriptions.
  • Do not send data to endpoints outside Linear API scope for this skill.

References

  • references/API.md for priority values and workflow patterns.

相关技能

Linear

通过托管的 OAuth GraphQL 接口查询与管理 Linear 的 issue、项目、团队、周期、标签和评论。

作者 byungkyu517 次安装18 星标

Projects

把项目从最初的想法一路跟到归档，每周复盘把停滞的挑出来。

82 次安装5 星标

LinkedIn

通过托管 OAuth 调用 LinkedIn REST API，覆盖发文、个人资料、广告账户与广告库。

410 次安装45 星标

Asana

通过托管 OAuth 代理对接 Asana API，统一处理任务、项目、空间、用户与 Webhook。

601 次安装6 星标

Google Tasks

通过托管 OAuth 连接 Google Tasks，统一 API 完成任务列表与任务的读写管理。

252 次安装10 星标

Jira

通过托管 OAuth 调用 Jira Cloud API，搜索并管理工单。

作者 byungkyu241 次安装7 星标