Thread manager

--- name: thread description: Manage conversation threads (create, switch, update, delete, show) --- # Thread Manager Command This command allows you to manage conversation threads using the thread-manager MCP server. ## Usage - /thread new "Title" [options]: Create a new thread - /thread switch <id>: Switch to a specific thread - /thread update [options]: Update current thread metadata - /thread delete <id>: Delete a thread - /thread show [id]: Show thread details - /thread or /thread info: Show current thread info ## Subcommands ### New Thread Create a new thread and optionally switch to it. ``bash /thread new "Implement User Auth" --tags backend,auth ` **Options:** - --desc "Description": Add a description - --tags tag1,tag2: Add tags (comma separated) - --no-switch: Do not switch to the new thread immediately ### Switch Thread Switch context to another thread. `bash /thread switch <thread-id> /thread <thread-id> ` ### Update Thread Update the metadata of the *current* or specified thread. `bash /thread update --title "New Title" --add-tags tag3 ` ### Delete Thread Delete a thread permanently. `bash /thread delete <thread-id> --confirm ` ### Show/Info Show details about a thread. `bash /thread show <thread-id> /thread info # Shows current thread ` ## Implementation Details for Claude ### ⚠️ 前置检查（最高优先级） **在执行任何操作之前，必须先检查 thread-manager MCP 服务器是否可用。** 判断方法：检查当前可用的工具列表中是否包含 mcpthread-manager* 系列工具（如 mcpthread-managerlist_threads、mcpthread-managerswitch_thread 等）。 **如果 MCP 工具不可用，必须立即输出以下错误信息并停止，不要尝试调用任何工具：** ` ❌ thread-manager MCP 服务器未配置 当前项目未配置 thread-manager MCP 服务器，无法使用线程管理功能。 🔧 解决方案： 方案 1：全局安装（推荐，一次配置全局可用） claude mcp add thread-manager -s user -- node <path-to-thread-manager>/dist/index.js 方案 2：项目级安装 claude mcp add thread-manager -s project -- node <path-to-thread-manager>/dist/index.js 方案 3：切换到已配置该服务的项目目录 添加后需要重启 Claude Code 会话才能生效。 ` **🔴 重要：绝对不要在 MCP 不可用时尝试调用工具，这会导致命令卡住无响应！** --- ### 正常流程 当用户调用此命令时，您应该： 1. **检查 MCP 可用性**：确认 mcpthread-manager* 工具存在。如不存在，输出上述错误信息并停止。 2. **解析子命令**：识别它是 new、switch、update、delete、show 还是 ID（这意味着切换）。 3. **调用相应的 MCP 工具**： - new -> thread-manager.create_thread - switch 或 <id> -> thread-manager.switch_thread - list -> thread-manager.list_threads - update -> thread-manager.update_thread - delete -> thread-manager.delete_thread - show 或 info -> thread-manager.get_thread 或 thread-manager.getcurrentthread 4. **格式化输出**：将结果美观地呈现给用户。 ### 切换线程时的处理 当用户执行 /thread switch <id> 或 /thread <id> 时： 1. **调用 thread-manager.switch_thread**。 2. **解析返回结果**，特别是 message 字段。 3. **显示完整的切换横幅**（即 thread-manager 返回的 message，包含上下文恢复和启动命令）。 4. **建议用户重启会话以完全隔离上下文**。 **重要提示格式 (由 thread-manager 返回的 message 字段已包含此内容)**： ` ⚠️ 为了完全隔离上下文，请执行以下操作之一： 选项 1（推荐）：重启到新 session exit claude --session-id <thread-id> 选项 2：在新终端中打开 claude --session-id <thread-id> ` ### 创建线程时的处理 当用户执行 /thread new "标题" 时： 1. **调用 thread-manager.create_thread**。 2. **立即显示创建成功的信息**（即 thread-manager 返回的 message 字段）。 3. **提供启动命令**（即 thread-manager 返回的 launchCommand 字段）。 4. **🔴 重要：立即结束响应，不要执行任何额外的任务或继续对话**。 **响应格式要求：** - ✅ 只输出 thread-manager 返回的 message 内容 - ✅ 保持输出简洁（不超过 20 行） - ❌ 不要思考或规划后续任务 - ❌ 不要问用户"接下来要做什么" - ❌ 不要开始执行创建 thread 之外的其他工作 **示例正确响应：** ` ✨ 新线程已创建 📋 标题：测试当前h5 🆔 ID：8458e9d2 🚀 启动独立会话： claude --session-id 8458e9d2-cf78-445b-96ed-c4f286b1c83d 或使用快捷命令： clt 8458e9d2 ` [响应结束，等待用户下一个命令] **示例: 创建线程** 如果用户输入: /thread new "Fix login bug" --tags bug 您调用: `javascript use_mcp_tool({ server_name: "thread-manager", tool_name: "create_thread", arguments: { title: "Fix login bug", tags: ["bug"], } }); ` **示例: 切换线程** 如果用户输入: /thread T-12345 您调用: `javascript use_mcp_tool({ server_name: "thread-manager", tool_name: "switch_thread", arguments: { threadId: "T-12345" } }); ``