代码库入门指南生成器
为不同利益相关者生成结构化、带来源引用的代码库入门文档。
技能要求先解析仓库上下文、征得用户确认，并要求引用来源；生成文件范围明确，未见恶意代码、凭据窃取或隐蔽外传。但未定义最小权限、敏感数据处理、外部网络访问边界、用户覆盖确认、回滚或清理机制，因此扣分。
步骤顺序和输出文件结构较清晰，且包含若干验证要求；但存在大量未定义行为，例如默认分支变量如何确定、未识别构建文件时如何处理、引用分支如何选择。超长文档、至少五个图表和逐项事实核验也使失败路径和诊断反馈不足，静态评估不超过10分。
目标用户和四类输出场景明确，触发条件也较具体；但未说明不适用场景、输入前提或仓库规模边界，且没有中文输出支持。流程依赖Git和可访问的源码/远程仓库，虽然提供本地引用选项，但海外网络可达性与替代方案未充分说明，因此扣分。
SKILL.md具备名称、描述、MIT许可证、作者和1.0.0版本，并采用较清晰的分层结构；但缺少安装/依赖说明、示例输入输出、FAQ、已知限制、变更记录、维护责任和更新路径。README与LICENSE支持许可证和仓库治理背景，但并非该技能专属维护证据。
技能明确生成四份面向不同受众的文档，并规定文件名、章节和引用格式，核心产物具有直接使用价值；但要求的篇幅和图表数量非常高，且没有提交的代表性输出或技能专属验收证据，文档可能需要较多人工核验和修订，按静态校准不超过7分。
技能要求基于实际代码、文件路径和行号引用，仓库也提供通用CI与测试文件；但所给CI/测试未显示覆盖wiki-onboarding关键路径，也没有该技能专属测试、示例结果或独立复现记录，因此只能给有限可审计性分数。
- 生成过程会创建或修改onboarding/目录，但未说明覆盖现有文件前的确认、备份或回滚策略。
- 技能要求引用远程仓库URL和运行Git命令；在无法访问远程仓库或未处于Git工作树时，失败处理和替代流程不明确。
- 篇幅、Mermaid图表和逐项代码核验要求可能导致高成本或不完整输出，使用者应人工检查事实、路径、引用和图表语法。
- 未提供中文本地化规则；面向中文用户时需要额外翻译和术语审校。
它能做什么 & 适用场景
Wiki Onboarding 会为代码库生成四份面向不同读者的入门指南：贡献者、资深工程师、技术管理者和产品经理。它首先要求确定源代码库的远程地址或本地模式，并识别默认分支。输出包括一个导航页，以及四份分别聚焦开发流程、系统架构、投资风险和用户能力的 Markdown 文档。该技能适合需要系统化 onboarding 文档的工程团队，但生成内容的准确性依赖可访问且可验证的代码库上下文。
它先检查 Git origin 远程地址，并运行 git rev-parse --abbrev-ref HEAD 确定当前分支；随后要求用户确认代码库是本地项目还是提供源代码库 URL。根据源代码库上下文，它生成 onboarding/ 文件夹及 index.md、contributor-guide.md、staff-engineer-guide.md、executive-guide.md 和 product-manager-guide.md。指南要求包含项目结构、工作流、测试、风险、能力边界和至少若干 Mermaid 图表，并根据检测到的构建文件选择代码示例语言。
- 新成员加入已有代码库，需要一份包含环境设置、首个任务和开发流程的贡献者指南。
- 资深工程师接手系统，需要了解架构边界、关键抽象、状态转换、失败模式和技术债务。
- 工程副总裁或总监评估项目，需要快速查看能力、团队归属、风险、成本和投资建议。
- 产品经理需要用非工程术语了解用户旅程、功能边界、限制、数据和常见问题。
优缺点一览
- 一次生成四种受众版本，覆盖工程、管理和产品视角。
- 要求使用实际代码、文件路径和链接引用来支撑陈述。
- 包含架构、实体关系、请求流程、状态和工作流等 Mermaid 图表要求。
- 支持本地引用和远程仓库链接引用两种来源形式。
- 必须先解决源代码库上下文，无法在未确认本地或远程来源时继续。
- 输出规模较大：贡献者指南要求 1000–2500 行，其他指南也有明确篇幅要求。
- 源材料没有说明该单项技能的专用测试套件或验证命令。
- 指南要求很多代码库事实；如果源代码、构建文件或历史决策不可访问，内容完整度会受限。
如何安装
在 Copilot CLI 或兼容的技能安装流程中运行：npx skills add microsoft/skills。根据向导选择需要的技能；技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。源材料没有提供只安装 wiki-onboarding 这一项技能的独立命令。
如何使用
在包含目标代码库的环境中触发入门文档请求，例如：“为这个代码库生成 onboarding guides。”技能会先检查 git remote get-url origin，并要求确认“这是仅本地代码库，还是有源代码库 URL？”在源代码库上下文和默认分支确定前不会继续。完成后应生成 onboarding/ 文件夹及四份受众定制指南。