用途:把任意代码库转成可用知识——知识图谱(扫描、git 历史、批量分析、layers/tour,无需插件)、领域图(domain → flow → step)、wiki(llmwiki/wiki/)和 HTML 文档页。触发词包括“onboard codebase”“analyze codebase”“knowledge graph”“guided tour”,或 /orca-onboard。
主要能力:Phase 0 预检与 bootstrap;Phase 0.5 门禁(先建 draft,再向用户确认);Phase 1 图谱(扫描 → git 历史 → 分析 → 合并 → 分层与导览 → 校验 → 可选 code-graph 索引);Phase 2 领域图;Phase 3 wiki;Phase 4 HTML(JSON → skeleton v2 → wiki-graph 向量);最后输出报告。draft 状态文件按阶段记录 pending/in-progress/done,可断点续跑。
使用方式:输入 <path>(默认 .)、@<draft> 续跑;选项 --full 删除 .overstack/graph/ 重建、--update 仅重分析变更文件(需已有 graph 与 meta.json)、--language <lang> 指定输出语言、--skip-wiki 跳过 wiki。Phase 0.5 需用户在终端确认后继续。
关键约束:严格顺序,Phase 0 完成前不得运行后续阶段;llmwiki/ 缺失即 bootstrap,失败则 STOP;每阶段后立即更新 draft 状态;推理任务必须留在 Claude 主线程,opencode 配 DeepSeek 仅做模板填充、wiki 渲染与 HTML;不得编造文件路径或 file:line;Phase 1 后不整读 knowledge-graph.json,改用 ONBOARDING.md;Phase 4 不手写原始 HTML,必须经 skeleton v2;code-graph 仅在 dep-health.py --json 报告 status == "ok" 时索引。
限制:缺少 opencode、docs-site-macos 或项目根目录 → 阻断(exit 1 并给安装命令);--update 缺 graph/meta.json → 阻断;bootstrap 失败 → 完全停止;用户门禁不通过 → cancelled 仅留 draft;批量分析失败两次则降级为 partial graph;无 HTTP/CLI/event 入口则领域图为空;wiki-graph.html 渲染失败为 fail-open,不阻断。