用途
Codebase Onboarding 是一个面向工程团队的代码库入职文档生成技能，定位为 Documentation / Developer Experience 领域工具，级别标注为 POWERFUL。它旨在通过分析代码库，为工程师、技术负责人和外包人员生成可重复的入职文档，帮助团队快速完成事实收集并产出标准化的 onboarding 材料。
主要能力
根据资料，该技能具备以下核心能力：
- 从仓库信号中发现架构与技术栈
- 为新贡献者盘点关键文件与配置文件
- 生成本地环境搭建与常见任务的指引
- 按受众调整文档表达框架
- 搭建调试与贡献检查清单脚手架
使用方式
资料提供了 Quick Start 命令与推荐工作流：
- 运行分析脚本收集代码库事实：
python3 scripts/codebase_analyzer.py /path/to/repo
- 以机器可读格式导出结果：
python3 scripts/codebase_analyzer.py /path/to/repo --json
- 使用模板起草入职文档，参见
references/onboarding-template.md。
推荐工作流包括：对目标仓库运行 scripts/codebase_analyzer.py；捕获关键信号，如文件数量、检测到的语言、配置文件、顶层结构；填写 references/onboarding-template.md 中的入职模板；并按受众调整输出深度：初级人员关注环境搭建与防护规范，高级人员关注架构与运维事项，外包人员关注职责范围与集成边界。
详细的文档模板与章节示例位于 references/onboarding-template.md 和 references/output-format-templates.md。
适用场景
资料列出的使用时机包括：
- 新团队成员或外包人员入职
- 大规模重构后重建陈旧的项目文档
- 准备内部交接文档
- 为服务创建标准化入职包
限制与注意事项
资料还列出了常见陷阱与最佳实践。常见陷阱包括：未在干净环境中验证搭建命令就撰写文档；在面向外包的文档中混入架构深度内容；遗漏故障排查与验证步骤；让入职文档与当前仓库状态脱节。最佳实践包括：保持搭建说明可执行且有明确时间范围；记录关键架构决策的“为什么”；在行为变更的同一 PR 中更新文档；将入职文档视为持续维护的运营资产，而非一次性交付物。
关于该技能具体支持的语言范围、脚本运行所需的依赖环境、模板的完整细节、性能表现及任何收费或价格信息，资料暂未提供。