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.