maa-logging

Standardize Python logging rules and user-facing message separation in MaaNTE agent code.

2.6k|191|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/1bananachicken/MaaNTE --skill maa-logging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maa-logging
Source: https://github.com/1bananachicken/MaaNTE/tree/main/.claude/skills/maa-logging
Command: npx skills add https://github.com/1bananachicken/MaaNTE --skill maa-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about maa-logging

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

FAQPage Schema
How do I standardize Python logging in MaaNTE to prevent debug info leaking to users?▼

To standardize Python logging in MaaNTE, use the logger object strictly for developer logs and the maafocus module for user-facing messages, ensuring debug info does not leak in MXU mode.

What is the correct way to format log messages in the MaaNTE Python codebase?▼

The correct way to format log messages in MaaNTE is using percent-style formatting. You must avoid f-strings for log formatting to comply with project code standards.

How do I add compliant log outputs when modifying MaaNTE agent module code?▼

When modifying MaaNTE agent module code, add compliant log outputs by following specified log level selection rules and avoiding print() for user notifications.

Can I use print() for user notifications in MaaNTE Python development?▼

No, you cannot use print() for user notifications in MaaNTE. You should use the maafocus module for user-facing messages to maintain clear separation from developer logs.

Does MaaNTE logging support console output in MXU mode?▼

MaaNTE logging defines specific MXU mode console output behavior to ensure compliant outputs. It enforces strict boundaries to prevent developer logs from appearing in user-facing console outputs.