comment-code-generate-a-tutorial
作成者: github
Pythonスクリプトを初心者向けのプロジェクトにリファクタリングし、教育的なコメントとマークダウンチュートリアルを追加します。PEP 8スタイルガイドに準拠し、標準的なPythonベストプラクティスを適用してコード品質を向上させます。コード全体に学習者向けのロジック、理由、重要性を説明する教育的なコメントを追加します。プロジェクト概要、セットアップ手順、コード解説、使用例、サンプル出力を含む完全なREADME.mdチュートリアルを生成します。不明瞭な変数名や関数名を明確にリネームします...
npx skills add https://github.com/github/awesome-copilot --skill comment-code-generate-a-tutorialTransform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.
-
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
-
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
-
Generate a tutorial as a
README.mdfile
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