08. 第一次进入现有的仓库

Guide阅读约 4 分钟

当你第一次进入一个已经有代码的陌生仓库并且需要了解“这个代码库的样子”时，使用这个方法。相反，如果你正在从零开始设计一个新项目，请前往 07.

何时使用此流程

当你第一次进入一个已经有代码的陌生仓库并且需要了解“这个代码库的样子”时，使用这个方法。相反，如果你正在从零开始设计一个新项目，请前往 07. Starting a new Project。这两种流程的方向相反，不应在同一会话中一起使用。

ywc-onboard-repo 使用 Glob/Grep 侦察来提取技术栈 / 架构 / 规范，并生成两样东西。

入职指南 - 一份直接在对话中打印的文档（技术栈、架构、关键入口点、目录结构图、请求生命周期、规范等）
Starter CLAUDE.md - 一个写入到仓库根目录的文件。如果 CLAUDE.md 已经存在，它不会被覆盖；而是会增加一个 ## Detected Conventions 部分。

默认运行 - 检查整个仓库并生成入门指南和入门 CLAUDE.md

claude code

/ywc-onboard-repo

codex

$ywc-onboard-repo

仅检查 monorepo 中的特定工作区

claude code

/ywc-onboard-repo --scope apps/web/

codex

$ywc-onboard-repo --scope apps/web/

当你只需要说明性文件，而不是 Starter CLAUDE.md

claude code

/ywc-onboard-repo --guide-only

codex

$ywc-onboard-repo --guide-only

当你只需要 CLAUDE.md，而不是入职指南时

claude code

/ywc-onboard-repo --claude-md-only

codex

$ywc-onboard-repo --claude-md-only