用途:在加入新项目、理解陌生代码库、搭建开发环境或编写上手指南时,用一套系统化流程完成项目引导,便于快速投入有效开发。
主要能力:技能包含脚本 scripts/validate-onboarding.sh 和参考文档 references/onboarding-patterns.md。核心工作流分八个阶段:项目结构分析(用 discover 查找配置文件、入口点、monorepo 指标);依赖审计(提取 dependencies/devDependencies/peerDependencies,运行 npm outdated、npm audit,分析包体积);架构映射(用 precision_read 提取 outline 与符号,用 grep 追踪导入导出);约定检测(命名、文件组织、lint 与格式配置);环境搭建(检查 Node 版本、安装依赖、环境变量、数据库迁移与种子);构建与开发工作流(脚本识别、构建、启动开发服务器、运行测试);关键模式识别(状态管理、错误处理、认证、路由);文档生成(写入 .claude/CLAUDE.md 等)。
使用方式:当用户说“帮助理解这个代码库”“引导我上手”等触发语句时加载。按阶段调用工具,例如发现文件用 discover 的 glob 查询,读取内容用 precision_read,多行匹配用 precision_grep,执行命令用 precision_exec。安装依赖示例命令 npm install / pnpm install,数据库示例 npx prisma generate、npx prisma migrate dev、npx prisma db seed,构建 npm run build,开发 npm run dev,测试 npm test。
适用场景:新成员加入、代码库文档化、开发环境搭建、项目健康与技术债审计。
限制:技能面向 GoodVibes 工具环境,提供的路径与命令为示例,需按实际发现的路径替换;未提供价格、平台支持范围及具体执行效果保证等信息。