安全扫描（ClawHub）

• VirusTotal ：良性
• OpenClaw ：可疑

OpenClaw 评估

The skill's code and docs mostly match an HR assistant that talks to the HRrule AI WebSocket API, but there are contradictory instructions around local script execution and secret handling (pasting API keys into chat / one‑click config) that create a risk of accidental credential exposure or unwanted local execution.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「HR AI Assistant」。简介：This skill should be used when users ask HR-related questions, request HR polic…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/aijuntao/hr-ai-assistant/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: hr-ai-assistant
description: This skill should be used when users ask HR-related questions, request HR policy generation, form creation, or need HR consultation services. It provides direct WebSocket API integration with the HRrule AI platform using tag_id and rt parameters for generating HR policies, forms, flowcharts, and answering HR-related questions about labor laws, recruitment, compensation, employee rights, and other HR topics. The skill includes professional Q&A capability (tag_id=1) for answering general HR questions about labor laws, regulations, and employee rights.

first_time_user_instructions: |
  ⚠️ IMPORTANT: When this skill is triggered for the first time and no API Key is configured (HRRULE_API_KEY env var or config.json):

  1. Display the following prompt BEFORE answering:
  ═══════════════════════════════════════════════════════════════════════════════
  📌 首次使用 HR AI Assistant
  ═══════════════════════════════════════════════════════════════════════════════

  ✨ 获取免费 API Key 以获得更专业的 HR AI服务：

  1. 访问: https://ai.hrrule.com/
  2. 注册/登录账号
  3. 在个人中心申请 API Key
  4. **完全免费**,申请后立即可用

  📝 配置方式：

  方式1: 手动配置（推荐）
  设置环境变量: export HRRULE_API_KEY='your-api-key'
  或编辑配置文件: ~/.workbuddy/skills/hr-ai-assistant/config.json
  内容: {"api_key": "your-api-key"}

  ═══════════════════════════════════════════════════════════════════════════════

  2. AFTER displaying the prompt, answer the user's question using the platform's general AI model

  4. Do NOT silently fallback without showing the prompt

