Mantis 管理器:高级缺陷跟踪自动化 - Openclaw Skills

作者:互联网

2026-04-17

AI快讯

什么是 Mantis 管理器?

Mantis 管理器是为 AI 编程助手设计的高性能集成工具,通过官方 REST API 提供对 Mantis 缺陷跟踪系统的全面编程控制。此技能使开发者和智能体能够处理软件缺陷和项目需求的整个生命周期,从初始报告到最终解决。通过将其纳入您的 Openclaw Skills 库,您将能够精确且快速地管理复杂的缺陷跟踪工作流。

该技能的核心优势在于其复杂的上下文感知能力。它允许在不同的 Mantis 环境(如生产、预发布或特定的客户端实例)之间进行无缝切换,而无需修改硬编码配置。无论您是管理成千上万个问题还是协调项目迁移,Mantis 管理器都能为现代 DevOps 环境提供所需的技术深度。

下载入口:https://github.com/openclaw/skills/tree/main/skills/willykinfoussia/mantis-manager

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install mantis-manager

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 mantis-manager。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Mantis 管理器 应用场景

  • 在多个项目中自动创建、更新和监控缺陷报告。
  • 在不同的 Mantis 实例之间同步项目结构、版本和用户权限。
  • 通过在单个会话中查询多个客户端安装环境,生成统一的状态报告。
  • 在大批量分流期间执行批量操作,如状态更改或处理人分配。
  • 审计用户活动并为自动化系统集成管理 API 令牌。
Mantis 管理器 工作原理
  1. 该技能使用解析层级评估目标 Mantis 环境,优先考虑临时或会话定义的 URL 和令牌,而非全局环境变量。
  2. 它通过使用解析后的 Bearer 令牌构建标准化的 Authorization 标头来建立安全连接。
  3. 智能体将用户查询映射到针对问题、项目、用户或配置管理的特定 REST API 端点。
  4. 它处理复杂的数据类型,包括 base64 编码的文件附件和 ISO 8601 格式的时间跟踪备注。
  5. 系统维持动态运行时上下文,允许其记住特定于会话的实例设置,或在执行后自动清除一次性覆盖设置。

Mantis 管理器 配置指南

要将此工具与您的 Openclaw Skills 设置集成,请在终端或配置文件中定义所需的环境变量:

export MANTIS_BASE_URL="https://your-mantis-instance.com/api/rest"
export MANTIS_API_TOKEN="your_personal_access_token"

确保您的网络可以访问 Mantis REST API,并且您的 API 令牌对于您希望自动化的项目具有必要的访问权限(例如:更新者、开发者或管理者)。

Mantis 管理器 数据架构与分类体系

Mantis 管理器根据官方 Mantis REST API 分类组织数据。主要数据实体包括:

