用途:在代码库大到单个智能体无法在上下文中容纳某组源码时,先用本技能测量范围并按依赖拓扑分组,供改造流水线使用。
主要能力:单一引擎 scripts/decompose.py 同时负责 LOC 统计、依赖图抽取与校验评分。轻量侦察模式 scripts/decompose.py <scope_path> --lang '<lang>' --exclude '<merged>' --profile-json 向 stdout 输出 ProjectProfile JSON(含 total_loc、total_files、module_count、edge_count、scc_count、dag_depth、topology_hints 与 modules、dag_layers 等),供上游规划判断是否需要分组;完整模式不加 --profile-json,执行 L1 抽取、L2 分组、L3 校验 --validate 'G1:M1,M2|G2:M3,M4|...',输出人类可读的图统计与质量分数。
使用方式:调用方须提供源路径、Language(s)、Skip patterns、Scope(full/scoped)、Mode 五个字段,缺一即应停止并索取。--lang 与 --exclude 必填;--lang 支持 python|java|csharp|javascript 及别名,多语言用逗号分隔。排除列表由 caller_skip_patterns、.gitignore 目录、自动生成目录嗅探与固定 BASELINE 合并后原样传入。L1 输出为权威数据,不得从源码重新抽取;L2 需加载 references/grouping.md;L3 必须运行 --validate,不接受手算指标。--profile-json 与 --validate 不可同时使用。
限制:Python 为必需依赖。当 DAG 深度≤2、模块数≤3 且范围内 LOC 小于 ideal_group_loc 时可跳过并说明理由。缺少的收费、平台等信息暂未提供。