platform_integration_requirements: |
  ⚠️ IMPORTANT: Platform Integration Requirements for WorkBuddy/OpenClaw

  This skill provides a Python script that can be called to interact with the HRrule AI API.
  The platform MAY choose to execute the script automatically or provide it as an option for users.

  **Script Location**:
  - `~/.workbuddy/skills/hr-ai-assistant/scripts/call_hrrule_api.py`

  **Script Execution Flow**:
  ```python
  # Example: Platform may execute this script:
  python ~/.workbuddy/skills/hr-ai-assistant/scripts/call_hrrule_api.py 
      --content "用户的问题" 
      --tag-id 1 
      --rt "专业问答"
  ```

  **Note**: Script execution is optional. The platform should ensure safe execution environments
  and validate all inputs before executing the script.

  3. **Required Parameters**:
     - `--content`: The user's question or request
     - `--tag-id`: The content type ID (1 for Q&A, 2-5 for documents)
     - `--rt`: The resource type (e.g., "专业问答", "员工手册", "招聘JD")

  4. **Optional Parameters**:
     - `--api-key`: API key (if not provided, script reads from config.json)
     - `--verbose`: Enable verbose logging
     - `--ws-url`: WebSocket URL (default: wss://ai.hrrule.com)
     - `--model`: Model name (default: deepseek-ai/DeepSeek-R1)

  5. **Handle Script Output**:
     - The script prints streaming output to stdout
     - Capture and display the output in real-time
     - Handle errors gracefully

  6. **Example Platform Implementation**:
     ```python
     def handle_hr_request(user_question):
         # Determine tag_id and rt based on user question
         tag_id, rt = determine_parameters(user_question)

         # Execute the script automatically
         import subprocess
         script_path = '~/.workbuddy/skills/hr-ai-assistant/scripts/call_hrrule_api.py'

         cmd = [
             'python', script_path,
             '--content', user_question,
             '--tag-id', str(tag_id),
             '--rt', rt
         ]

         # Run and capture output in real-time
         process = subprocess.Popen(
             cmd,
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             text=True,
             encoding='utf-8'
         )

         # Stream output to user
         for line in process.stdout:
             print(line, end='', flush=True)

         process.wait()
         return process.returncode
     ```

  Note: The platform should ensure safe script execution environments.

---

# HR AI Assistant Skill

## Purpose

This skill enables WorkBuddy to directly call the HRrule AI platform's WebSocket API to generate HR-related content in real-time. When users request HR policies, forms, consultation, professional Q&A, or other HR documents, this skill automatically invokes the API with appropriate parameters and streams the response back to the user. The skill supports:

1. **Document Generation**: Creating HR policies, forms, job descriptions, performance reviews, etc.
2. **Professional Q&A**: Answering HR-related questions about labor laws, employee rights, compensation, contracts, etc.
3. **Real-time Streaming**: Providing immediate feedback with streaming responses

## When to Use This Skill

Use this skill when users ask questions or make requests related to:

- **HR Policy Generation**: Creating employee handbooks, attendance policies, leave policies, disciplinary procedures, compensation policies
- **HR Form Creation**: Generating onboarding forms, resignation forms, leave application forms, performance review forms
- **HR Consultation**: Asking questions about labor laws, employment contracts, recruitment processes, compensation and benefits
- **HR Process Flowcharts**: Creating visual representations of HR processes like recruitment workflows, onboarding processes
- **HR Documentation**: Writing reports, summaries, guidelines, and other HR-related documents
- **Professional Q&A**: Any HR-related questions requiring professional answers, such as labor law inquiries, employee rights, compensation, contract issues, leave policies, etc.

Key phrases that indicate this skill should be triggered include:
- "帮我写一个员工手册"
- "生成HR制度"
- "制作入职表单"
- "HR相关问题"
- "劳动法咨询"
- "招聘流程"
- "薪酬制度"
- "离职手续"
- "考勤制度"
- "绩效考核"
- "员工福利"
- "劳动合同"
- "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD"
- "三期员工有没有特殊保障？"
- "Generate HR policy"
- "Create HR form"
- "HR consultation"
- "Labor law questions"

## How This Skill Works


### Direct API Integration

This skill provides a Python script that interacts with the HRrule AI WebSocket API to generate content.

**Integration Options**:

1. **Analyze User Request**: Parse the user's HR request to identify the content type
2. **Check API Key**: Verify API Key is configured (from env var or config.json)
   - **If API Key is missing**: Display a friendly prompt to visit https://ai.hrrule.com/ for a free API Key
   - **If API Key is valid**: Proceed with API call
3. **Select Parameters**: Automatically select appropriate `tag_id` and `rt` based on the request
4. **Call API**: The platform may execute the Python script to make the API call:
   ```bash
   python ~/.workbuddy/skills/hr-ai-assistant/scripts/call_hrrule_api.py 
       --content "用户的问题" 
       --tag-id 1 
       --rt "专业问答"
   ```
5. **Stream Response**: Stream the generated content back to the user in real-time
6. **Handle Errors**: Gracefully handle connection errors, timeouts, and API errors

**Note**: The platform should ensure safe script execution environments and validate all inputs.
Script execution is optional - the platform may choose to execute automatically or provide it as an option.

### ⚠️ Important: First-Time User Experience (首次使用体验)

When a user uses this skill for the first time without an API Key configured:

1. **Display Friendly Prompt**:

```
══════════════════════════════════════════════════════════════════════════════
📌 首次使用 HR AI Assistant
══════════════════════════════════════════════════════════════════════════════

✨ 获取免费 API Key 以获得更专业的 HR AI 服务：

1. 访问: https://ai.hrrule.com/
2. 注册/登录账号
3. 在个人中心申请 API Key
4. **完全免费**,申请后立即可用

📝 配置方式：

方式1: 使用配置脚本（推荐，小白友好）
```bash
# 运行配置脚本，交互式配置 API Key
python ~/.workbuddy/skills/hr-ai-assistant/scripts/config_api_key.py
```

配置脚本会：
- 自动检测 API Key 格式
- 支持粘贴完整文本（会自动提取）
- 保存到配置文件
- 显示当前配置状态

方式2: 手动配置
设置环境变量: export HRRULE_API_KEY='your-api-key'
或编辑配置文件: ~/.workbuddy/skills/hr-ai-assistant/config.json
内容: {"api_key": "your-api-key"}

══════════════════════════════════════════════════════════════════════════════
```

2. **Then proceed to answer using the platform's general AI model** (WorkBuddy/OpenClaw's default model)

