remote-control

name	remote-control
description	远程协作模式控制器。当 Stop Hook 提示"远程模式已启用"时自动使用。 负责发送微信通知、等待回复、处理指令循环。必须配合 gewe-cli 工具使用。
allowed-tools	Bash, TaskOutput

远程控制 Skill

⚡ 激活后立即执行

当此 Skill 被激活时（Stop Hook 触发），直接执行以下步骤，不要输出任何说明或询问用户：

1. 生成任务摘要 - 1-2 句话总结刚才完成的工作
2. 发送微信通知 - 使用 gewe-cc wait-reply（后台运行）
3. 等待回复 - 使用 TaskOutput 获取微信回复
4. 执行下一步 - 根据回复继续工作或停止

❌ 禁止的行为（激活后）：

• 输出"我已理解工作流程"、"远程模式已激活"等元信息
• 询问用户"希望我完成什么任务？"
• 等待用户在终端输入任何内容

✅ 正确的行为（激活后）：

• 立即生成摘要（如："回答了简单的数学问题"）
• 立即发送微信通知并等待回复
• 根据回复继续下一个任务或停止

概述

此 Skill 实现了基于微信的远程协作模式。当任务完成时，你需要：

1. 发送微信通知告知用户任务完成
2. 等待用户通过微信发送下一个指令
3. 根据指令继续工作或结束远程模式

⚠️ 关键约束：禁止直接询问用户

在远程协作模式下，你不能直接向用户提问并等待终端输入。

问题场景

❌ 禁止的行为：

你：方案 A、B、C 各有优势，您觉得哪个更好？
[等待用户在终端输入...]

后果：

• 你的消息输出后，stop_reason: null
• Stop Hook 不会触发
• 远程模式循环中断
• 用户在微信收不到通知

正确做法：通过微信询问

✅ 需要用户选择时，使用 gewe-cc wait-reply

# 步骤 1：后台运行询问命令
gewe-cc wait-reply -M "【Claude Code】
📁 项目: $(basename "$(pwd)")
❓ 需要选择实现方案

方案 A: 简单但功能受限
方案 B: 复杂但灵活
方案 C: 平衡（推荐）

请回复「A」「B」或「C」"

# 步骤 2：等待回复（使用 TaskOutput）
# 步骤 3：根据回复执行对应方案

为什么可行：

• gewe-cc wait-reply 阻塞运行直到收到微信回复
• 回复后你的输出完整，stop_reason 正常
• Stop Hook 正常触发，远程模式继续循环

设计原则

该问就问：需要用户输入时，通过 gewe-cc wait-reply 获取微信回复，永远不要直接向用户提问并等待终端输入。

配置信息

配置会自动从 ~/.gewe-cc/config.toml 读取：

• 目标微信 ID: 配置文件中的 notification.wxid
• 监听地址: 配置文件中的 notification.listen
• 命令工具: gewe-cc（封装了 gewe-cli）

工作流程

步骤 1：生成任务摘要

根据本次会话完成的工作，生成简洁的 1-2 句话摘要。

好的示例：

• "创建了用户认证模块，添加了 JWT 支持"
• "修复了数据库连接池泄漏问题"
• "重构了配置系统，支持环境变量覆盖"

避免：

• ❌ "完成了任务"（太笼统）
• ❌ "修改了 3 个文件，添加了 150 行代码"（太技术细节）

步骤 2：发送微信通知并等待回复

有两种发送方式：文本消息（简短摘要）或 链接卡片（完整 transcript）

方式 A：发送文本消息（简短摘要）

适用于摘要简短（< 200 字符）的情况。

gewe-cc wait-reply -M "【Claude Code】
📁 项目: $(basename "$(pwd)")
✅ 任务完成
📝 摘要: <你生成的摘要>

回复任何内容继续，回复「停止」结束远程模式。"

必须使用 run_in_background=true 参数！

方式 B：发送链接卡片（完整 transcript）

适用于摘要较长或需要查看完整对话历史的情况。

前置检查：

在发送链接卡片前，必须先检查 HTTP 服务器是否运行：

# 检查 HTTP 服务器进程
if ! pgrep -f "gewe-cc serve" > /dev/null; then
    echo "⚠️ HTTP 服务器未运行，正在启动..."
    gewe-cc serve &
    sleep 2
fi

前置要求：

1. 确保配置文件中已设置 transcript_domain

   gewe-cc config --transcript-domain "https://transcript.example.com"
   

2. 确保 ~/.gewe-cc/assets/thumb.png 存在且小于 50KB

使用方法：