实体 关键数据字段
问题 (Issues) 摘要、描述、类别、项目、状态、优先级、处理人、标签、自定义字段
项目 (Projects) 名称、描述、状态、已启用、视图状态、子项目
用户 (Users) 用户名、电子邮件、真实姓名、访问级别、已启用、受保护
版本 (Versions) 名称、描述、已发布、已废弃、时间戳
备注 (Notes) 文本、视图状态、时间跟踪(PT#H#M 格式)、附件
过滤器 (Filters) 过滤器 ID、项目 ID、用户 ID

name: mantis-manager description: Manage Mantis Bug Tracker (issues, projects, users, filters, configs) via the official Mantis REST API. Supports full CRUD operations on issues, projects, users, attachments, notes, tags, relationships, and configuration management. Features dynamic instance switching with context-aware base URL and token resolution. homepage: https://www.mantisbt.org/ metadata: {"openclaw":{"emoji":"??","requires":{"env":["MANTIS_BASE_URL","MANTIS_API_TOKEN"]},"primaryEnv":"MANTIS_API_TOKEN"}}

Mantis Manager Skill (Enhanced)

?? Base URL & Token Resolution

Base URL Resolution

Base URL precedence (highest to lowest):

  1. temporary_base_url — one-time use URL for specific operations
  2. user_base_url — user-defined URL for the current session
  3. MANTIS_BASE_URL — environment default URL

This allows you to:

  • Switch between multiple Mantis instances dynamically
  • Test against staging/production environments
  • Work with different client instances without changing config

Example:

// Default: uses MANTIS_BASE_URL from environment
GET {{resolved_base_url}}/issues

// Override for one operation:
temporary_base_url = "https://mantis-staging.example.com/api/rest"
GET {{resolved_base_url}}/issues

// Override for session:
user_base_url = "https://client-mantis.example.com/api/rest"
GET {{resolved_base_url}}/issues

Token Resolution

Token precedence (highest to lowest):

  1. temporary_token — one-time use token for specific operations
  2. user_token — user-defined token for the current session
  3. MANTIS_API_TOKEN — environment default token

Environment variables are handled via standard OpenClaw metadata: requires.env declares required variables (MANTIS_BASE_URL, MANTIS_API_TOKEN). Any other environment variables you use for Mantis should be treated as normal process env vars and are not modeled as special OpenClaw metadata fields.

Authentication Headers

All API requests must include:

Authorization: Bearer {{resolved_token}}
Content-Type: application/json

Note: The {{resolved_base_url}} and {{resolved_token}} are determined at runtime based on the precedence rules above.


?? Notation Used in Examples

Throughout this documentation:

  • {{MANTIS_BASE_URL}} refers to the resolved base URL (could be temporary_base_url, user_base_url, or env MANTIS_BASE_URL)
  • {{resolved_token}} refers to the resolved token (could be temporary_token, user_token, or env MANTIS_API_TOKEN)
  • All endpoints use the pattern: {{MANTIS_BASE_URL}}/resource/path

Important: Always use the resolution logic to determine the actual URL and token at runtime.


?? Context Management

The temporary_* and user_* names here are runtime context variables used by the skill logic, not OpenClaw metadata fields. OpenClaw does not define an optional.context metadata key; context is resolved dynamically at runtime as described below.

Setting Temporary Values (One-Time Use)

User queries:

  • "Use https://staging.mantis.com/api/rest for this request"
  • "Connect to production instance for this operation"
  • "Use token ABC123 just this once"

Action:

Set temporary_base_url = "https://staging.mantis.com/api/rest"
Set temporary_token = "ABC123"
... perform operation ...
Clear temporary_base_url
Clear temporary_token

Behavior: Temporary values are automatically cleared after one use.

Setting Session Values (Current Session)

User queries:

  • "Switch to client XYZ's Mantis instance"
  • "Use my personal API token for all requests"
  • "Connect to staging environment"

Action:

Set user_base_url = "https://client-xyz.mantis.com/api/rest"
Set user_token = "personal_token_123"
... perform multiple operations ...
// Values persist for the entire session

Behavior: Session values persist until explicitly cleared or session ends.

Clearing Context Values

User queries:

  • "Reset to default Mantis instance"
  • "Clear my custom token"
  • "Go back to environment defaults"

Action:

Clear user_base_url
Clear user_token
// Now uses MANTIS_BASE_URL and MANTIS_API_TOKEN from environment

Viewing Current Context

User queries:

  • "What Mantis instance am I connected to?"
  • "Show current API configuration"
  • "Which token am I using?"

Response should show:

Current Context:
- Base URL: https://client-xyz.mantis.com/api/rest (user_base_url)
- Token: user_t***123 (user_token)
- Fallback Base URL: https://default.mantis.com/api/rest (MANTIS_BASE_URL)
- Fallback Token: env_t***789 (MANTIS_API_TOKEN)

Use Cases

Multi-Instance Management

// Check production issue
Set temporary_base_url = "https://prod.mantis.com/api/rest"
Get issue 123

// Check staging issue  
Set temporary_base_url = "https://staging.mantis.com/api/rest"
Get issue 123

// Compare results

Client Switching

// Switch to Client A
Set user_base_url = "https://clienta.mantis.com/api/rest"
Set user_token = "clienta_token"
List all projects
Get issues for project 5

// Switch to Client B
Set user_base_url = "https://clientb.mantis.com/api/rest"
Set user_token = "clientb_token"
List all projects
Get issues for project 3

Admin Operations with Impersonation

// Connect to main instance as admin
Set user_token = "admin_token"

// Perform operation as specific user
Set temporary header: X-Impersonate-User = "john.doe"
Get user issues

// Back to admin
Clear temporary header

?? ISSUES Operations

List Issues

User queries:

  • "List all issues"
  • "Get issues for project 5"
  • "Get issues matching filter 10"
  • "Show issues assigned to me"
  • "Get unassigned issues"

Actions:

GET {{MANTIS_BASE_URL}}/issues

Query Parameters:

  • page_size — number of issues per page (default: 50)
  • page — page number (1-indexed)
  • filter_id — ID of saved filter to apply
  • project_id — filter by specific project
  • select — comma-separated fields to return (e.g., "id,summary,status")

Special endpoints:

GET {{MANTIS_BASE_URL}}/issues?filter_id={{filter_id}}
GET {{MANTIS_BASE_URL}}/projects/{{project_id}}/issues

Get Single Issue

User queries:

  • "Show issue 123"
  • "Get details for bug 456"

Action:

GET {{MANTIS_BASE_URL}}/issues/{{id}}

Create Issue

User queries:

  • "Create issue with summary 'Login bug' and description 'Cannot login'"
  • "Create bug in project 5 with priority high"
  • "Create issue with attachments"

Action:

POST {{MANTIS_BASE_URL}}/issues

Minimal body:

{
  "summary": "Issue summary",
  "description": "Detailed description",
  "category": {"name": "General"},
  "project": {"id": 1}
}

Full body (optional fields):

{
  "summary": "Issue summary",
  "description": "Detailed description",
  "steps_to_reproduce": "1. Do this
2. Do that",
  "additional_information": "Extra info",
  "category": {"id": 1, "name": "General"},
  "project": {"id": 1},
  "priority": {"id": 30, "name": "normal"},
  "severity": {"id": 50, "name": "minor"},
  "status": {"id": 10, "name": "new"},
  "reproducibility": {"id": 10, "name": "always"},
  "handler": {"id": 5},
  "tags": [{"name": "bug"}, {"name": "ui"}],
  "custom_fields": [{"field": {"id": 1}, "value": "custom value"}],
  "due_date": "2026-12-31T23:59:59+00:00",
  "version": {"name": "1.0"},
  "target_version": {"name": "2.0"}
}

Create with attachments:

POST {{MANTIS_BASE_URL}}/issues

Include files array in body with base64-encoded content.

Update Issue

User queries:

  • "Update issue 123 status to resolved"
  • "Change priority of bug 456 to high"
  • "Assign issue 789 to user 10"

Action:

PATCH {{MANTIS_BASE_URL}}/issues/{{id}}

Example body:

{
  "status": {"name": "resolved"},
  "handler": {"id": 10},
  "priority": {"name": "high"},
  "summary": "Updated summary"
}

Delete Issue

User queries:

  • "Delete issue 123"
  • "Remove bug 456"

Action:

DELETE {{MANTIS_BASE_URL}}/issues/{{id}}

Monitor/Unmonitor Issue

User queries:

  • "Monitor issue 123"
  • "Stop monitoring bug 456"
  • "Add user 10 as monitor on issue 789"

Actions:

POST   {{MANTIS_BASE_URL}}/issues/{{id}}/monitors
DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/monitors

Body (for specific user):

{
  "user": {"id": 10}
}

Attach/Detach Tags

User queries:

  • "Add tag 'critical' to issue 123"
  • "Remove tag 'bug' from issue 456"

Actions:

POST   {{MANTIS_BASE_URL}}/issues/{{id}}/tags
PATCH  {{MANTIS_BASE_URL}}/issues/{{id}}/tags
DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/tags

Body:

{
  "tags": [
    {"name": "bug"},
    {"name": "critical"}
  ]
}

Add Issue Relationship

User queries:

  • "Link issue 123 to issue 456 as duplicate"
  • "Add parent relationship from 789 to 101"

Action:

POST {{MANTIS_BASE_URL}}/issues/{{id}}/relationships

Body:

{
  "type": {"name": "duplicate-of"},
  "target_issue": {"id": 456}
}

Relationship types:

  • duplicate-of
  • related-to
  • parent-of
  • child-of
  • has-duplicate

Attach Files

User queries:

  • "Attach file to issue 123"
  • "Add screenshot to bug 456"

Action:

POST {{MANTIS_BASE_URL}}/issues/{{id}}/files

Body:

{
  "files": [
    {
      "name": "screenshot.png",
      "content": "base64_encoded_content_here"
    }
  ]
}

Delete Attachment

User queries:

  • "Delete attachment 789 from issue 123"
  • "Remove file 101 from bug 456"

Action:

DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/files/{{file_id}}

Issue Notes

Add Note

User queries:

  • "Add note to issue 123: 'This is fixed now'"
  • "Add note with time tracking 2 hours"
  • "Add private note to bug 456"

Action:

POST {{MANTIS_BASE_URL}}/issues/{{id}}/notes

Body:

{
  "text": "Note content here",
  "view_state": {"name": "public"},
  "time_tracking": "PT2H30M"
}

With attachment:

{
  "text": "Note with file",
  "files": [
    {
      "name": "log.txt",
      "content": "base64_content"
    }
  ]
}

Delete Note

User queries:

  • "Delete note 55 from issue 123"
  • "Remove comment 99 from bug 456"

Action:

DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/notes/{{note_id}}

?? PROJECTS Operations

List All Projects

User queries:

  • "List all projects"
  • "Show all projects"
  • "Get projects"

Action:

GET {{MANTIS_BASE_URL}}/projects

Get Project by ID

User queries:

  • "Show project 5"
  • "Get details for project 10"

Action:

GET {{MANTIS_BASE_URL}}/projects/{{id}}

Create Project

User queries:

  • "Create project named 'New Product'"
  • "Add project with description 'Internal tools'"

Action:

POST {{MANTIS_BASE_URL}}/projects

Body:

{
  "name": "Project Name",
  "description": "Project description",
  "enabled": true,
  "inherit_global": true,
  "view_state": {"name": "public"},
  "status": {"name": "development"}
}

Update Project

User queries:

  • "Update project 5 description"
  • "Change project 10 status to stable"

Action:

PATCH {{MANTIS_BASE_URL}}/projects/{{id}}

Delete Project

User queries:

  • "Delete project 5"
  • "Remove project 10"

Action:

DELETE {{MANTIS_BASE_URL}}/projects/{{id}}

Sub-Projects

Get Sub-Projects

User queries:

  • "Show sub-projects of project 5"

Action:

GET {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects

Create Sub-Project

User queries:

  • "Create sub-project under project 5"

Action:

POST {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects

Body:

{
  "subproject": {"id": 10}
}

Delete Sub-Project

Action:

DELETE {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects/{{subproject_id}}

Project Users

Get Project Users

User queries:

  • "Show users in project 5"
  • "List members of project 10"

Action:

GET {{MANTIS_BASE_URL}}/projects/{{id}}/users

Add User to Project

User queries:

  • "Add user 20 to project 5 as developer"

Action:

POST {{MANTIS_BASE_URL}}/projects/{{id}}/users

Body:

{
  "user": {"id": 20},
  "access_level": {"name": "developer"}
}

Access levels:

  • viewer (10)
  • reporter (25)
  • updater (40)
  • developer (55)
  • manager (70)
  • administrator (90)

Delete User from Project

Action:

DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/users/{{user_id}}

Project Versions

Get Versions

User queries:

  • "Show versions of project 5"
  • "List releases for project 10"

Action:

GET {{MANTIS_BASE_URL}}/projects/{{id}}/versions

Create Version

User queries:

  • "Create version 2.0 for project 5"
  • "Add release 1.5 to project 10"

Action:

POST {{MANTIS_BASE_URL}}/projects/{{id}}/versions

Body:

{
  "name": "2.0",
  "description": "Major release",
  "released": true,
  "obsolete": false,
  "timestamp": "2026-06-01T00:00:00+00:00"
}

Update Version

Action:

PATCH {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}}

Delete Version

Action:

DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}}

?? USERS Operations

Get My User Info

User queries:

  • "Show my user info"
  • "Get my profile"
  • "Who am I?"

Action:

GET {{MANTIS_BASE_URL}}/users/me

Get User by ID

User queries:

  • "Show user 10"
  • "Get info for user 25"

Action:

GET {{MANTIS_BASE_URL}}/users/{{id}}

Get User by Username

User queries:

  • "Find user 'john.doe'"
  • "Get user with username 'admin'"

Action:

GET {{MANTIS_BASE_URL}}/users?name={{username}}

Create User

User queries:

  • "Create user 'jane.smith' with email 'jane@example.com'"
  • "Add new user"

Action:

POST {{MANTIS_BASE_URL}}/users

Minimal body:

{
  "username": "jane.smith",
  "email": "jane@example.com",
  "access_level": {"name": "reporter"}
}

Full body:

{
  "username": "jane.smith",
  "password": "SecurePass123!",
  "real_name": "Jane Smith",
  "email": "jane@example.com",
  "access_level": {"name": "developer"},
  "enabled": true,
  "protected": false
}

Update User

User queries:

  • "Update user 10 email to 'new@example.com'"
  • "Change user 25 access level to developer"

Action:

PATCH {{MANTIS_BASE_URL}}/users/{{id}}

Body:

{
  "real_name": "Updated Name",
  "email": "new@example.com",
  "access_level": {"name": "developer"},
  "enabled": false
}

Reset User Password

User queries:

  • "Reset password for user 10"

Action:

PUT {{MANTIS_BASE_URL}}/users/{{id}}/reset-password

Body:

{
  "password": "NewSecurePassword123!"
}

Delete User

User queries:

  • "Delete user 10"
  • "Remove user 'john.doe'"

Action:

DELETE {{MANTIS_BASE_URL}}/users/{{id}}

?? FILTERS Operations

Get All Filters

User queries:

  • "List all filters"
  • "Show my saved filters"

Action:

GET {{MANTIS_BASE_URL}}/filters

Get Filter by ID

User queries:

  • "Show filter 5"
  • "Get details for filter 10"

Action:

GET {{MANTIS_BASE_URL}}/filters/{{id}}

Delete Filter

User queries:

  • "Delete filter 5"
  • "Remove saved filter 10"

Action:

DELETE {{MANTIS_BASE_URL}}/filters/{{id}}

?? TOKEN MANAGEMENT

Create Token for Self

User queries:

  • "Create my API token"
  • "Generate token for me"
  • "Create new token named 'automation'"

Action:

POST {{MANTIS_BASE_URL}}/user_tokens

Body:

{
  "name": "automation_token",
  "date_expiry": "2027-12-31T23:59:59+00:00"
}

Delete Token for Self

User queries:

  • "Delete my token"
  • "Revoke my API token"

Action:

DELETE {{MANTIS_BASE_URL}}/user_tokens/{{token_id}}

Create Token for Another User

User queries:

  • "Create token for user 10"
  • "Generate API token for user 'john.doe'"

Action:

POST {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens

Body:

{
  "name": "user_token",
  "date_expiry": "2027-12-31T23:59:59+00:00"
}

Delete Token for Another User

Action:

DELETE {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens/{{token_id}}

?? CONFIG Operations

Get Single Configuration Option

User queries:

  • "Get config option 'bug_report_page_fields'"
  • "Show configuration for 'default_category_for_moves'"

Action:

GET {{MANTIS_BASE_URL}}/config/{{option}}

Get Multiple Configuration Options

User queries:

  • "Get configs for project 5"
  • "Show all config options"

Action:

GET {{MANTIS_BASE_URL}}/config

Query parameters:

  • option — specific option name
  • project_id — filter by project
  • user_id — filter by user

Set Configuration Option

User queries:

  • "Set config 'allow_signup' to true"
  • "Update config option"

Action:

PATCH {{MANTIS_BASE_URL}}/config

Body:

{
  "configs": [
    {
      "option": "allow_signup",
      "value": "1"
    }
  ]
}

?? LOCALIZATION Operations

Get Localized String

User queries:

  • "Get localized string 'status_new'"
  • "Translate 'priority_high' to French"

Action:

GET {{MANTIS_BASE_URL}}/lang/{{string}}

Query parameter:

  • language — language code (e.g., 'fr', 'en', 'de')

Get Multiple Localized Strings

User queries:

  • "Get all status translations"
  • "Get localized strings for priorities"

Action:

GET {{MANTIS_BASE_URL}}/lang

Query parameters:

  • strings — comma-separated list of string keys
  • language — language code

?? IMPERSONATION

Get User Info with Impersonation

User queries:

  • "Impersonate user 10 and get their info"
  • "Get info as user 'john.doe'"

Action:

GET {{MANTIS_BASE_URL}}/users/me

Header:

X-Impersonate-User: {{username_or_id}}

?? Error Handling

Handle HTTP errors gracefully:

401 Unauthorized:

  • Token is invalid or expired
  • Action: Inform user to check MANTIS_API_TOKEN or provide valid temporary_token

403 Forbidden:

  • User doesn't have permission for this operation
  • Action: Inform user about insufficient permissions

404 Not Found:

  • Resource (issue, project, user, etc.) doesn't exist
  • Action: Inform user that the requested resource was not found

422 Unprocessable Entity:

  • Validation error in request body
  • Action: Show validation errors from response and guide user

500 Internal Server Error:

  • Server-side error
  • Action: Inform user of server error and suggest retrying later

General error response format:

{
  "message": "Error description",
  "code": 1234,
  "localized": "Localized error message"
}

?? Best Practices

Pagination

  • Always support page_size and page parameters for list operations
  • Default page size: 50
  • Inform user when results are paginated

Field Selection

  • Use select parameter to return only needed fields
  • Example: select=id,summary,status,priority
  • Reduces bandwidth and improves performance

Filtering

  • Use filter_id to apply saved filters
  • Combine with pagination for large datasets
  • Consider project-specific filtering with project_id

Attachments

  • Files must be base64-encoded
  • Include filename and content in request
  • Verify file size limits (check Mantis config)

Time Tracking

  • Use ISO 8601 duration format: PT2H30M (2 hours 30 minutes)
  • Can be added to notes for time tracking

Date Formats

  • Use ISO 8601: 2026-12-31T23:59:59+00:00
  • Include timezone for accuracy

Custom Fields

  • Check project configuration for available custom fields
  • Reference by field ID in requests

Relationships

  • Verify relationship types supported by your Mantis version
  • Some relationships auto-create reciprocal links

?? Quick Examples

Create and Monitor Issue

1. POST /issues with summary and description
2. POST /issues/{{new_id}}/monitors to monitor

Assign Issue and Add Note

1. PATCH /issues/{{id}} with handler
2. POST /issues/{{id}}/notes with assignment comment

Create Project with Version

1. POST /projects with project details
2. POST /projects/{{id}}/versions with version info

User Management Flow

1. POST /users to create user
2. POST /projects/{{id}}/users to add to project
3. POST /users/{{id}}/tokens to create API token

?? Advanced Use Cases

Bulk Issue Updates

When updating multiple issues:

  • Loop through issue IDs
  • Use PATCH for each issue
  • Collect results and report summary

Filter-Based Operations

Get all high-priority bugs:

1. GET /filters to find priority filter ID
2. GET /issues?filter_id={{filter_id}}&page_size=100
3. Process paginated results

Project Migration

Copy project structure:

1. GET /projects/{{source_id}} to get project details
2. GET /projects/{{source_id}}/versions for versions
3. POST /projects to create new project
4. POST /projects/{{new_id}}/versions for each version

User Audit

Track user activity:

1. GET /issues?reporter_id={{user_id}}
2. GET /issues?handler_id={{user_id}}
3. GET /issues?monitor_id={{user_id}}
4. Compile activity report

Multi-Instance Management

Work with multiple Mantis instances:

// Scenario: Compare issue status across environments

1. Check production:
   Set temporary_base_url = "https://prod.mantis.com/api/rest"
   Set temporary_token = "prod_token"
   GET /issues/123
   Record status

2. Check staging:
   Set temporary_base_url = "https://staging.mantis.com/api/rest"
   Set temporary_token = "staging_token"
   GET /issues/123
   Record status

3. Compare and report differences

Cross-Instance Synchronization

Sync data between instances:

// Scenario: Clone project from one instance to another

1. Connect to source instance:
   Set user_base_url = "https://source.mantis.com/api/rest"
   Set user_token = "source_token"
   GET /projects/5 (get project details)
   GET /projects/5/versions (get versions)
   GET /projects/5/users (get users)

2. Connect to target instance:
   Set user_base_url = "https://target.mantis.com/api/rest"
   Set user_token = "target_token"
   POST /projects (create project)
   POST /projects/{{new_id}}/versions (create versions)
   POST /projects/{{new_id}}/users (add users)

3. Report sync results

Client-Specific Operations

Manage multiple client instances:

// Scenario: Daily status report for all clients

For each client in [ClientA, ClientB, ClientC]:
  1. Set user_base_url = client.mantis_url
  2. Set user_token = client.api_token
  3. GET /issues?filter_id=1 (get today's issues)
  4. Collect statistics
  5. Clear context

Generate consolidated report

?? Resources

  • Mantis API Documentation: Check your Mantis instance at {{MANTIS_BASE_URL}}/api/rest/swagger.yaml
  • Issue Statuses: new, feedback, acknowledged, confirmed, assigned, resolved, closed
  • Priorities: none, low, normal, high, urgent, immediate
  • Severities: feature, trivial, text, tweak, minor, major, crash, block
  • Access Levels: 10=viewer, 25=reporter, 40=updater, 55=developer, 70=manager, 90=administrator

? Skill Capabilities Summary

This skill enables you to:

Core Operations

  • ? Full CRUD operations on issues
  • ? Manage issue relationships, tags, monitors
  • ? Add notes with time tracking and attachments
  • ? Full project management (create, update, delete)
  • ? Manage sub-projects, versions, and project users
  • ? User management (CRUD, password reset)
  • ? API token management (create, delete for self and others)
  • ? Filter management and filtered queries
  • ? Configuration management
  • ? Localization support
  • ? Impersonation capabilities

Advanced Features

  • ? Dynamic instance switching — Switch between multiple Mantis instances on-the-fly
  • ? Context-aware URL resolution — temporary_base_url → user_base_url → MANTIS_BASE_URL
  • ? Context-aware token resolution — temporary_token → user_token → MANTIS_API_TOKEN
  • ? Multi-instance management — Manage multiple clients/environments simultaneously
  • ? Cross-instance operations — Compare, sync, and migrate data between instances
  • ? Comprehensive error handling
  • ? Pagination and field selection
  • ? Advanced workflows and bulk operations