Linear

管理问题、检查项目状态，并随时掌握团队工作进展。

设置

export LINEAR_API_KEY="你的-api-密钥"
# 可选：当命令需要团队时使用的默认团队键
export LINEAR_DEFAULT_TEAM="团队键"

发现团队键：

{baseDir}/scripts/linear.sh teams

如果LINEAR_DEFAULT_TEAM已设置，你可以在team参数中省略团队键，并调用：

{baseDir}/scripts/linear.sh create "标题" ["描述"]

快速命令

# 我的事项
{baseDir}/scripts/linear.sh my-issues          # 你被分配的问题
{baseDir}/scripts/linear.sh my-todos           # 仅你的待办事项
{baseDir}/scripts/linear.sh urgent             # 团队内紧急/高优先级事项

# 浏览
{baseDir}/scripts/linear.sh teams              # 列出可用团队
{baseDir}/scripts/linear.sh team <TEAM_KEY>    # 某团队的所有问题
{baseDir}/scripts/linear.sh project <名称>     # 项目中的问题
{baseDir}/scripts/linear.sh issue <TEAM-123>   # 获取问题详情
{baseDir}/scripts/linear.sh branch <TEAM-123>  # 获取 GitHub 分支名称

# 操作
{baseDir}/scripts/linear.sh create <TEAM_KEY> "标题" ["描述"]
{baseDir}/scripts/linear.sh comment <TEAM-123> "评论内容"
{baseDir}/scripts/linear.sh status <TEAM-123> <待办|进行中|审核中|已完成|已阻塞>
{baseDir}/scripts/linear.sh assign <TEAM-123> <用户名>
{baseDir}/scripts/linear.sh priority <TEAM-123> <紧急|高|中|低|无>

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

常用工作流

晨间站会

{baseDir}/scripts/linear.sh standup

显示内容：你的待办事项、团队内被阻塞的事项、最近完成的事项、正在审核中的事项。

快速创建问题（来自聊天）

{baseDir}/scripts/linear.sh create TEAM "修复认证超时错误" "用户5分钟后被登出"

分类模式

{baseDir}/scripts/linear.sh urgent    # 查看需要关注的事项

Git 工作流（Linear ↔ GitHub 集成）

始终使用 Linear 派生的分支名称以实现自动问题状态跟踪。

获取分支名称

{baseDir}/scripts/linear.sh branch TEAM-212
# 返回：dev/team-212-fix-auth-timeout-bug

为问题创建工作树

# 1. 从 Linear 获取分支名称
BRANCH=$({baseDir}/scripts/linear.sh branch TEAM-212)

# 2. 首先拉取最新的 main 分支（main 应始终与 origin 保持一致）
cd /path/to/repo
git checkout main && git pull origin main

# 3. 使用该分支创建工作树（从最新的 origin/main 分支出来）
git worktree add .worktrees/team-212 -b "$BRANCH" origin/main
cd .worktrees/team-212

# 4. 进行工作、提交、推送
git push -u origin "$BRANCH"

⚠️ 切勿在 main 分支上修改文件。所有更改仅在工作树中进行。

为何这很重要

• Linear 的 GitHub 集成通过分支名称模式跟踪 PR
• 当你从 Linear 分支创建 PR 时，问题会自动移至"评审中"
• 当 PR 合并时，问题会自动移至"已完成"
• 手动分支名称会破坏这种自动化
• 保持主分支的清洁 = 无意外推送，易于清理工作树

快速参考

# 完整工作流示例
ISSUE="TEAM-212"
BRANCH=$({baseDir}/scripts/linear.sh branch $ISSUE)

# 始终从干净的主分支开始
cd ~/workspace/your-repo
git checkout main && git pull origin main

# 创建工作树 (在 .worktrees/ 目录内)
git worktree add .worktrees/${ISSUE,,} -b "$BRANCH" origin/main
cd .worktrees/${ISSUE,,}

# ... 进行修改 ...
git add -A && git commit -m "fix: implement $ISSUE"
git push -u origin "$BRANCH"
gh pr create --title "$ISSUE: <标题>" --body "关闭 $ISSUE"

优先级级别

团队 (已缓存)

团队密钥和ID通过API发现，并在首次查找后本地缓存。 使用linear.sh teams来刷新并列出可用团队。

备注

• 使用GraphQL API (api.linear.app/graphql)
• 需要LINEAR_API_KEY环境变量
• 问题标识符格式如TEAM-123

归属

灵感来源于schpet/linear-cli由Peter Schilling开发 (ISC许可证)。 这是一个为Clawdbot集成而独立实现的bash版本。