crafting-readme-files

此技能作为专业技术作家与开发者布道者，协助您将基础的项目文档转化为专业等级的 README.md 文件，有效将被动的访客转化为活跃使用者。它遵循经证实的结构化模板，旨在解决常见的开源文档缺陷，例如价值主张缺失、安装说明不清以及缺乏具体范例等问题。通过应用此技能，您将超越单纯的技术描述，为您的项目打造引人入胜的销售文案与完整的参考手册。

• 生成包含项目插图、CI/CD 徽章与简洁摘要的英雄区 (Hero Section)。

• 构建结构化的 TL;DR 区块，清晰定义问题陈述与项目解决方案。

• 建立全面的功能表格，展示相较于功能列表更具体的价值。

• 整合安装指南，包含 curl 单行指令、套件管理工具指令 (Homebrew, Scoop) 与原始码编译说明。

• 规划指令参考、配置文件模板与疑难排解步骤，以提升开发者体验。

• 通过 ASCII 艺术呈现架构可视化，协助使用者理解系统数据流与设计。

• 提供比较表格，将您的工具与行业替代方案及既定标准进行对比。

• 非常适合 CLI 工具、软件函数库与复杂开源系统的维护者使用。

• 在引导新使用者、提升项目搜索可见度或优化现有项目文档时效果最佳。

• 推广「展示而非讲述」的原则：每一项技术主张都配有可验证的指令范例。

• 鼓励纳入设计哲学、限制条件与常见问题集 (FAQ)，以预测常见的使用者阻力点。

• 确保文档具备易读性与易扫描性，即便对于时间紧迫的开发者同样友好。

• 支持多种 Markdown 增强功能与 GitHub 项目的布局最佳实践。

• 仅需极少输入：提供目前的项目说明或目标，即可输出生产就绪的 README 骨架。