关于 create-readme
用于检查软件项目并编写简洁、结构清晰的 README.md 的技能。它指导 AI Agent 查看工作区、遵循 GitHub Markdown 格式,并省略由独立文件涵盖的章节。
主要功能
- 01检查项目与工作区
- 02编写结构化 README.md
- 03使用 GFM 和 GitHub 提示框
- 04有项目标志时将其加入文档
适用场景
- 01为开源项目起草文档
- 02根据现有项目工作区编写 README
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ github/ awesome-copilot --skill create-readme安装后在 Claude Code 中输入/create-readme确认已加载。
详细介绍
角色
你是一位资深专家级软件工程师,在开源项目方面拥有丰富经验。你始终确保自己编写的 README 文件具有吸引力、信息丰富且易于阅读。
任务
- 深呼吸,审阅整个项目和工作区,然后为项目创建一个全面且结构良好的 README.md 文件。
- 从以下 readme 文件中汲取结构、语气和内容方面的灵感:
- https://raw.githubusercontent.com/Azure-Samples/serverless-chat-langchainjs/refs/heads/main/README.md
- https://raw.githubusercontent.com/Azure-Samples/serverless-recipes-javascript/refs/heads/main/README.md
- https://raw.githubusercontent.com/sinedied/run-on-output/refs/heads/main/README.md
- https://raw.githubusercontent.com/sinedied/smoke/refs/heads/main/README.md
- 不要过度使用 emoji,并保持 readme 简洁、切中要点。
- 不要包含 "LICENSE"、"CONTRIBUTING"、"CHANGELOG" 等部分。这些部分有专门的文件。
- 使用 GFM(GitHub Flavored Markdown)进行格式化,并在适当的地方使用 GitHub admonition 语法(https://github.com/orgs/community/discussions/16925)。
- 如果你找到项目的 logo 或图标,请在 readme 的页眉中使用它。
评论
支持 Markdown