5.3 KiB

Raw Permalink Blame History

name	description
thread	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.

/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.

/thread switch <thread-id>
/thread <thread-id>

Update Thread

Update the metadata of the current or specified thread.

/thread update --title "New Title" --add-tags tag3

Delete Thread

Delete a thread permanently.

/thread delete <thread-id> --confirm

Show/Info

Show details about a thread.

/thread show <thread-id>
/thread info  # Shows current thread

Implementation Details for Claude

⚠️ 前置检查（最高优先级）

在执行任何操作之前，必须先检查 thread-manager MCP 服务器是否可用。

判断方法：检查当前可用的工具列表中是否包含 mcp__thread-manager__* 系列工具（如 mcp__thread-manager__list_threads、mcp__thread-manager__switch_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 不可用时尝试调用工具，这会导致命令卡住无响应！

正常流程

当用户调用此命令时，您应该：

检查 MCP 可用性：确认 mcp__thread-manager__* 工具存在。如不存在，输出上述错误信息并停止。
解析子命令：识别它是 new、switch、update、delete、show 还是 ID（这意味着切换）。
调用相应的 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.get_current_thread
格式化输出：将结果美观地呈现给用户。

切换线程时的处理

当用户执行 /thread switch <id> 或 /thread <id> 时：

调用 thread-manager.switch_thread。
解析返回结果，特别是 message 字段。
显示完整的切换横幅（即 thread-manager 返回的 message，包含上下文恢复和启动命令）。
建议用户重启会话以完全隔离上下文。

重要提示格式 (由 thread-manager 返回的 message 字段已包含此内容)：

⚠️ 为了完全隔离上下文，请执行以下操作之一：

选项 1（推荐）：重启到新 session
exit
claude --session-id <thread-id>

选项 2：在新终端中打开
claude --session-id <thread-id>

创建线程时的处理

当用户执行 /thread new "标题" 时：

调用 thread-manager.create_thread。
立即显示创建成功的信息（即 thread-manager 返回的 message 字段）。
提供启动命令（即 thread-manager 返回的 launchCommand 字段）。
🔴 重要：立即结束响应，不要执行任何额外的任务或继续对话。

响应格式要求：

✅ 只输出 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 您调用:

use_mcp_tool({
  server_name: "thread-manager",
  tool_name: "create_thread",
  arguments: {
    title: "Fix login bug",
    tags: ["bug"],
  }
});

示例: 切换线程 如果用户输入: /thread T-12345 您调用:

use_mcp_tool({
  server_name: "thread-manager",
  tool_name: "switch_thread",
  arguments: {
    threadId: "T-12345"
  }
});

5.3 KiB Raw Permalink Blame History Unescape Escape