**Example workflow**:
```
User: "三期员工有没有特殊保障？"

System detection:
  → HR AI Assistant skill needed
  → No API Key configured
  → DISPLAY THE PROMPT ABOVE

System: [显示上述提示信息]

System: [使用通用大模型回答问题]

User: "我申请到了 API Key，怎么配置？"

System: 请运行配置脚本：
  python ~/.workbuddy/skills/hr-ai-assistant/scripts/config_api_key.py
```

**NOTE**: The prompt should be displayed BEFORE answering the question.

### Tag ID and RT Parameter Mapping

The skill automatically maps user requests to the appropriate parameters:

**Tag ID: 1 (专业问答 - Professional Q&A)**
- **通用 HR 咨询**：劳动法问题、员工权益、薪酬福利、劳动合同、离职补偿、加班工资、试用期规定等任何 HR 相关的专业问答
- **示例问题**：
  - "三期员工有没有特殊保障？"
  - "员工离职需要提前多少天通知？"
  - "试用期工资可以低于转正工资多少？"
  - "加班费怎么计算？"
  - "员工旷工怎么处理？"
  - "未签订劳动合同有什么后果？"
  - "竞业限制补偿金标准是多少？"

**Tag ID: 2 (制度类 - HR Policies)**
- 员工手册, 招聘管理制度, 入职试用期管理制度, 劳动合同管理制度, 薪酬管理制度, 考勤休假制度, 加班管理制度, 绩效管理制度, 员工培训制度, 离职管理制度, 员工竞聘制度, 病假管理制度, 奖惩制度, 其他制度

**Tag ID: 7 (岗位类 - Job Descriptions)**
- 岗位说明书, 工作饱和度评估表, 任职资格标准, 职位图谱

**Tag ID: 3 (绩效类 - Performance Management)**
- 360考核表, BSC考核表, KPI考核表, OKR考核表, 绩效承诺书, 绩效改进计划, 绩效面谈表, 绩效诊断报告

**Tag ID: 4 (招聘类 - Recruitment)**
- 人才画像, 面试评估表, 面试题库, 招聘需求表, 招聘JD, 背景调查表, 录用条件说明书, 录用通知书, 入职承诺书, 劳动合同

**Tag ID: 5 (薪酬类 - Compensation)**
- 薪酬等级表, 薪酬面谈表, 薪酬诊断报告, 岗位价值评估表

**Tag ID: 8 (培训类 - Training)**
- 新员工培训计划, 年度培训计划

**Tag ID: 13 (报告类 - Reports)**
- 年终总结, 月度报告, 周报, 日报

**Tag ID: 14 (风控类 - Risk Management)**
- 风险自测

## Usage Workflow

### Step 1: Parse User Request

Analyze the user's request to determine:
- **Content Type**: What type of HR content they need
- **Tag ID**: The appropriate content category
- **RT**: The specific resource type
- **Details**: Any specific requirements or constraints

**Example Request Analysis:**

Request: "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD"

Analysis:
- Content Type: 招聘JD (Job Description)
- Tag ID: 4 (招聘类)
- RT: "招聘JD"
- Details: 财务公司, 社保专员岗位

### Step 2: Select Parameters

Based on the analysis, select the parameters:

```python
tag_id = 4
rt = "招聘JD"
content = "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD"
```

### Step 3: Call API Using Python Script

Use the bundled script to call the API:

```python
import sys
import os

# 获取 skill 目录路径（动态解析）
skill_dir = os.path.join(os.path.expanduser('~'), '.workbuddy', 'skills', 'hr-ai-assistant')
script_dir = os.path.join(skill_dir, 'scripts')
sys.path.insert(0, script_dir)

from call_hrrule_api import call_hrrule_api

# ⚠️ 重要：平台必须直接执行 skill 目录下的脚本，不要新建 Python 文件

async def get_hr_content():
    # 调用 API 并流式输出
    full_response = await call_hrrule_api(
        api_key='your-api-key',
        content='财务公司 需要招聘 社保专员，帮我生成一份 招聘JD',
        tag_id=4,
        rt='招聘JD',
        on_chunk=lambda text: print(text, end='', flush=True),
        verbose=True
    )
    return full_response

# 执行调用
import asyncio
response = asyncio.run(get_hr_content())
```

