item-transfer

Adds new transferable items to the ItemTransfer task configuration and locale files.

3.7k|317|Updated Mar 18, 2022
One-click install
npx skills add https://github.com/MaaEnd/MaaEnd --skill item-transfer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: item-transfer
Source: https://github.com/MaaEnd/MaaEnd/tree/main/.agents/skills/item-transfer
Command: npx skills add https://github.com/MaaEnd/MaaEnd --skill item-transfer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adding a new item to the MaaEnd ItemTransfer (库存转移) automation task requires coordinated, order-sensitive edits across a task JSON file, an item-order data file, and five locale files. This Skill guides the AI through that multi-file insertion workflow without breaking JSON structure or ordering invariants.

Core Features & Use Cases

  • Order-aware insertion: Inserts new item entries into assets/tasks/ItemTransfer.json and five locale files (zh_cn, zh_tw, en_us, ja_jp, ko_kr) at positions derived from category_order in item_order.json.
  • Four pipeline templates: Selects the correct pipeline_override template based on recognition mode (model-based vs pure OCR) and sort direction (ascending vs descending).
  • Class ID safety rules: Looks up real model class IDs from the items table for recognizable items and forbids inventing IDs, falling back to OCR when no class exists.
  • Use Case: A user says "给库存转移加 xxx" after inserting the item name into category_order; the Skill then writes the locale keys and the correct case object into ItemTransfer.json and runs a self-check checklist.

Quick Start

Tell the AI to add a specific new item to the ItemTransfer task, stating whether it is model-recognizable or pure OCR and whether it sorts ascending or descending.

Frequently Asked Questions about item-transfer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new item to the ItemTransfer task in MaaEnd?

First insert the item's Chinese name into category_order in assets/data/ItemTransfer/item_order.json at its in-game position. Then tell the AI whether the item is model-recognizable or pure OCR and its sort direction, and it will update the task JSON and five locale files.

What files must be updated when adding an ItemTransfer item?

Three groups of files: assets/tasks/ItemTransfer.json (a new case in option.WhatToTransfer.cases), and the five locale files zh_cn, zh_tw, en_us, ja_jp, ko_kr with a new item.* key. The item_order.json category_order is edited manually by the user beforehand.

When should I use pure OCR instead of model recognition for an item?

Use pure OCR when the item has no trained classification model entry in the items table of item_order.json, which is common for newly released items. Model recognition with expected/target_class IDs only works for items already present in that table.

Can I add a new class ID to the items table myself?

No. The items field contains real class IDs from the recognition model and is maintained only by developers during model retraining. If an item lacks an entry, you must use the pure OCR template instead of inventing an ID.

Why does only one pipeline node have the descending flag?

Sort direction only applies to repository-side lookup, so descending: true appears only on ItemTransferFindItemWithOCR or ItemTransferFindItemFallback. The bag and bag-return branches have no sort concept and intentionally omit the field.