Linear任务管理

技能简介

连接Linear项目管理平台，支持查询事务状态、创建任务、更新优先级、分配负责人等操作。可与GitHub分支命名联动，实现代码提交与事务状态的自动同步。

业务背景

Linear任务管理工具打通项目管理与代码开发的协作链路。团队可在终端直接查询事务进度、创建任务并分配责任人，减少在多个系统间切换的操作成本。GitHub分支命名联动机制确保代码提交自动触发事务状态更新，避免人工同步的遗漏和延迟。

落地案例：后端工程师开始新功能开发时，先执行命令查询个人待办，确认TEAM-456为当前最高优先级事务。随后调用指令创建符合Linear命名规则的分支feature/TEAM-456-user-auth，推送首笔提交后系统自动将该事务状态从"待办"转为"进行中"。开发完成后更新状态为"审核中"并@前端负责人联调，全程状态流转无需手动维护。

能做什么

• 查询个人待办、团队事务、项目进度
• 创建新事务并设置标题、描述、优先级
• 更新事务状态（待办/进行中/审核中/已完成/阻塞）
• 分配负责人、添加评论
• 生成符合Linear规范的Git分支名称
• 输出每日站会摘要

使用说明

安装与配置

1. 获取Linear API密钥：访问 Linear.app → Settings → API → Personal API keys
2. 设置环境变量：

   export LINEAR_API_KEY="your-api-key"
   # 可选：设置默认团队
   export LINEAR_DEFAULT_TEAM="TEAM"

3. 查看可用团队：

   {baseDir}/scripts/linear.sh teams

常用命令

# 个人事务
{baseDir}/scripts/linear.sh my-issues    # 分配给你的事务
{baseDir}/scripts/linear.sh my-todos     # 待办项
{baseDir}/scripts/linear.sh urgent       # 紧急/高优先级事务

# 浏览查询
{baseDir}/scripts/linear.sh team <TEAM_KEY>      # 团队全部事务
{baseDir}/scripts/linear.sh project <name>       # 项目内事务
{baseDir}/scripts/linear.sh issue <TEAM-123>     # 单条事务详情
{baseDir}/scripts/linear.sh branch <TEAM-123>    # 获取Git分支名

# 操作事务
{baseDir}/scripts/linear.sh create <TEAM_KEY> "标题" ["描述"]
{baseDir}/scripts/linear.sh status <TEAM-123> <todo|progress|review|done|blocked>
{baseDir}/scripts/linear.sh assign <TEAM-123> <用户名>
{baseDir}/scripts/linear.sh priority <TEAM-123> <urgent|high|medium|low|none>

# 概览
{baseDir}/scripts/linear.sh standup        # 站会摘要
{baseDir}/scripts/linear.sh projects       # 所有项目进度

Git工作流配合

使用Linear生成的分支名可触发自动状态流转：

# 获取分支名
BRANCH=$({baseDir}/scripts/linear.sh branch TEAM-212)
# 返回示例：dev/team-212-fix-auth-timeout-bug

# 基于最新main创建工作区
git checkout main && git pull origin main
git worktree add .worktrees/team-212 -b "$BRANCH" origin/main

从此分支发起PR后，关联事务自动移至”审核中”；合并后自动标记”已完成”。

输入与输出

见下方输入与输出表格。

风险提示

• API密钥需妥善保管，避免泄露在日志或代码仓库中
• 修改事务状态前请确认当前责任人，防止覆盖他人进度
• 手动创建的Git分支若不符合Linear命名规则，将无法触发自动状态同步
• 删除或归档操作不可逆，执行前建议先备份关键数据

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/manuelhettich/linear/SKILL.md
来源类型：开源社区技能