Detailed Commenter

This skill ensures that all code generated or modified includes detailed and comprehensive comments.

Instructions

When writing or modifying code, you MUST:

Class-Level Comments: Add a detailed description above every class explaining its purpose, usage, and any key concepts.
Method-Level Comments: Add a description above every method explaining what it does, its parameters, return values, and any side effects.
Inline Comments: Add comments inside methods to explain complex logic, key steps, or specific variable assignments.
Language: Use the same language as the user's request (or the existing project language) for comments. Since the user specifically requested this in Chinese context, prioritize Chinese comments unless instructed otherwise.

Be Verbose: It is better to over-explain than under-explain.
Explain 'Why': Don't just explain what the code does (which is visible), explain why it does it that way.
Update Comments: If you modify code, ensure the surrounding comments are updated to reflect the changes.