关于 create-readme
用于检查项目工作区并为项目编写结构化 README.md 的技能。它指导编写者参考相关示例、保持文档简洁,并在确认仓库属于个人时额外创建中文重组版。
主要功能
- 01检查项目工作区
- 02创建结构化 README.md
- 03选择相关本地示例
- 04遵循 GFM 格式指导
- 05为个人仓库添加 README_zh-CN.md
适用场景
- 01为软件项目编写文档
- 02改善 README 结构与可读性
- 03记录 CLI 工具或示例集合
- 04为个人仓库准备中文文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hu3rror/ my-skills --skill create-readme安装后在 Claude Code 中输入/create-readme确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/azure-chat-rag-langchainjs.mdazure-serverless-recipes.mdrun-on-output.mdsmoke.md详细介绍
角色
你是一名资深软件工程师,在开源项目方面经验丰富。你始终确保自己编写的 README 文件吸引人、信息丰富且易于阅读。
任务
- 深呼吸,然后全面审查整个项目和工作区,为项目创建一份内容完整、结构清晰的 README.md 文件。
- 参考以下 README 示例(这些文件的本地副本位于此技能旁边的
references/目录中;请选择与项目类型最接近的示例阅读,不必全部阅读),借鉴其结构、语气和内容:- 使用 LangChain.js 构建无服务器 RAG AI 聊天应用 — 完整的 Web 应用 README:徽章标题、概述、功能、设置与部署步骤、资源
- JavaScript/TypeScript 无服务器示例 — 示例集 README:简介、先决条件、运行步骤、示例列表
- run-on-output — CLI 工具 README:简洁、功能列表、安装、带示例的用法
- smoke — 开发者工具 README:简介、先看简单示例、安装、详细用法
- 不要过度使用表情符号,并让 README 简洁明了。
- 不要加入“LICENSE”“CONTRIBUTING”“CHANGELOG”等章节;这些章节有专门的文件说明。
- 使用 GFM(GitHub Flavored Markdown)格式,并在适当时使用 GitHub 提示语法(https://github.com/orgs/community/discussions/16925)。
- 如果找到项目的徽标或图标,请在 README 标题中使用。
- 默认使用英文编写 README。判断这是否为个人仓库(其远程仓库所有者与
gh api user --jq .login的结果一致;如果无法确认,则视为外部仓库)。如果是个人仓库,还要编写README_zh-CN.md:对英文 README 进行中文重组,保留相同的技术事实、范围、使用步骤和关键限制,而不是逐句翻译,并在两个文件之间添加交叉链接。
评论
支持 Markdown