mcpField
W
write-root-readme

write-root-readme

github.com/liblaf开发0184 次安装6 周前更新
代码仓库

关于 write-root-readme

用于改写仓库根目录 README.md 的 Agent Skill,面向维护项目文档的开发者。它提供结构、徽章、链接和验证方面的具体写作指引。

主要功能

  1. 01重写根目录 README.md
  2. 02参考示例确定结构与风格
  3. 03建议徽章及项目图片
  4. 04检查命令、链接和工具名称

适用场景

  1. 01为项目编写新的根目录 README
  2. 02对现有 README 进行全面改写
  3. 03完成文档后核对仓库中的命令与链接

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/liblaf/skills --skill write-root-readme

安装后在 Claude Code 中输入/write-root-readme确认已加载。

附带文件agents/openai.yamlreferences/example-readme.md

详细介绍

编写根目录 README

指南

  • 要更新的文件:
    • 仓库根目录中的 README.md
  • 阅读 example-readme.md,了解参考结构和风格。
  • 鼓励添加徽章。可参考示例 README 中的实用徽章。
    • 适用时,优先使用示例 README 中的徽章。
    • 优先使用包含实时数据的徽章,而非静态徽章。
  • 鼓励在标题中使用表情符号。
  • 鼓励添加 Hero 区域。严格遵循示例 README 中的格式。
    • 使用 GitHub Socialify 生成项目图片。生成的图片已包含 Logo、标题、描述,以及星标、分支、问题和拉取请求徽章。
    • 如有文档,请添加文档链接。
    • 鼓励在 Hero 区域添加徽章。徽章数量最多为 8 个。
    • Hero 区域中的链接最多为 4 个。
    • 在 Hero 区域后添加分隔线。
  • 鼓励添加许可证部分。严格遵循示例 README 中的格式。
  • 不要在 README 中使用相对链接。
  • 优先进行大幅、全面的重写,而非细微或渐进式修改。
  • README 应保持简洁。

验证

  • 运行 rumdl fmt .。将其发现的问题视为参考建议,而非硬性约束。
  • 完成前,针对实际仓库文件抽查命令、链接和工具名称。

评论

支持 Markdown