用途
codebase-onboarding 用于分析一个代码库，并为工程师、技术负责人和外包合作者生成入职（onboarding）文档。该技能针对快速事实收集和可重复的入职产出进行了优化，属于工程领域下的文档与开发者体验方向，技能层级标注为 POWERFUL。
主要能力
- 基于仓库信号发现架构与技术栈。
- 为新贡献者整理关键文件与配置清单。
- 生成本地搭建与常见任务的指导内容。
- 按受众框架组织文档内容。
- 搭建调试与贡献清单脚手架。
使用方式
资料提供了以下快速开始命令与流程：
- 收集代码库事实：
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 中更新文档。
- 把入职文档视为持续维护的运营资产，而非一次性交付物。
关于该技能的具体收费、价格、平台兼容性或实际使用效果，资料未提供，暂未提供。