logistics-development

Design and extend logistics adapters for Taiwan providers using the @rytass/logistics base package.

6|3|Updated Apr 8, 2022
One-click install
npx skills add https://github.com/Rytass/Utils --skill logistics-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: logistics-development
Source: https://github.com/Rytass/Utils/tree/main/.claude/skills/logistics-development
Command: npx skills add https://github.com/Rytass/Utils --skill logistics-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill offers a structured guide for building and extending the @rytass/logistics base package, enabling developers to create robust adapters, define consistent interfaces, and implement standardized error handling for Taiwan logistics providers.

Core Features & Use Cases

  • Standardized service interfaces: LogisticsService and LogisticsInterface to ensure consistent adapter behavior across providers.
  • Error handling patterns: Common error codes and handling strategies for not-found, permission, and invalid parameters.
  • Use case: When integrating a new carrier, follow the guide to implement status mappings and export a ready-to-use adapter configuration.

Quick Start

Clone the base repository, implement a new adapter class following the base interfaces, map statuses, wire environment config, and run unit tests.

Frequently Asked Questions about logistics-development

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

FAQPage Schema
How do I build a logistics adapter for a new Taiwan carrier in TypeScript?

To build a logistics adapter for a new Taiwan carrier, implement a new adapter class following the base LogisticsInterface, map delivery statuses, wire environment configurations, and export a ready-to-use adapter configuration. The base package enforces a consistent API surface and standardized error handling.

What are standardized logistics service interfaces and why are they needed?

Standardized logistics service interfaces, specifically LogisticsService and LogisticsInterface, ensure consistent adapter behavior across different Taiwan logistics providers. They provide a uniform API surface so that integrating a new carrier requires only implementing the defined status mappings and error handling patterns.

How should I handle API errors when integrating Taiwan logistics providers?

When integrating Taiwan logistics providers, handle API errors using standardized patterns for common error codes including not-found, permission denied, and invalid parameters. The base package guide defines these handling strategies to ensure robust and consistent error management across all adapters.

Does this logistics development guide support TypeScript adapter implementation?

Yes, this logistics development guide fully supports TypeScript adapter implementation. It enables developers to design and extend the base package using TypeScript, defining consistent interfaces and applying standardized error handling for Taiwan logistics providers in real projects.

What's the best way to map delivery statuses across different logistics providers?

The best way to map delivery statuses across different logistics providers is to follow the base package guide to implement standardized status mappings within your adapter class. This enforces a consistent API surface and ensures uniform behavior across all integrated Taiwan logistics carriers.