maa-logging

What problem does it solve?

Inconsistent logging practices in MaaNTE's Python code lead to hard-to-debug issues, accidental exposure of debug information to end users, and non-compliant log outputs that fail to meet project maintenance requirements.

Core Features & Use Cases

• Clear Role Separation: Defines strict boundaries between developer-facing logs (via the logger object) and user-facing messages (via the maafocus module), preventing debug information from leaking to end users in MXU mode.
• Standardized Log Rules: Specifies log level usage, percent-style formatting requirements, MXU mode console output behavior, and sensitive information handling rules to ensure all logs follow project conventions.
• Use Case: When modifying Python code in MaaNTE's agent directory, use this Skill to add compliant log entries and user-facing messages, avoiding common mistakes like using print() for user notifications or f-strings for log formatting.

Quick Start

Use this Skill to add compliant log entries and user-facing messages when writing or modifying Python code in MaaNTE's agent directory.