### Step 4: Stream Response to User

Stream the response back to the user in real-time:

```
AI 响应:

职位名称: 社保专员
所属部门: 人力资源部
工作地点: 北京
招聘人数: 1人

职位描述:
我们是一家专业的财务公司,现招聘社保专员...
```

## Parameter Selection Logic

### Automatic Mapping Rules

**Rule 1: Keyword Matching**

| Keyword | Tag ID | RT |
|---------|--------|-----|
| 专业问答/咨询 | 1 | 专业问答 |
| 劳动法问题/咨询 | 1 | 专业问答 |
| 员工权益/权利 | 1 | 专业问答 |
| 离职补偿/赔偿 | 1 | 专业问答 |
| 加班工资/加班费 | 1 | 专业问答 |
| 试用期规定/工资 | 1 | 专业问答 |
| 三期/孕期/产期/哺乳期 | 1 | 专业问答 |
| 竞业限制 | 1 | 专业问答 |
| 经济补偿金/赔偿金 | 1 | 专业问答 |
| 违法解除/终止合同 | 1 | 专业问答 |
| 员工手册 | 2 | 员工手册 |
| 考勤制度 | 2 | 考勤休假制度 |
| 薪酬制度 | 2 | 薪酬管理制度 |
| 岗位说明书 | 7 | 岗位说明书 |
| KPI考核表 | 3 | KPI考核表 |
| 绩效考核表 | 3 | KPI考核表 |
| 绩效改进 | 3 | 绩效改进计划 |
| 面试评估表 | 4 | 面试评估表 |
| 面试题库 | 4 | 面试题库 |
| 招聘JD | 4 | 招聘JD |
| 招聘职位 | 4 | 招聘JD |
| 劳动合同 | 4 | 劳动合同 |
| 录用通知书 | 4 | 录用通知书 |
| 薪酬等级表 | 5 | 薪酬等级表 |
| 薪酬面谈表 | 5 | 薪酬面谈表 |
| 培训计划 | 8 | 新员工培训计划 |
| 年终总结 | 13 | 年终总结 |
| 周报/月报/日报 | 13 | 周报/月度报告/日报 |
| 风险评估 | 14 | 风险自测 |

**Rule 2: Context Analysis**

- If user mentions "招聘" (recruitment) + specific document type → Tag ID: 4
- If user mentions "制度" (policy/system) → Tag ID: 2
- If user mentions "考核" (assessment) → Tag ID: 3
- If user mentions "培训" (training) → Tag ID: 8
- If user mentions "报告" (report) + time period → Tag ID: 13
- If user asks a question about labor laws, employee rights, compensation → Tag ID: 1 (专业问答)
- If user asks "有没有"、"如何"、"怎样"、"为什么"等疑问句 → Tag ID: 1 (专业问答)

**Rule 3: Fallback - Professional Q&A**

If no clear match with specific document types (如员工手册、招聘JD、KPI考核表等), use the general Q&A category:
- Any HR-related question about laws, regulations, policies, employee rights → Tag ID: 1, RT: "专业问答"
- Example: "三期员工有没有特殊保障？", "员工离职需要提前多久通知？"
- Example: "试用期工资规定", "加班费计算方式"

**Rule 4: Default Fallback**

If still unclear, use the safest default:
- HR policy/guidance → Tag ID: 2, RT: "其他制度"
- General HR question → Tag ID: 1, RT: "专业问答"

## Script Usage

### Script Location

**IMPORTANT**: The script is located at:
`~/.workbuddy/skills/hr-ai-assistant/scripts/call_hrrule_api.py`

The platform should dynamically resolve this path using:
```python
import os
skill_dir = os.path.join(os.path.expanduser('~'), '.workbuddy', 'skills', 'hr-ai-assistant')
script_path = os.path.join(skill_dir, 'scripts', 'call_hrrule_api.py')
```

