logics-code-structure-reviewer

通过启发式方法识别仓库可能采用的技术栈或框架，并生成一份经过调整的代码结构评审报告（如大文件处理、文件夹规范化、建议的模块/组件边界），以Markdown格式呈现。当Codex需要评估代码是否过度集中于单一文件，并在技术栈尚不明确的情况下，提出更清晰的代码结构优化方案时，这一工具便能派上用场。

SKILL.md

--- frontmatter

name: logics-code-structure-reviewer
description: Detect the repository's likely stack/framework (heuristics) and generate an adapted code-structure review (large files, folder hygiene, suggested module/component boundaries) as a Markdown report. Use when Codex needs to check whether code is overly concentrated in single files and propose clearer structure, even when the stack is not yet known.

Code structure review (stack-aware)

Run

Print a Markdown report to stdout:

bash

python3 logics/skills/logics-code-structure-reviewer/scripts/code_structure_review.py

Write the report to a file:

bash

python3 logics/skills/logics-code-structure-reviewer/scripts/code_structure_review.py --out logics/CODE_REVIEW.md

Useful flags

•--max-lines 400: Threshold for "large file" detection.
•--top 20: Number of largest files to list.
•--include-logics: Include logics/** in the scan (off by default).