Linear评论驱动AI任务自动路由

Clawdbot生态的Linear集成工具，通过@mention将评论自动路由至代码或策略代理，实现项目管理与AI协作的无缝衔接。

基本信息

• 技能名称?linear-webhook
• 中文名称?Linear评论驱动AI任务自动路由
• 作者?Arnarsson
• 分类?开发
• 版本?v1.0.0
• 标签?automation, project-program-management, api, backend, development-engineering, product-management

使用方法

使用说明
核心用法
Linear Webhook Skill 是 Clawdbot 生态系统的桥接组件，实现 Linear 项目管理平台与 AI 代理的双向通信。用户在 Linear Issue 中通过 @mason 或 @eureka 提及触发任务分派：Linear 的 Webhook 将评论事件推送至 Clawdbot 暴露的端点，经 linear-transform.js 解析后，提取 Issue 上下文（标题、描述、标签）和 @mention 指令，路由至对应代理会话—— @mason 负责代码实现与技术任务，， @eureka 处理规划策略与研究沟通。代理处理完成后，结果通过 Linear GraphQL API 回写为评论，形成闭环工作流。
显著优点
深度集成体验 ：无需离开 Linear 即可完成 AI 任务分派，保持团队现有工作流不变。支持 Cloudflare Tunnel 或 Tailscale Funnel 快速暴露端点，配置灵活。
上下文感知 ：代理接收完整的 Issue 元数据（标题、描述、标签、评论者、URL），减少信息传递损耗，提升任务理解准确度。
可扩展架构 ：通过修改 AGENT_MENTIONS 映射即可添加新代理角色，支持自定义响应渠道（如同时推送至 Telegram）。
文档完备 ：提供从配置到故障排查的全流程指南，包含安全最佳实践（Token 环境变量化、HTTPS 强制）。
潜在缺点与局限性
部署复杂度 ：需自行维护隧道服务（Cloudflare/Tailscale）和公网可达端点，对非技术用户门槛较高。Webhook 可靠性依赖外部网络稳定性。
功能边界 ：仅处理 Comment → Created 事件，不支持 Issue 状态变更、标签修改等其他触发条件。回写评论需额外配置 Linear API 密钥，非开箱即用。
平台锁定 ：深度绑定 Clawdbot 生态和 Linear，迁移成本较高。硬编码路径（如 /home/sven/... ）在示例中残留，实际部署需手动调整。
适合的目标群体
技术驱动型团队 ：已使用 Linear 进行项目管理，且具备 CLI 工具配置能力的开发团队。
Clawdbot 现有用户 ：希望扩展代理触达场景，将 AI 能力嵌入日常项目管理工具的用户。
自动化爱好者 ：追求"评论即指令"的极致效率，愿意投入初期配置成本换取长期工作流优化。
使用风险
性能风险 ：Webhook 处理为同步链路，若代理响应超时或 Linear API 限流，可能导致评论回写失败。无内置重试机制。
依赖风险 ：强依赖 Clawdbot CLI 的 sessions history 命令获取代理输出，若 CLI 版本变更或会话清理策略调整，可能破坏数据流。
运维风险 ：隧道服务中断会导致 Webhook 投递失败，需监控告警。Token 泄露将导致未授权代理调用，建议定期轮换。