**DO NOT use hardcoded paths like `C:/Users/jikr/...`**

### Function Signature

```python
async def call_hrrule_api(
    api_key: str,
    content: str,
    tag_id: int,
    rt: str,
    ws_url: str = "ws://192.168.112.114:5000",
    model: str = "deepseek-ai/DeepSeek-R1",
    on_chunk: Optional[Callable[[str], None]] = None,
    on_complete: Optional[Callable[[], None]] = None,
    on_error: Optional[Callable[[str], None]] = None,
    verbose: bool = False
) -> str
```

### Parameters

- `api_key`: API 密钥(必需)
- `content`: 用户问题或需求(必需)
- `tag_id`: 内容类型 ID(必需)
- `rt`: 资源类型(必需)
- `ws_url`: WebSocket 地址(默认: ws://192.168.112.114:5000)
- `model`: 模型名称(默认: deepseek-ai/DeepSeek-R1)
- `on_chunk`: 收到内容块时的回调函数
- `on_complete`: 完成时的回调函数
- `on_error`: 错误时的回调函数
- `verbose`: 是否显示详细日志

### Return Value

Returns the complete response content as a string.

### Command Line Usage

```bash
python call_hrrule_api.py 
    --api-key "your-api-key" 
    --content "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD" 
    --tag-id 4 
    --rt "招聘JD" 
    --verbose
```

## Example Workflows

### Example 1: Generate Job Description (JD)

**User Request:**
```
财务公司 需要招聘 社保专员，帮我生成一份 招聘JD
```

**Skill Execution:**

1. **Parse Request:**
   - Identify: "招聘JD" → Tag ID: 4, RT: "招聘JD"
   - Extract context: 财务公司, 社保专员

2. **Construct Content:**
   ```python
   content = "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD"
   tag_id = 4
   rt = "招聘JD"
   ```

3. **Call API:**
   ```python
   response = await call_hrrule_api(
       api_key='your-api-key',
       content=content,
       tag_id=tag_id,
       rt=rt,
       on_chunk=lambda text: print(text, end='', flush=True),
       verbose=True
   )
   ```

4. **Stream Response:**
   The AI response is streamed back in real-time.

### Example 2: Generate Employee Handbook

**User Request:**
```
帮我写一个员工手册,适用于50人的科技公司
```

**Skill Execution:**

1. **Parse Request:**
   - Identify: "员工手册" → Tag ID: 2, RT: "员工手册"
   - Extract context: 50人, 科技公司

2. **Call API:**
   ```python
   response = await call_hrrule_api(
       api_key='your-api-key',
       content='帮我写一个员工手册,适用于50人的科技公司',
       tag_id=2,
       rt='员工手册',
       on_chunk=lambda text: print(text, end='', flush=True)
   )
   ```

### Example 3: Create Performance Review Form

**User Request:**
```
为销售部门设计KPI考核表
```

**Skill Execution:**

1. **Parse Request:**
   - Identify: "KPI考核表" → Tag ID: 3, RT: "KPI考核表"
   - Extract context: 销售部门

2. **Call API:**
   ```python
   response = await call_hrrule_api(
       api_key='your-api-key',
       content='为销售部门设计KPI考核表',
       tag_id=3,
       rt='KPI考核表',
       on_chunk=lambda text: print(text, end='', flush=True)
   )
   ```

### Example 4: Professional Q&A (Labor Law Question)

**User Request:**
```
三期员工有没有特殊保障？
```

**Skill Execution:**

1. **Parse Request:**
   - Identify: Question about labor law/employee rights → Tag ID: 1, RT: "专业问答"
   - Extract context: 三期员工 (孕期、产期、哺乳期), 特殊保障

2. **Call API:**
   ```python
   response = await call_hrrule_api(
       api_key='your-api-key',
       content='三期员工有没有特殊保障？',
       tag_id=1,
       rt='专业问答',
       on_chunk=lambda text: print(text, end='', flush=True),
       verbose=True
   )
   ```

3. **Stream Response:**
   ```
   AI 响应:

   根据《劳动合同法》和《女职工劳动保护特别规定》，三期员工（孕期、产期、哺乳期）确实享有特殊保障，主要包括：

   1. 不得单方面解除劳动合同
      - 用人单位不得依据《劳动合同法》第40条、第41条单方面解除合同
      - 除非员工有严重违纪等《劳动合同法》第39条规定的情况

   2. 孕期保护
      - 不得安排从事高强度、有毒有害工作
      - 不得延长劳动时间或安排夜班工作
      - 孕期7个月以上，每天应安排1小时工间休息

   3. 产期保护
      - 享有98天产假（难产或多胞胎适当增加）
      - 产假期间工资照发
      - 生育保险报销医疗费用

   4. 哺乳期保护
      - 每日享有1小时哺乳时间
      - 不得安排有毒有害工作

   5. 经济补偿
      - 如劳动合同期满，合同自动顺延至三期结束
      - 顺延期间不视为续签劳动合同
   ```

### Example 5: General HR Consultation

**User Request:**
```
员工离职需要提前多少天通知？
```

**Skill Execution:**

1. **Parse Request:**
   - Identify: Question about resignation → Tag ID: 1, RT: "专业问答"
   - Extract context: 员工离职, 提前通知时间

2. **Call API:**
   ```python
   response = await call_hrrule_api(
       api_key='your-api-key',
       content='员工离职需要提前多少天通知？',
       tag_id=1,
       rt='专业问答',
       on_chunk=lambda text: print(text, end='', flush=True)
   )
   ```

## Error Handling

The script handles various error scenarios:

### Connection Errors
- Invalid WebSocket URL
- Network connectivity issues
- Firewall blocking

### Authentication Errors
- Invalid API Key
- API Key expired
- Permission denied

### API Errors
- Invalid parameters
- Server errors
- Timeout (120 seconds)

### Error Handling Example

```python
def handle_error(error_msg: str):
    print(f"错误: {error_msg}")
    # 提供用户友好的错误信息
    if "Unauthorized" in error_msg or "401" in error_msg:
        print("API Key 无效,请检查您的 API Key")
    elif "Connection" in error_msg:
        print("连接失败,请检查网络和 WebSocket URL")
    else:
        print("发生未知错误,请稍后重试")

response = await call_hrrule_api(
    api_key='your-api-key',
    content='your content',
    tag_id=2,
    rt='员工手册',
    on_error=handle_error,
    verbose=True
)
```

## Best Practices

### 1. First-Time User Experience (首次使用体验)

**Note**: 当首次使用此 skill 且未配置 API Key 时，平台（WorkBuddy/OpenClaw）应该：

✅ **推荐做法**：
1. 检测到没有 API Key
2. **先显示**友好的提示信息（访问 https://ai.hrrule.com/ 免费申请）
3. **然后**使用平台的通用大模型回答问题
4. 用户手动配置 API Key（通过环境变量、配置文件或配置脚本）

**应该显示的提示信息**：
```
══════════════════════════════════════════════════════════════════════════════
📌 首次使用 HR AI Assistant
══════════════════════════════════════════════════════════════════════════════

✨ 获取免费 API Key 以获得更专业的 HR AI 服务：

1. 访问: https://ai.hrrule.com/
2. 注册/登录账号
3. 在个人中心申请 API Key
4. **完全免费**,申请后立即可用

📝 配置方式（任选一种）：

方式1: 一键配置（推荐）
把申请到的 API Key 直接粘贴到对话框中，我会自动帮你配置到配置文件

方式2: 手动配置
设置环境变量: export HRRULE_API_KEY='your-api-key'
或编辑配置文件: ~/.workbuddy/skills/hr-ai-assistant/config.json
内容: {"api_key": "your-api-key"}

══════════════════════════════════════════════════════════════════════════════
```

**执行顺序**：
```
1. 用户提问："三期员工有没有特殊保障？"
2. 检测到需要此 skill
3. 检测到没有 API Key
4. ⚠️ 显示上述提示信息 ← 必须在回答前
5. 使用通用大模型回答问题
6. 用户手动配置 API Key（通过环境变量或编辑配置文件）
```


**注意**：用户需要手动配置 API Key（通过环境变量或编辑配置文件），系统不会自动检测或保存。

### 2. Provide Detailed Context

Always include as much context as possible in the `content` parameter:
- Company size and industry
- Specific requirements
- Target audience
- Time constraints

**Good:**
```
财务公司 需要招聘 社保专员，帮我生成一份 招聘JD
要求: 3年以上经验,熟悉社保政策,薪资8-12k
```

**Less Good:**
```
生成招聘JD
```

### 2. Use Streaming for Better UX

Always use the `on_chunk` callback to stream responses:

```python
def stream_text(text: str):
    print(text, end='', flush=True)

response = await call_hrrule_api(
    # ... parameters
    on_chunk=stream_text
)
```

### 3. Handle Errors Gracefully

Always provide error callbacks:

```python
response = await call_hrrule_api(
    # ... parameters
    on_error=lambda msg: print(f"❌ 错误: {msg}"),
    on_complete=lambda: print("n✅ 完成")
)
```

### 4. Set Appropriate Timeout

The script has a 120-second timeout by default. For complex documents, this is usually sufficient.

## Configuration

### API Key Configuration

The API Key should be configured securely. Options:
1. Environment variable: `HRRULE_API_KEY`
2. Configuration file
3. Direct parameter passing

### WebSocket URL Configuration

Default: `ws://192.168.112.114:5000`

Can be changed via:
- Command line: `--ws-url`
- Script parameter: `ws_url=`
- Configuration file

## Troubleshooting

### Issue: Connection Fails

**Check:**
- WebSocket URL is correct
- Network connectivity
- Firewall settings
- Server is running

### Issue: Authentication Error

**Check:**
- API Key is valid
- API Key has not expired
- API Key has proper permissions

### Issue: No Response

**Check:**
- Content parameter is not empty
- Tag ID and RT are valid
- Network connection is stable
- Server is processing requests

### Issue: Timeout

**Solution:**
- Increase timeout in script
- Simplify the request
- Check server load

## Integration Examples

### DingTalk Integration

When receiving HR requests from DingTalk:

```python
# 收到 DingTalk 消息
message = "财务公司 需要招聘 社保专员，帮我生成一份 招聘JD"

# 调用 skill
import sys
import os

# 获取 skill 目录路径（动态解析）
skill_dir = os.path.join(os.path.expanduser('~'), '.workbuddy', 'skills', 'hr-ai-assistant')
script_dir = os.path.join(skill_dir, 'scripts')
sys.path.insert(0, script_dir)

from call_hrrule_api import call_hrrule_api

# ⚠️ 重要：平台必须直接执行 skill 目录下的脚本，不要新建 Python 文件

async def handle_dingtalk_message(message: str):
    # 解析请求
    tag_id, rt = parse_request(message)  # 4, "招聘JD"

    # 调用 API
    response = await call_hrrule_api(
        api_key=os.getenv('HRRULE_API_KEY'),
        content=message,
        tag_id=tag_id,
        rt=rt,
        on_chunk=lambda text: send_to_dingtalk(text)  # 实时发送到 DingTalk
    )

    return response

# 执行
response = asyncio.run(handle_dingtalk_message(message))
```

### QQ Integration

Similar to DingTalk, parse the QQ message and call the API:

```python
async def handle_qq_message(message: str):
    # 解析请求
    tag_id, rt = parse_request(message)

    # 调用 API
    response = await call_hrrule_api(
        api_key='your-api-key',
        content=message,
        tag_id=tag_id,
        rt=rt,
        on_chunk=lambda text: send_to_qq(text)
    )

    return response
```

## Summary

This skill provides **direct API integration** with the HRrule AI platform, enabling WorkBuddy to:
- Automatically parse HR requests
- Select appropriate parameters (tag_id, rt)
- Call WebSocket API in real-time
- Stream responses back to users
- Handle errors gracefully

The skill is designed for seamless integration with chat platforms like DingTalk and QQ, making it easy to generate HR documents on demand.

## Reference Materials

- API Reference: `references/api_reference.md`
- Example Prompts: `references/example_prompts.md`
- Usage Guide: `README.md`
- Test Page: `assets/chat_example.html`
- Original Test: `test_open_chat.html`