| name | redmine-search |
| description | Redmine 访问 Skill，仅查询指派给我的工单，提供通过 API Token 认证方式访问 Redmine 系统的功能。 |
Redmine 访问 Skill（仅指派给我）
请先获取环境变量中 token 的值，保存在上下文中，方便后续调用 API 时使用。
连接信息
| 项目 | 值 |
|---|
| 服务器地址 | https://redmine-skgd3-local.housei-inc.com |
| 认证方式 | API Token |
| Token 来源 | 环境变量 REDMINE_API_TOKEN |
安全提示：Token 从环境变量 REDMINE_API_TOKEN 读取，请确保已在系统环境变量中设置。
读取方式：
-
Windows
$env:REDMINE_API_TOKEN
-
Linux/Mac
echo $REDMINE_API_TOKEN
前置条件
- 已在系统环境变量中设置
REDMINE_API_TOKEN，值为有效的 Redmine API Token。
认证方法（二选一）
- Header 方式（推荐）：
X-Redmine-API-Key: <token>
- URL 参数方式：
?key=<token>
API 端点
| 用途 | 方法 | 端点 | 说明 |
|---|
| 单票详情 | GET | /issues/{id}.json | 获取指定工单的完整信息 |
| 工单列表 | GET | /issues.json | 支持筛选、分页 |
| 项目工单 | GET | /projects/{project_id}/issues.json | 获取指定项目的工单 |
常用筛选参数（默认指派给我，可按提示指定指派人）
| 参数 | 示例值 | 说明 |
|---|
status_id | open, closed, * | 工单状态筛选 |
assigned_to_id | me, {user_id} | 指派人筛选（默认 me；提示词明确指定指派人时按指定值） |
limit | 25（默认）, 100（最大） | 每页条数 |
offset | 0, 25 | 分页偏移 |
sort | updated_on:desc | 排序 |
tracker_id | 1=Bug, 2=Feature | 跟踪器类型 |
priority_id | 1=低, 2=中, 3=高, 4=紧急 | 优先级 |
调用示例
GET /issues.json?assigned_to_id=me&status_id=open&limit=50&sort=updated_on:desc&key=$REDMINE_API_TOKEN
GET /issues/15400.json?key=$REDMINE_API_TOKEN
GET /issues.json?assigned_to_id=me&status_id=*&key=$REDMINE_API_TOKEN
实际调用时，使用 fetch_webpage 工具拼接 URL，Token 通过终端命令 $env:REDMINE_API_TOKEN 读取后填入。
返回数据结构要点
工单对象关键字段：
id - 工单编号subject - 标题status.name - 状态名priority.name - 优先级名tracker.name - 跟踪器名（Bug/Feature/Task等）assigned_to.name - 指派人description - 描述（可能含 Textile 标记）updated_on - 最后更新时间created_on - 创建时间
