用途
good-readme 是一个用于创建和改进 GitHub 项目 README 文档的技能。它面向需要撰写新 README、改进现有 README、审查 README 质量，或提出相关请求的用户。其核心理念是：README 是项目的门面，应在 30 秒内回答“这是什么、为什么值得关注、如何使用”三个问题。
主要能力
该技能提供两种工作模式：
-
创建模式：适用于没有 README 或需要从零撰写的项目。在写作前，会阅读项目源码以理解其功能，识别目标受众（终端用户、开发者或两者），检查现有文档、配置文件和 CI 设置以了解项目约定，查看 package.json、Cargo.toml、pyproject.toml、go.mod 等获取项目元数据，并向用户确认“这份 README 面向谁，你最希望他们理解的一件事是什么”。写作过程包括：起草标题与一句话描述（钩子）、撰写简洁的 What & Why（最多 2-4 句）、添加让读者从零到可用的快速开始、包含真实且经过测试的代码示例（而非伪代码）、添加适合生态系统的安装说明，并仅添加该项目真正需要的章节。草稿完成后会先提交用户审阅再定稿。
-
改进模式：适用于已有 README 但需要增强的项目。首先进行审查：完整阅读当前 README，阅读项目源码以核对 README 是否准确和最新，按质量清单评分，找出缺口、过时内容和多余章节，并向用户呈现具体建议。然后进行改进：优先修正事实错误（错误的安装命令、过时的 API 示例），处理结构问题（缺失章节、顺序不当），提升清晰度和可扫读性（标题、代码块、列表），删除无价值的模板化内容，验证所有代码示例可用，并将变更提交用户批准。
使用方式
该技能以技能形式提供，具体安装或调用方式暂未提供。其工作流程强调先理解项目与受众，再动笔或修改，并在关键节点与用户确认。技能内部包含多个参考文件：anatomy.md 提供逐节指导，examples.md 提供优秀项目的模式，anti-patterns.md 列出常见错误，cloudflare.md 说明 Cloudflare 生态的约定。
适用场景
适用于 GitHub 项目的 README 撰写、改进与质量审查，尤其适合需要面向开发者或终端用户清晰传达项目价值、快速开始方式和安装步骤的开源项目。
限制
该技能的具体安装命令、调用方式、收费模式、支持平台等信息暂未提供。其效果取决于项目源码与现有文档的实际情况，且需要用户参与确认受众与目标。