用途:该技能用于在 Linear 中构建、注册和运行智能体,涉及智能体会话、活动、委派、Agent Skills、Loops 和编码会话。
主要能力与语义:智能体是以应用用户身份安装到工作区的 OAuth 应用,可被 @提及、被委派议题,也能评论议题、项目和文档。将议题分配给智能体是委派而非重新分配,人类负责人仍是所有者并承担责任;智能体不是计费席位,不能登录、访问管理功能或管理用户。工作通过会话汇报,会话保存有序活动列表。会话状态:pending、active、error、awaitingInput、complete、stale。活动类型:thought(内部推理,折叠显示,非终止)、action(运行工具或命令,非终止)、elicitation(向用户提问,会话转为 awaitingInput,非终止)、response(成功完成,终止)、error(失败,终止)。
用法与限制:会话创建后 10 秒内必须发出活动,否则被标记 stale;慢速准备工作前先发 thought。Webhook 接收器须在 5 秒内返回 2xx,先确认再异步工作。资料建议使用 lib/agent-session.mjs 统一处理,其 guard(work) 包裹工作单元以确保会话总会终止,即使 worker 崩溃也会发出 error 而非让议题永久停留在 active。工作区和团队可发布 markdown 指引并传递给在此工作的每个智能体,团队设置优先;行动前须阅读并遵循。用户可将良好交互保存为技能,通过斜杠命令调用或按上下文自动选择,可用 Linear MCP 工具 list_agent_skills / get_agent_skill 枚举,团队可能已有既定技能。Loops 是按计划或事件运行的共享技能,工作完全在 Linear 内时优先于外部 cron。编码会话由 Linear 自行运行,委派议题会在受管理沙箱中于 Claude Code 或 Codex 启动安全会话,起草 PR 并把差异附加到议题;模型包括 Claude Fable 5、Claude Opus 5、Claude Sonnet 5、GPT-5.6 Sol;编码环境在工作区设置中配置运行时、环境变量、prepare 脚本、文件和仓库指引,每环境一个仓库;分诊自动化可在议题到达时按标签等过滤启动编码会话;用量消耗工作区 AI 积分,需要具有代码访问权限的 GitHub 集成。选择编码会话还是本插件 swarm:单议题 GitHub 仓库且不想维护本地基础设施时用 Linear 编码会话;多议题并行、需要自有 runner 缓存或网络、或使用非 GitHub 托管时用 /linear:swarm。资料还指出 1.0.0 版描述的 API 并不存在,并给出对照:不存在 AIG 网关与 agentSignalCreate,正确做法是使用 agentActivityCreate 载明类型内容,作用域为 app:assignable、app:mentionable,使用 lib/agent-session.mjs,鉴权采用 actor=app 的 OAuth。编写可执行议题时应指明文件或子系统、预期行为变化、可复用的既有模式,以及明确不可更改的内容;模糊议题会浪费积分。