GitHub Copilot 代码注释与教程生成技能 - 自动重构Python代码并生成教学文档

🇺🇸English

Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.

1. Refactor the code

   • Apply standard Python best practices
   • Ensure code follows the PEP 8 style guide
   • Rename unclear variables and functions if needed for clarity

2. Add comments throughout the code

   • Use a beginner-friendly, instructional tone
   • Explain what each part of the code is doing and why it's important
   • Focus on the logic and reasoning, not just syntax
   • Avoid redundant or superficial comments

3. Generate a tutorial as aREADME.md file
   Include the following sections:

   • Project Overview: What the script does and why it's useful
   • Setup Instructions: Prerequisites, dependencies, and how to run the script
   • How It Works: A breakdown of the code logic based on the comments
   • Example Usage: A code snippet showing how to use it
   • Sample Output: (Optional) Include if the script returns visible results
   • Use clear, readable Markdown formatting

Weekly Installs

7.3K

Repository

github/awesome-copilot

GitHub Stars

26.7K

First Seen

Feb 25, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

codex7.2K

gemini-cli7.2K

opencode7.2K

cursor7.2K

github-copilot7.2K

kimi-cli7.2K