go-service-guide

Implement Go-service components following MaaEnd MaaFramework integration patterns.

3.6k|298|Updated Mar 18, 2022
One-click install
npx skills add https://github.com/MaaEnd/MaaEnd --skill go-service-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: go-service-guide
Source: https://github.com/MaaEnd/MaaEnd/tree/main/.claude/skills/go-service-guide
Command: npx skills add https://github.com/MaaEnd/MaaEnd --skill go-service-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MaaEnd Go-service 编写指南提供统一的Go服务编写规范与架构参考,帮助开发者在 MaaEnd 框架下快速搭建、注册和维护 Go 语言服务组件,确保一致性与可维护性。

Core Features & Use Cases

  • 提供清晰的项目目录结构、注册机制和编译期检查模板,促进多包协作与快速上线。
  • 提供 Go-service 模板、示例代码和常见实现模式,降低新成员上手成本。
  • 适用于需要遵循 MaaFramework 约定的 agent/go-service 子系统的设计、实现和代码评审。

Quick Start

Apply this guide to scaffold and audit your agent/go-service package according to MaaFramework conventions.

Frequently Asked Questions about go-service-guide

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

FAQPage Schema
How do I register a Go service component in MaaFramework?▼

To register a Go service component in MaaFramework, apply the provided registration templates that enforce a clean separation between pipeline-driven logic and service orchestration. This guide ensures your registration complies with compile-time interface checks and naming conventions across agent/go-service sub-packages.

What is the correct project structure for a MaaFramework Go service?▼

A correct MaaFramework Go service structure separates pipeline-driven logic from service orchestration across sub-packages and shared utilities. This guide provides the standard project directory structure, registration mechanisms, and compile-time interface check templates to maintain consistency and enable multi-package collaboration.

How do I implement CustomAction and CustomRecognition templates in Go?▼

Implement CustomAction and CustomRecognition templates in Go by following the MaaFramework integration patterns provided in this guide. It ensures interface compatibility across shared utilities and enforces compile-time checks, along with specific 720p coordinate assumptions for your agent/go-service codebase.

Does the Go service guide require specific coordinate assumptions for interface compatibility?▼

Yes, the Go service guide requires 720p coordinate assumptions for interface compatibility. Following these coordinate assumptions alongside the provided templates for CustomAction, CustomRecognition, and EventSink ensures your agent/go-service components compile and operate correctly within MaaEnd.

Why do I need compile-time interface checks in a MaaFramework Go service?▼

Compile-time interface checks in a MaaFramework Go service are needed to verify interface compatibility across sub-packages and shared utilities before runtime. This guide applies compile-time interface checks alongside strict naming conventions to prevent integration errors between pipeline-driven logic and service orchestration.