技能介绍

解决什么问题

很多仓库的 README 要么只有标题和一句描述，要么把安装步骤、目录结构、测试约定散落在不同文档里。新成员要跨 Architecture、Workflow_Analysis、Coding_Standards 等文件自行拼凑信息，首次贡献者尤其容易卡在环境准备和规范理解上。这个技能面向这种“文档存在但未被组织成入口页”的场景：它不替你决定项目应该长什么样，而是把 .github/copilot 目录中的现有资料重新整理成一份可读的 README.md 蓝图。

工作方式

它会先扫描 .github/copilot 下的常见文档，例如 Architecture、Code_Exemplars、Coding_Standards、Project_Folder_Structure、Technology_Stack、Unit_Tests 和 Workflow_Analysis，同时读取 .github/copilot-instructions.md。随后按固定骨架输出：项目名称与描述、技术栈、架构概览、快速开始、项目结构、核心功能、开发流程、编码规范、测试、贡献指南和许可证。其中技术栈、目录、流程、规范、测试等内容会尽量注明来源文件，方便读者回到原始文档核对。输出格式为 Markdown，包含标题层级、列表、代码块和必要链接。

适用边界

它适合已经有 Copilot 风格文档沉淀的仓库，尤其适合把分散约定收敛成统一入口。如果 .github/copilot 缺失关键文件，或文档本身互相矛盾、缺少版本与许可证信息，生成结果只能反映现有材料，不应被当成补齐事实的依据。涉及私有依赖、权限配置、部署细节和安全约束时，仍应由维护者人工补充；README 上线前也建议由作者复核架构描述、安装条件和贡献规则，避免把过时约定复制进文档。