1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | linear-openai-plugins |
| 项目自述名称 | linear（.codex-plugin/plugin.json 内 interface.displayName 原值为 “Linear”） |
| 作者/维护者 | OpenAI 官方编写（plugin.json 声明 author.name = “OpenAI”），托管发布于 OpenAI 官方仓库 openai/plugins，homepage/websiteURL 指向 Linear 官网 |
| 来源链接 | https://github.com/openai/plugins/tree/main/plugins/linear |
| 许可证 | plugin.json 声明 MIT；技能目录内另附 LICENSE.txt 为 Apache 2.0——两者均为宽松开源协议，未见冲突性条款 |
| GitHub Stars/Forks | 所属合集仓库（openai/plugins）4,612 / 671（GitHub API 实测 2026-07-16；仓库为 190+ 插件合集，注：该数字属整个合集仓库，不代表本插件自身热度，独立佐证见第 6 章） |
| 最新版本 | plugin.json 声明 0.0.3；该子目录提交历史 API 实测最近一次提交 2026-06-22（距运行当天约 3 周） |
| 安装方式 | Codex 内执行 $skill-installer linear，或在 Connected Apps/插件目录中搜索并启用 “Linear”（需 OAuth 连接工作区） |
2. 功能介绍与亮点
linear-openai-plugins 是 OpenAI 官方为 Codex 编写的单文件 SKILL.md 技能，把 Linear 的 issue、项目、团队协作能力打包成结构化工作流：
- 四步执行流程：Step 0 确认 Linear App 已通过 OAuth 连接 → Step 1 澄清用户目标与范围（团队/项目/优先级/标签/周期）→ Step 2 选择合适的工作流并确认所需标识符 → Step 3 分批执行工具调用（先读后写，批量操作前先解释分组逻辑）→ Step 4 汇总结果并提出后续行动建议
- 18 个封装工具：覆盖 Issue 管理（
list_issues/create_issue/update_issue等）、项目与团队（list_projects/create_project/list_teams等）、文档协作（list_documents/search_documentation/create_comment等） - 9 套“实战工作流”模板：Sprint 规划、Bug 分诊、文档审计、团队工作量均衡、发布计划、跨项目依赖排查、自动化状态更新、智能打标签、Sprint 复盘——覆盖 Linear 日常使用中最高频的场景
- 内置故障排查章节：针对鉴权失败、工具调用错误、数据缺失、性能限流分别给出排查步骤
亮点：全程通过平台托管的 Linear OAuth 连接器完成读写，不依赖任何本地 shell 命令或脚本；官方 Codex 插件文档确认该技能已进入内置的 Codex Plugin Directory（非仅托管在仓库里的示例代码）。
3. 适用场景
固定分类：集成与工作流自动化。适合用 Linear 管理研发任务的初中级开发者与小团队——想让 Agent 直接读写 issue、项目与文档，而不用来回切换到 Linear 网页端；典型场景包括让 Codex 自动做 Bug 分诊排优先级、生成 Sprint 复盘报告、或在完成一段代码改动后自动创建/更新对应的 Linear issue。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持——
.codex-plugin/plugin.json为标准 Codex 插件清单，托管于 OpenAI 官方插件仓库；官方文档（learn.chatgpt.com/docs/plugins，已抓取核实）确认该插件已列入内置 Codex Plugin Directory，可通过$skill-installer linear或插件目录 UI 一键启用 - Claude Code：⚠️ 需适配——SKILL.md 本身的 YAML frontmatter + Markdown 指令格式与 Claude Skill 约定接近，可直接复用为提示词模板，但“读写 Linear”这部分绑定 Codex 专属的 App 连接器（
.app.json/.mcp.json），需自行配置等效的 Linear MCP 连接方案才能复现工具可用性 - OpenClaw：❓ 未验证——抓取材料未提及
- Hermes Agent：❓ 未验证——抓取材料未提及
（以上判断仅基于已抓取材料。）
5. 推荐理由
Linear 是初中级开发团队里最常见的问题追踪工具之一，但“翻 issue 列表、判断优先级、手动创建关联任务”这类操作琐碎且容易打断编码心流。这个技能由 OpenAI 官方编写并收录进 Codex 内置插件目录，用一份结构清晰的 SKILL.md 把“确认连接→澄清目标→选择工作流→分批读写→汇总结果”串成完整闭环，还附带 9 套贴近真实研发场景的工作流模板；全程只通过平台托管的 OAuth 连接器读写数据，不需要用户管理任何 API Key 或本地脚本权限,对安全敏感场景更友好。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7.0 | OpenAI 官方出品（plugin.json 声明 author=OpenAI）且已列入官方 Codex Plugin Directory（learn.chatgpt.com 文档已抓取核实）；合集仓库 4,612 星属整个仓库、不代表本插件自身热度；但该插件版本号仍为 0.0.3，公开渠道未见针对该插件本身的独立第三方评测或讨论，故不评更高分 |
| 可用性 | 8.0 | $skill-installer linear 一条命令安装，或插件目录 UI 一键启用；SKILL.md 结构完整（前置条件/分步流程/工具清单/实战模板/排障指南一应俱全）；该子目录最近一次提交 2026-06-22（运行当天约 3 周前），3 个月窗口内活跃；无需用户自行申请 API Key，唯一门槛是 OAuth 连接 Linear 工作区 |
| 安全性 | 9.0 | 见下方安全检查清单 |
| 综合 | 8.0 | 三项均值，超过 7.0 达标线，安全性远超一票否决线 |
安全检查清单：
- Shell/权限范围：无任何本地 shell 命令或脚本执行——全部工具调用均为平台托管的 Linear 连接器工具（
list_issues、create_issue等） - 联网外发：数据流经 OAuth 连接的 Linear 官方 API，
plugin.json明确链接 Linear 官方隐私政策（linear.app/privacy）与服务条款，数据处理遵循 Linear 自身合规声明 - API Key/凭据：完全通过 Codex 平台统一管理的 OAuth 连接器，用户无需保存任何 Linear API Token
- 可疑指令/注入迹象：完整抓取 SKILL.md 全文核实，未发现要求执行流程外操作或数据外发的可疑指令
- 作者/组织信誉：OpenAI 官方编写并维护，托管于官方仓库
- License：
plugin.json声明 MIT，附带LICENSE.txt为 Apache 2.0，均为清晰的宽松开源协议 - 维护时间：该子目录最近提交 2026-06-22（运行前约 3 周），活跃维护中
7. 跟同类 Skills 相比的优势
第三方 SaaS 集成类的其他官方技能与本插件的定位差异：
| 产品 | 定位 | 核心差异 |
|---|---|---|
| linear-openai-plugins（本推荐） | Linear issue/项目/文档一体化工作流，9 套实战模板 | 唯一纯 OAuth 连接器、零本地 shell 依赖，且已进入 Codex 官方插件目录的问题追踪类技能 |
| hubspot-openai-plugins | 分析与管理 HubSpot CRM 数据 | 面向销售/市场运营场景，目标用户群与初中级开发者重叠度较低 |
Airtable 官方技能（airtable/skills） |
无代码数据库读写、筛选、建表 | 官方独立仓库但仅 37 星，独立验证证据比 Linear 弱 |
Twilio Developer Kit（twilio/ai） |
短信/语音/合规等 10+ 专项技能 | 通信 API 场景更专精，且需要用户自行管理 Account SID/Auth Token，配置门槛高于纯 OAuth 方案 |
Shopify AI Toolkit（Shopify/Shopify-AI-Toolkit） |
电商开发全家桶，含 18 个子技能 | 官方仓库 454 星、维护活跃，但技能高度碎片化难以定位单一入口，且脚本默认向 shopify.dev 回传遥测数据 |
8. 用户评价
该插件目前在第三方平台尚无具名用户评价或社区讨论——插件版本仍处早期（v0.0.3），公开渠道可查到的信息仅为其“已列入 Codex 内置插件目录”这一事实。可参考的客观信号是第一章列出的官方出品与插件目录收录记录。
9. 其他补充
openai/plugins 仓库同时收录 190+ 个插件，Linear 与 Notion、Figma、Slack、GitHub 等技能同属该仓库内“官方一线出品”分组；仓库最近一次提交发生于 2026-07-14（GitHub API 实测），整体维护活跃。
10. 安装使用方式
- 前置条件：可用的 ChatGPT/Codex 账号，且需完成 Linear 工作区 OAuth 授权
- 在 Codex 内执行
$skill-installer linear，或在插件目录 UI 中搜索并启用 “Linear” - 首次使用时按 SKILL.md Step 0 提示完成 Linear App 连接授权；若工具仍不可用，重启 Codex 或当前会话
- 直接向 Agent 提出 Linear 相关意图，如 “triage my high priority bugs”、“create a v2.0 release project with milestones”、“summarize last sprint’s cycle”
- 授权后 Agent 会根据意图自动路由到对应的实战工作流（Sprint 规划/Bug 分诊/文档审计等）
11. 注意事项
- 仅验证 Codex 生态原生支持，OpenClaw、Hermes Agent 未见官方支持声明；Claude Code 需自行配置等效 Linear MCP 连接方案后复用
- 插件版本号仍为 0.0.3，属早期迭代阶段，功能边界可能随版本变化调整
- 批量操作（如跨多个 issue 打标签、批量创建）建议按 SKILL.md 提示分批执行，避免触发 Linear API 限流
- 该技能要求用户拥有 Linear 工作区的相应读写权限，管理员可能需要审批 OAuth 连接请求