---
name: chinaweal-pms
description: |
  众望通 PMS 系统数据查询工具。用于查询 PMS 系统中的待办任务数据。

  当用户提到以下场景时使用此 Skill：
  (1) 查询待办、待办详情、待办任务
  (2) 需要从 PMS 系统获取任务信息
  (3) 用户提到 "PMS"、"待办"、"todo"、"所有待办"、"未完成待办"
version: 1.0.0
license: Apache-2.0
metadata:
  author: lirh
  category: development
  tags:
    - pms
    - chinaweal
    - enterprise
    - todo
---

# Chinaweal PMS 系统查询

## 概述

此 Skill 用于查询众望通 PMS 系统（Project Management System）的数据。

## 认证配置

使用此 Skill 前，需要配置环境变量 `CHINAWEAL_PMS_TOKEN`：

- **环境变量名称**: `CHINAWEAL_PMS_TOKEN`
- **用途**: PMS 系统的用户授权 Token

### 请求鉴权方式

所有 API 请求需要在请求头中携带 Authorization 信息：

```
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
```

其中 `{CHINAWEAL_PMS_TOKEN}` 需要替换为环境变量 `CHINAWEAL_PMS_TOKEN` 的值。

## 功能清单

### 功能1: 查询所有未完成待办

查询当前用户的所有未完成待办任务列表。

**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all`

**请求方法**: GET

**请求头**:
```
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
Content-Type: application/json
```

**查询参数**:
- `status` - 任务状态，0 表示未完成

**响应关键字段**:
- `todoNo` - 待办编号
- `todoTitle` - 待办标题
- `todoDescription` - 待办描述
- `createTime` - 创建时间

**使用示例**

```
帮我查询所有待办
查询所有未完成的待办
看看我有哪些待办任务
我的待办有哪些
```

### 功能2: 查询待办详情

查询指定待办编号的详细信息。

**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/detail/{todoNo}`

**请求方法**: GET

**请求头**:
```
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
Content-Type: application/json
```

**路径参数**:
- `todoNo` - 待办编号

**响应关键字段**:
- `todoTitle` - 待办标题
- `todoDescription` - 待办任务的详情描述
- `todoAtt` - 待办附件下载地址清单（下载地址中包含 `filename` 参数，表示附件原名）

### 使用示例

```
帮我查询待办号 TODO2024030001 的详情
查询一下 todoNo 为 12345 的待办信息
```

### 调用方式

使用 exec 工具执行 curl 命令进行 API 调用。

**查询所有未完成待办**:
```bash
CHINAWEAL_PMS_TOKEN="your-token-here"

curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all" \
  -H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
  -H "Content-Type: application/json"
```

**查询单个待办详情**:
```bash
CHINAWEAL_PMS_TOKEN="your-token-here"
TODO_NO="TODO2024030001"

curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/detail/${TODO_NO}" \
  -H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
  -H "Content-Type: application/json"
```

## 注意事项

1. 确保环境变量 `CHINAWEAL_PMS_TOKEN` 已正确配置
2. 待办编号 `todoNo` 需要从 PMS 系统获取
3. 附件下载地址中包含 `filename` 参数，即为附件原文件名