codex可通过linear专用skill自动解析pr变更并生成结构化issue。需先创建项目工作区、配置linear_api_key和team_id，再安装issue-sync skill，最后用/skill指令触发，ai将语义解析代码变更、打标签、关联epic并提交至linear看板。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Codex自动解析代码变更、生成结构化日志、并同步到Linear项目看板，避免人工整理遗漏关键信息、重复贴错Issue、Release Note与实际代码脱节。
准备Codex项目环境与Linear认证
在本地新建一个空文件夹作为Codex项目工作区，例如linear-integration，然后用Codex桌面端或CLI绑定该目录。这一步必须做，否则Codex无法读取AGENTS.md和调用本地Skill。
在项目根目录创建.env.local文件，写入两行内容：LINEAR_API_KEY=lin_api_xxxLINEAR_TEAM_ID=team_xxx。【LINEAR_API_KEY必须是Personal API Key，不能是OAuth Token；权限需勾选“Issues: Read & Write”】
执行codex --version确认CLI可用，再运行codex启动会话，让它自动读取.env.local并验证Linear连接——若提示“Failed to fetch teams”，说明API Key无效或权限不足，需重新生成。
安装并配置Linear专用Skill
方法一：使用skillstore一键安装（推荐）
在终端中执行：npx skillstore add codex-linear/issue-sync。该命令会将Skill解压至~/.codex/skills/issue-sync/，并自动校验SKILL.md完整性。
方法二：手动克隆（适合审计需求）
进入用户技能目录：cd ~/.codex/skills→克隆仓库：git clone https://github.com/codex-linear/issue-sync.git temp && mv temp/issue-sync ./issue-sync && rm -rf temp。【克隆后必须检查SKILL.md是否直接位于issue-sync/一级目录，否则Codex完全无法识别】
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
安装完成后，在项目根目录创建AGENTS.md，写入以下内容：# Linear集成项目<br>## 目标<br>所有PR合并后，自动生成带上下文的Linear Issue，关联Epic、打标签、设置优先级。<br>## 约束条件<br>- 仅处理GitHub仓库中label为"release"的PR<br>- Issue标题格式：[CHG] {服务名} - {变更摘要}<br>- 自动填充字段：status=Todo, priority=Medium
触发Skill完成PR→Linear Issue全流程
第一步：确保当前Git分支已推送PR且被合并。Codex不监听Webhook，只响应你明确发起的指令。
第二步：在Codex对话框中输入指令：/skill issue-sync --pr-url https://github.com/your-org/your-repo/pull/123。Codex会立即拉取该PR的diff、title、description和关联的Jira ID（如有）。
第三步：AI自动解析变更语义——识别出ALTER TABLE语句则标记为【数据库】，检测到@Cacheable注解变更则归类为【缓存】，匹配src/api/路径则打上backend标签。这一步不可跳过，人工分类极易漏掉跨服务影响。
第四步：生成Linear Issue并提交。Codex调用Linear GraphQL API，传入结构化payload，返回新Issue的URL。此时可在Linear看板中看到标题为[CHG] auth-service - 新增用户登录风控拦截逻辑的卡片，状态为Todo，已关联对应Epic，底部附带原始PR链接和diff摘要。
