linear

# Linear ## 概述 此技能为在 Linear 中管理议题、项目和团队工作流提供了结构化的工作流。它确保与 Linear MCP 服务器的持续集成，该服务器为议题、项目、文档和团队协作提供自然语言项目管理功能。 ## 前提条件 - 必须连接 Linear MCP 服务器并可通过 OAuth 访问 - 确认对相关 Linear 工作区、团队和项目的访问权限 ## 必需的工作流 **按顺序执行以下步骤。不要跳过步骤。** ### 第 0 步：设置 Linear MCP（如果尚未配置） 如果任何 MCP 调用因 Linear MCP 未连接而失败，请暂停并进行设置： 1. 添加 Linear MCP： - `codex mcp add linear --url https://mcp.linear.app/mcp` 2. 启用远程 MCP 客户端： - 在 `config.toml` 中设置 `[features] rmcp_client = true` **或** 运行 `codex --enable rmcp_client` 3. 使用 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`