# 从 Stop Hook 提示中提取 session_id
# 例如："会话: 75f2b194-4b91-4c19-8e97-4ff5fe562ece"

SESSION_ID="<从提示中获取的 session_id>"

# 发送链接卡片并等待回复（一条命令完成）
gewe-cc send-link \
  --session-id "${SESSION_ID}" \
  --summary "<你生成的摘要>"

该命令会自动：

• 从配置读取 wxid 和 transcript_domain
• 构建完整的 transcript URL
• 发送链接卡片到微信
• 等待用户回复
• 返回用户的回复内容

必须使用 run_in_background=true 参数！

链接卡片优势：

• 展示完整对话历史（包括 tool use、tool result）
• 支持 Markdown 渲染和代码高亮
• 响应式设计，移动端友好
• 提供"跳到底部"按钮快速查看最新内容

选择建议：

• 摘要 < 200 字符 → 使用文本消息
• 摘要 ≥ 200 字符 → 使用链接卡片
• 需要查看详细 tool 调用 → 使用链接卡片

步骤 3：等待并获取回复

使用 TaskOutput 工具等待后台命令完成：

1. 从步骤 2 的返回中获取任务 ID
2. 使用 TaskOutput(task_id=<id>, block=true, timeout=300000) 阻塞等待

超时设置：

• 默认超时 300000 毫秒（5 分钟）
• 如果超时，询问用户是否继续等待

步骤 4：解析回复内容

从 TaskOutput 的输出中直接获取用户的回复内容。

gewe-cc wait-reply 输出格式：

<用户的回复内容>

直接获取输出即为用户回复。

步骤 5：根据回复决定下一步

检查回复内容（不区分大小写）：

情况 A：用户回复"停止"

如果回复是以下任意一个（不区分大小写）：

• 停止
• stop
• Stop
• STOP

执行操作：

# 关闭当前会话的远程模式（保持全局远程模式启用）
gewe-cc off --session-id <会话ID>

然后告知用户当前会话已结束，正常结束（不要继续循环）。

会话 ID 说明：从 Stop Hook 的提示中获取，格式为：5e64d0b7 等

情况 B：用户回复其他内容

将回复内容作为新的用户指令执行：

1. 将回复作为新任务
2. 执行该任务
3. 任务完成后回到步骤 1（重新循环）

示例：

用户回复："添加单元测试"
  ↓
你应该：
1. 理解这是要添加单元测试的任务
2. 执行添加单元测试
3. 完成后再次生成摘要
4. 再次发送微信通知
5. 等待下一个指令

错误处理

gewe-cc 命令失败

如果 gewe-cc wait-reply 命令失败：

1. 显示错误信息给用户
2. 询问用户是否退出远程模式
3. 如果用户确认，执行 gewe-cc off

TaskOutput 超时

如果等待超过 5 分钟没有回复：

询问用户：
"等待微信回复已超时（5 分钟）。是否继续等待？
1. 继续等待（再等 5 分钟）
2. 退出远程模式"

完整示例

成功流程示例

[Claude 完成任务：重构配置系统]
  ↓
Stop Hook 检测到远程模式
  ↓
remote-control Skill 激活
  ↓
生成摘要："重构了配置系统，支持环境变量覆盖"
  ↓
发送微信（后台运行）：
  gewe-cc wait-reply -M "【Claude Code】..."
  [返回任务 ID: abc123]
  ↓
使用 TaskOutput 等待：
  TaskOutput(task_id="abc123", block=true, timeout=300000)
  ↓
收到回复："添加配置文档"
  ↓
执行新任务：添加配置文档
  ↓
[任务完成，回到开始循环]

停止流程示例

[Claude 完成任务]
  ↓
发送微信通知
  ↓
等待回复
  ↓
收到回复："停止"
  ↓
执行命令：
  gewe-cc off
  ↓
告知用户："✅ 远程模式已结束"
  ↓
正常结束（不再循环）

注意事项

1. 必须使用 run_in_background

   • gewe-cc wait-reply 会阻塞等待回复
   • 必须后台运行，否则会卡住

2. 摘要要有意义

   • 用户通过微信查看，需要快速理解完成了什么
   • 避免技术术语过多

3. 循环条件

   • 只有收到"停止"指令才退出
   • 其他任何回复都继续执行

4. 配置自动读取

   • gewe-cc 会自动从 ~/.gewe-cc/config.toml 读取配置
   • 无需手动解析配置文件

5. 退出方式

   • 使用 gewe-cc off 命令禁用远程模式
   • 不要手动删除文件