用途:把任意代码库转化为可用知识,包括知识图谱(scan + git 历史 + 批量分析 + 分层/导览,无需插件)、领域图(domain → flow → step)、llmwiki/wiki/ 维基页与 HTML 文档页。触发词包括 onboard codebase、analyze codebase、knowledge graph、guided tour 和 /orca-onboard。
流程:Phase 0 预检与引导(检查依赖、解析项目根、bootstrap llmwiki 与 harness、建目录、统计文件、探测 agent)→ Phase 0.5 门禁(先建草稿文件再询问用户)→ Phase 1 图谱(扫描→git 历史→分析→合并→分层与导览→校验)→ Phase 2 领域图与真实覆盖面覆盖统计 → Phase 3 维基 → Phase 4 HTML(JSON→骨架 v2→wiki 图向量)→ 输出报告。草稿文件 llmwiki/wiki/draft/orca/<日期>-onboard-<slug>.md 充当状态记录,每阶段完成即更新。
用法与选项:<path> 指定目标目录(默认 .);@<draft> 从已有草稿恢复;--full 删除 .overstack/graph/ 后重建;--update 只重新分析上次运行后变更的文件(需已有 graph 与 meta.json);--language <lang> 指定输出语言;--skip-wiki 跳过维基生成。依赖 opencode 与 docs-site-macos 技能,缺失则 Phase 0 以 exit 1 退出并给出安装命令:npx skills add rheinmir/setup@orca --skill docs-site-macos --global -y。
主要约束:Phase 0 完成前不得运行后续阶段;llmwiki/ 缺失必须在 Phase 0 引导,失败即完全停止;每阶段后立即更新状态;推理任务(分层/导览、领域推理)必须留在 Claude 主线程,不派发给 opencode/agy;只能引用真实文件路径与 file:line;Phase 4 不得手写原始 HTML,须经骨架 v2;覆盖面以与真实表面的差异按 N/M 项报告。批量分析连续失败两次则降级为部分图谱并记录警告。