名称: linear 描述: 在Linear中管理问题、项目和团队工作流。当用户想在Linear中读取、创建或更新工单时使用。 元数据: 简短描述: 在Codex中管理Linear问题
Linear
概述
这个技能提供了一个结构化的工作流，用于在Linear中管理问题、项目和团队工作流。它确保与Linear MCP服务器的集成一致性，该服务器提供针对问题、项目、文档和团队协作的自然语言项目管理。
先决条件
- 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上看到连接错误，尝试配置Linear MCP通过WSL运行：
{"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工具调用：
- 先读取（列出/获取/搜索）以构建上下文。
- 然后创建或更新（问题、项目、标签、评论）并填写所有必填字段。
- 对于批量操作，在应用更改之前解释分组逻辑。
步骤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性能冲刺”）并进行分配。
- 错误分类: 列出关键/高优先级错误，按用户影响排序，并将顶部项目移动到“进行中”。
- 文档审计: 搜索文档（例如，API认证），然后为缺口或过时部分打开标记为“文档”的问题，并提供详细修复。
- 团队工作负载平衡: 按受让人分组活动问题，标记任何高负载者，并建议或应用重新分配。
- 发布规划: 创建一个项目（例如，“v2.0发布”）并设置里程碑（功能冻结、测试版、文档、启动），并生成带估计的问题。
- 跨项目依赖: 查找所有“受阻”问题，识别阻塞项，并在缺失时创建链接问题。
- 自动化状态更新: 查找你的有陈旧更新的问题，并根据当前状态/阻塞项添加状态评论。
- 智能标签: 分析未标记问题，建议/应用标签，并创建缺失的标签类别。
- 冲刺回顾: 为上一个完成周期生成报告，注意完成与延后工作，并为模式打开讨论问题。
最大生产力提示
- 批量操作相关更改；考虑使用智能模板处理重复问题结构。
- 尽可能使用自然查询（“显示约翰本周在做什么”）。
- 利用上下文：在新请求中引用先前问题。
- 将大更新分解为小批次以避免速率限制；频繁列表时缓存或重用过滤器。
故障排除
- 认证: 清除浏览器cookies，重新运行OAuth，验证工作区权限，确保API访问已启用。
- 工具调用错误: 确认模型支持多个工具调用，提供所有必填字段，并拆分复杂请求。
- 数据缺失: 刷新令牌，验证工作区访问，检查归档项目，并确认正确的团队选择。
- 性能: 记住Linear API速率限制；批量操作，使用特定过滤器，或缓存频繁查询。