linear-autopilot

🤖 Linear 任务自动化与 Git 同步

基于 Linear API 的开源自动化工具,通过 Discord 触发实现任务自动处理、状态同步与 Git 归档,构建 Kanban-to-Agent 智能工作流。

收藏
5.1k
安装
2k
版本
v1.0.2
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

Linear Autopilot 是一款开源的自动化工作流工具,旨在搭建从 Linear 项目管理到 Discord 通知再到 Git 归档的完整自动化管道。其核心用法围绕 "Linear → Webhook Service → Discord → Clawdbot → Git" 的链路展开,用户需配置 Linear API 密钥、选择 Make.com(推荐)、Pipedream 或 Zapier 作为 Webhook 中介,并设置 Discord 频道监听与 Git 自动推送。当 Linear 中创建新任务时,系统通过 Webhook 触发 Discord 消息,Clawdbot 接收后自动更新任务状态、执行具体任务(如研究、内容创作或代码编写),最终将成果提交至 Git 仓库。

该技能的显著优点在于其多平台兼容性与免费友好性。特别推荐使用 Make.com 的免费套餐(每月 1,000 次操作),相比 Zapier 免费版不支持 Webhook、Pipedream 免费额度消耗快的限制,Make.com 更适合个人及小团队长期使用。同时,它支持任意任务类型,从学术研究到代码开发均可通过配置不同的输出目录(research/、content/ 等)实现结构化归档。此外,所有敏感配置均存储在本地 ~/.clawdbot/ 目录,避免了凭证泄露风险。

然而,该方案也存在一定局限性。首先,作者为个人开发者(T3 来源),虽代码已通过安全审计,但企业环境仍需谨慎评估。其次,系统依赖多个外部服务(Linear、Discord、自动化平台)的稳定性,任一服务中断都会影响工作流。配置过程涉及多个步骤(API 密钥、团队 ID、状态 ID、Discord 频道配置),对非技术用户门槛较高。免费 tier 的操作次数限制(如 Make.com 的 15 分钟间隔)也可能影响实时性要求高的场景。

该技能最适合已使用 Linear 进行项目管理、希望通过 Discord 接收实时通知、并需要将工作成果自动同步到 Git/Obsidian 的个人开发者或小型团队。特别适合构建"看板驱动开发"(Kanban-driven development)流程,实现从任务创建到代码提交的全链路自动化。

使用风险主要包括:API 密钥的本地存储需确保文件权限安全(建议 600);依赖第三方服务的持续可用性与 API 变更;网络延迟或中断可能导致任务状态同步失败;以及免费套餐的操作额度耗尽导致自动化中断。建议定期监控各平台的使用额度,并在关键业务流程中设置备用方案。

安全解读

核心用法

Linear Autopilot 是一套将 Linear 看板与 AI Agent 深度集成的自动化工作流。其核心架构为:Linear → Webhook 服务 → Discord → Clawdbot → Git。当用户在 Linear 中创建或更新任务时,自动化服务(Make.com/Pipedream/Zapier)捕获 Webhook 事件并推送至 Discord 频道,Clawdbot 接收消息后自动启动任务处理。

具体流程包括:任务到达后 Bot 确认接收、向用户发送 DM 通知、更新 Linear 状态为「进行中」、执行实际任务(可派生子代理处理复杂需求)、完成后更新状态为「已完成」并添加结果评论,最后若开启 Git 同步则自动提交至仓库。脚本工具 linear-api.sh 提供完整的 CLI 接口,支持查询团队/状态、获取任务详情、状态流转等操作。

显著优点

1. 零代码工作流编排:无需编写复杂代码,通过 Make.com 或 Pipedream 的可视化界面即可完成触发器-动作链路的搭建,门槛极低。

2. 免费 tier 友好:Make.com 提供 1,000 次操作/月的免费额度,Linear 免费版支持 250 个 Issue,足以支撑个人创作者或小型团队日常使用。

3. 全链路状态可视化:任务在 Linear、Discord、Git 三个系统间保持状态同步,用户可在任一节点追踪进度,避免信息孤岛。

4. 高度可扩展:支持研究、内容创作、代码任务、数据处理等多种任务类型,输出目录结构可自定义(research/、content/ 等),适配不同知识管理范式。

5. 纯 Bash 零依赖:核心脚本无第三方依赖,仅依赖系统标准工具(curl、jq),部署和维护成本极低。

潜在局限

1. 实时性受限:Make.com 免费版最低 15 分钟轮询间隔,非即时触发;Pipedream 虽支持即时 Webhook 但免费额度消耗快。

2. Zapier 付费门槛:若团队已用 Zapier,需注意其免费版不支持 Webhook,必须升级至 Starter 计划才能运行此工作流。

3. 配置复杂度:需分别获取 Linear API Key、Team ID、State ID、Discord Channel ID 等多项参数,初次 setup 步骤较多,对非技术用户有学习曲线。

4. 单点故障风险:整个链路依赖 Linear → Webhook 服务 → Discord 三个外部服务的可用性,任一环节故障将导致自动化中断。

适合人群

  • 个人知识工作者:希望将 Linear 作为「外部大脑」入口,自动触发 AI 处理并归档至 Obsidian/Git 仓库的创作者。
  • 小型敏捷团队(2-5 人):需要轻量级任务分发机制,让 Bot 承担重复性研究、文档生成、代码审查等工作的技术团队。
  • 自动化爱好者:已在用 Make/Pipedream 搭建工作流,希望将 AI Agent 无缝接入现有工具链的进阶用户。

常规风险

配置安全风险:Skill 指导用户将 API Key 存储于本地 ~/.clawdbot/linear.env,若设备共享或多用户环境未设置 chmod 600 权限,可能导致凭证泄露。建议严格遵循安全报告中的权限加固建议。

Webhook 泄露风险:Discord Webhook URL 若被误提交至 Git 仓库或公开分享,可能被恶意利用发送垃圾消息,需妥善保管。

API 限流风险:Linear API 存在速率限制,高频任务场景下可能触发限流导致状态同步延迟。

Git 自动提交风险:开启 autoPush 后,Bot 自动提交代码需确保输出目录有 .gitignore 防护,避免敏感文件误入库。

linear-autopilot 内容

references文件夹
scripts文件夹
手动下载zip · 9.6 kB
make-setup.mdtext/markdown
请选择文件