用途
该技能为在 Linear 中管理问题、项目和团队工作流提供结构化流程，确保与 Linear MCP 服务器保持一致集成。Linear MCP 服务器为问题、项目、文档和团队协作提供自然语言的项目管理能力。当用户希望读取、创建或更新 Linear 中的工单时，可使用本技能。
前置条件
- 必须已连接 Linear MCP 服务器，并可通过 OAuth 访问。
- 确认可访问相关的 Linear 工作区、团队和项目。
必需工作流
按顺序执行以下步骤，不要跳过。
步骤 0：设置 Linear MCP（如果尚未配置）
如果任何 MCP 调用因 Linear MCP 未连接而失败，请暂停并完成设置：
添加 Linear MCP：
codex mcp add linear --url https://mcp.linear.app/mcp
启用远程 MCP 客户端：
在 config.toml 中设置 [features] rmcp_client = true，或运行 codex --enable rmcp_client。
使用 OAuth 登录：
codex mcp login linear
登录成功后，用户需要重启 codex。此时应结束回答并告知用户，以便其再次尝试时可以从步骤 1 继续。
Windows/WSL 注意事项：如果在 Windows 上遇到连接错误，可尝试通过 WSL 配置 Linear MCP：
{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
步骤 1
明确用户的目标和范围（例如问题分类、冲刺规划、文档审计、工作负载平衡）。根据需要确认团队/项目、优先级、标签、周期和截止日期。
步骤 2
选择合适的工作流（见下文“实用工作流”），并确定需要使用的 Linear MCP 工具。在调用工具前确认所需标识符（问题 ID、项目 ID、团队键）。
步骤 3
按逻辑批次执行 Linear MCP 工具调用：
- 先读取（list/get/search）以构建上下文。
- 再创建或更新（问题、项目、标签、评论），并填写所有必填字段。
- 对于批量操作，在应用更改前解释分组逻辑。
步骤 4
汇总结果，指出剩余的缺口或阻碍，并提出后续行动（新增问题、标签变更、分配或后续评论）。
可用工具
- 问题管理：list_issues、get_issue、create_issue、update_issue、list_my_issues、list_issue_statuses、list_issue_labels、create_issue_label
- 项目与团队：list_projects、get_project、create_project、update_project、list_teams、get_team、list_users
- 文档与协作：list_documents、get_document、search_documentation、list_comments、create_comment、list_cycles
实用工作流
- 冲刺规划：查看目标团队的未完成问题，按优先级挑选重点事项，并创建新周期（例如“Q1 Performance Sprint”）及分配。
- 缺陷分类：列出严重/高优先级缺陷，按用户影响排序，并将重点事项移至“In Progress”。
- 文档审计：搜索文档（例如 API 认证），然后为缺口或过时部分创建带“documentation”标签的问题，并附上详细修复建议。
- 团队工作负载平衡：按负责人分组活跃问题，标记负载过高者，并建议或应用重新分配。
- 发布规划：创建项目（例如“v2.0 Release”）及里程碑（功能冻结、测试版、文档、发布），并生成带估算的问题。
- 跨项目依赖：查找所有“blocked”问题，识别阻碍项，并在缺失时创建关联问题。
- 自动状态更新：查找更新停滞的自身问题，并根据当前状态/阻碍添加状态评论。
- 智能标签：分析未标记问题，建议/应用标签，并创建缺失的标签类别。
- 冲刺回顾：为上一个完成的周期生成报告，记录已完成与推迟的工作，并针对模式创建讨论问题。
提高效率的技巧
- 对相关更改进行批量操作；考虑为重复的问题结构使用智能模板。
- 尽可能使用自然语言查询（例如“Show me what John is working on this week”）。
- 利用上下文：在新请求中引用之前的问题。
- 将大型更新拆分为较小批次以避免速率限制；频繁列出时缓存或复用过滤器。
故障排除
- 身份验证：清除浏览器 cookie，重新运行 OAuth，验证工作区权限，确保已启用 API 访问。
- 工具调用错误：确认模型支持多次工具调用，提供所有必填字段，并拆分复杂请求。
- 数据缺失：刷新令牌，验证工作区访问权限，检查已归档项目，并确认团队选择正确。
- 性能：注意 Linear API 速率限制；批量执行批量操作，使用特定过滤器，或缓存频繁查询。