qwen_agent/skills_developing/user-context-loader

User Context Loader

用户上下文加载器示例 Skill，演示 Claude Plugins 模式的 hooks 机制。

功能说明

本 Skill 演示了三种 Hook 类型：

PrePrompt Hook

在 system_prompt 加载时执行，动态注入用户上下文信息。

• 文件: hooks/pre_prompt.py
• 用途: 查询用户信息、偏好设置、历史记录等，注入到 prompt 中

PostAgent Hook

在 agent 执行完成后执行，用于后处理。

• 文件: hooks/post_agent.py
• 用途: 记录分析数据、触发异步任务、发送通知等

PreSave Hook

在消息保存前执行，用于内容处理。

• 文件: hooks/pre_save.py
• 用途: 内容过滤、敏感信息脱敏、格式转换等

目录结构

user-context-loader/
├── README.md                   # Skill 说明文档
├── .claude-plugin/
│   └── plugin.json            # Hook 和 MCP 配置文件
└── hooks/
    ├── pre_prompt.py          # PrePrompt hook 脚本
    ├── post_agent.py          # PostAgent hook 脚本
    └── pre_save.py            # PreSave hook 脚本

plugin.json 格式

{
  "name": "user-context-loader",
  "description": "用户上下文加载器示例 Skill",
  "hooks": {
    "PrePrompt": [
      {
        "type": "command",
        "command": "python hooks/pre_prompt.py"
      }
    ],
    "PostAgent": [
      {
        "type": "command",
        "command": "python hooks/post_agent.py"
      }
    ],
    "PreSave": [
      {
        "type": "command",
        "command": "python hooks/pre_save.py"
      }
    ]
  },
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["path/to/server.js"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

Hook 脚本格式

Hook 脚本通过子进程执行，通过环境变量接收参数，通过 stdout 返回结果。

可用环境变量

环境变量	说明	适用于
BOT_ID	Bot ID	所有 hook
USER_IDENTIFIER	用户标识	所有 hook
SESSION_ID	会话 ID	所有 hook
LANGUAGE	语言代码	所有 hook
HOOK_TYPE	Hook 类型	所有 hook
CONTENT	消息内容	PreSave
ROLE	消息角色	PreSave
RESPONSE	Agent 响应	PostAgent
METADATA	元数据 JSON	PostAgent

PrePrompt 示例

#!/usr/bin/env python3
import os
import sys

def main():
    user_identifier = os.environ.get('USER_IDENTIFIER', '')
    bot_id = os.environ.get('BOT_ID', '')

    # 输出要注入到 prompt 中的内容
    print(f"## User Context\n\n用户: {user_identifier}")
    return 0

if __name__ == '__main__':
    sys.exit(main())

PreSave 示例

#!/usr/bin/env python3
import os
import sys

def main():
    content = os.environ.get('CONTENT', '')

    # 处理内容并输出
    print(content)  # 输出处理后的内容
    return 0

if __name__ == '__main__':
    sys.exit(main())

PostAgent 示例

#!/usr/bin/env python3
import os
import sys

def main():
    response = os.environ.get('RESPONSE', '')
    session_id = os.environ.get('SESSION_ID', '')

    # 记录日志（输出到 stderr）
    print(f"Session {session_id}: Response length {len(response)}", file=sys.stderr)
    return 0

if __name__ == '__main__':
    sys.exit(main())

使用场景

1. PrePrompt: 用户登录时自动加载其偏好设置、历史订单等
2. PostAgent: 记录对话分析数据，触发后续业务流程
3. PreSave: 敏感信息脱敏后再存储，如手机号、邮箱等