skills/sakumyz/skills/redmine-search

redmine-search

SKILL.md

Redmine 访问 Skill(仅指派给我)

连接信息

项目
服务器地址 https://redmine-skgd3-local.housei-inc.com
认证方式 API Token
Token 来源 环境变量 REDMINE_API_TOKEN

安全提示:Token 从环境变量 REDMINE_API_TOKEN 读取,请确保已在系统环境变量中设置。 读取方式:使用 $env:REDMINE_API_TOKEN(PowerShell)或 %REDMINE_API_TOKEN%(CMD)获取。

认证方法(二选一)

  1. Header 方式(推荐)X-Redmine-API-Key: <token>
  2. 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=紧急 优先级

调用示例

# 获取所有未关闭且指派给我的工单(最多50条,按更新时间倒序)
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 - 创建时间
Weekly Installs
7
Repository
sakumyz/skills
First Seen
Feb 20, 2026
Installed on
opencode7
gemini-cli7
antigravity7
claude-code7
github-copilot7
codex7