メモ
- Copilot プロンプト ファイルはパブリック プレビュー段階であり、変更される可能性があります。 プロンプト ファイルは、VS Code でのみ使用できます。 「GitHub Copilot Chat の回答のカスタマイズについて」を参照してください。
- 特定の言語とシナリオ向けの、コミュニティに投稿されたプロンプト ファイルの例については、Awesome GitHub Copilot Customizations リポジトリを参照してください。
このプロンプト ファイルはプロジェクト構造とコードベース全体を分析することで、プロフェッショナルで包括的な README ファイルを作成します。
README ジェネレーター プロンプト
--- mode: 'agent' description: 'Create a comprehensive README.md file for the project' --- ## Role You're a senior software engineer with extensive experience in open source projects. You create appealing, informative, and easy-to-read README files. ## Task 1. Review the entire project workspace and codebase 2. Create a comprehensive README.md file with these essential sections: - **What the project does**: Clear project title and description - **Why the project is useful**: Key features and benefits - **How users can get started**: Installation/setup instructions with usage examples - **Where users can get help**: Support resources and documentation links - **Who maintains and contributes**: Maintainer information and contribution guidelines ## Guidelines ### Content and Structure - Focus only on information necessary for developers to get started using and contributing to the project - Use clear, concise language and keep it scannable with good headings - Include relevant code examples and usage snippets - Add badges for build status, version, license if appropriate - Keep content under 500 KiB (GitHub truncates beyond this) ### Technical Requirements - Use GitHub Flavored Markdown - Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository - Ensure all links work when the repository is cloned - Use proper heading structure to enable GitHub's auto-generated table of contents ### What NOT to include Don't include: - Detailed API documentation (link to separate docs instead) - Extensive troubleshooting guides (use wikis or separate documentation) - License text (reference separate LICENSE file) - Detailed contribution guidelines (reference separate CONTRIBUTING.md file) Analyze the project structure, dependencies, and code to make the README accurate, helpful, and focused on getting users productive quickly.
---
mode: 'agent'
description: 'Create a comprehensive README.md file for the project'
---
## Role
You're a senior software engineer with extensive experience in open source projects. You create appealing, informative, and easy-to-read README files.
## Task
1. Review the entire project workspace and codebase
2. Create a comprehensive README.md file with these essential sections:
- **What the project does**: Clear project title and description
- **Why the project is useful**: Key features and benefits
- **How users can get started**: Installation/setup instructions with usage examples
- **Where users can get help**: Support resources and documentation links
- **Who maintains and contributes**: Maintainer information and contribution guidelines
## Guidelines
### Content and Structure
- Focus only on information necessary for developers to get started using and contributing to the project
- Use clear, concise language and keep it scannable with good headings
- Include relevant code examples and usage snippets
- Add badges for build status, version, license if appropriate
- Keep content under 500 KiB (GitHub truncates beyond this)
### Technical Requirements
- Use GitHub Flavored Markdown
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Ensure all links work when the repository is cloned
- Use proper heading structure to enable GitHub's auto-generated table of contents
### What NOT to include
Don't include:
- Detailed API documentation (link to separate docs instead)
- Extensive troubleshooting guides (use wikis or separate documentation)
- License text (reference separate LICENSE file)
- Detailed contribution guidelines (reference separate CONTRIBUTING.md file)
Analyze the project structure, dependencies, and code to make the README accurate, helpful, and focused on getting users productive quickly.
このプロンプト ファイルの使用方法
- 上記のコンテンツをリポジトリの
.github/prompts
フォルダーにcreate-readme.prompt.md
として保存します。 - Visual Studio Code で Copilot Chat ビューを表示し、「
/create-readme
」と入力します。
参考資料
- Visual Studio Code ドキュメントの「Visual Studio Code でプロンプト ファイルを使う」- プロンプト ファイルの作成と使用の方法に関する情報
- GitHub Copilot Chat の回答のカスタマイズについて - GitHub Copilot での応答カスタマイズの概要
- 優れた GitHub Copilot カスタマイズ - コミュニティに投稿されたカスタム プロンプト ファイルや、特定の言語やシナリオ向けのその他のカスタマイズのリポジトリ