Linear Project Management

概述

Linear Project Management 即 wrsmith108/linear-claude-skill，一个 MIT 许可的 Claude Code Skill，用于管理 Linear 的 issue、项目和团队。它分三层访问：简单操作走官方 Linear MCP 服务器，多步骤自动化走 TypeScript SDK 脚本，其余情况直接调用 GraphQL。SKILL.md 告诉 Claude 该走哪条路径，api.md、sdk.md、sync.md、projects.md 等参考文件只在需要时加载。

核心功能

• 高层操作：通过 npm run ops 创建 Initiative 和项目、创建子任务、设置父子关系、批量更新 issue 状态。
• 先查重再创建：创建前先检索已有项目和 issue，避免重复。
• 标签体系：按领域划分的标签，用于统一归类和 Agent 路由（见 docs/labels.md）。
• 批量同步：通过 CLI、Agent 或 hooks 把代码变更同步到 Linear。
• 图片上传：上传到 Linear 存储并附加到 issue。
• 配置检查：npm run setup 会明确指出缺少哪些配置。
• 可选使用 Rust 编写的 lin CLI 加速，失败时自动回退到 SDK。

快速上手

git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
cd ~/.claude/skills/linear && npm install
npm run setup
export LINEAR_API_KEY="lin_api_..."   # Linear > Settings > Security & access > Personal API keys
npm run ops -- whoami
npm run ops -- create-sub-issue ENG-100 "Add tests" "Unit tests for feature"
npm run ops -- status Done ENG-123 ENG-124

npm run build 用 esbuild 预编译脚本以加快冷启动；不构建也能通过 tsx 运行。README 推荐使用 mcp.linear.app 的官方 MCP 服务器，并提醒不要使用已废弃的社区版 Linear MCP。

适用场景

• 把和 Claude 一起写好的计划落成 Linear 的 Initiative、项目与子任务。
• 合并后一次性关闭或流转多个 issue。
• 让 Linear 与实际发布的内容保持同步。

局限

• 需要 Linear 账号以及能访问工作区的个人 API Key。
• 依赖 Node.js；lin CLI 和 MCP 服务器需另行安装。

常见问题

必须配置 Linear MCP 服务器吗？

推荐用于简单操作，但仅有 LINEAR_API_KEY 时 SDK 脚本和 GraphQL 也能工作。

如何查看全部命令？

运行 npm run ops -- help。

替代方案

• 团队用飞书/Lark 管理任务时可看 Lark CLI。
• Planning with Files：把计划以 Markdown 保存在仓库中，而不是放进任务系统。
• Zapier：无代码连接 Linear 与其他应用。

更多内容见 Skills 分类 与 项目管理标签。