用途:该技能面向已有代码库,自动生成或刷新 docs/overview/ 架构上下文,使新贡献者能快速了解当前模块布局、关键入口点、当前变更焦点、风险与建议阅读顺序,并在 ARCHITECTURE.md 中给出 Arc42 + C4 及推断的运行时/模块视图。
触发方式:显式执行 /vibeflow-reverse-spec;当 VibeFlow 检测到项目非空但 docs/overview/ARCHITECTURE.md 缺失或过期时也会自动触发。
前提条件:项目须包含 Python(.py)或 TypeScript(.ts/.tsx/.js/.jsx)源文件,且至少检测到 1 个模块。
执行流程:第一步运行 python scripts/map-codebase.py --project-root {project_root} --refresh force,生成 docs/overview/PROJECT.md 与 docs/overview/ARCHITECTURE.md,其中 ARCHITECTURE.md 统一包含 spec_analyzer 的结果,不再依赖 .vibeflow/analysis/ 过程文件;需要更高保真的职责与运行流时,可将 LLM 推断补充进 ARCHITECTURE.md 的 Arc42 生成区块。第二步运行 python scripts/map-change-impact.py --project-root {project_root} --source design,生成 docs/overview/CURRENT-STATE.md。第三步校验三个文件均存在,并确认 CURRENT-STATE.md 含当前变更焦点与概览同步状态。
输出:docs/overview/PROJECT.md、docs/overview/ARCHITECTURE.md、docs/overview/CURRENT-STATE.md,以及 .vibeflow/wiki-status.json 用于新鲜度跟踪。
质量门:模块图节点数须大于 0;若检测到 0 个模块则报错“No source modules detected. Ensure this is a non-empty project with Python or TypeScript source files.”。
集成与限制:该技能属于 Design 前置步骤;若概览文档已是最新则静默成功;Design 阶段应读取 PROJECT.md 与 ARCHITECTURE.md。公开资料未提供安装方式、收费与价格信息。