SuperAPI AI 工具集

ln-646-project-structure-auditor

测试与质量

查看项目

更新于 10-15 23:59

技能介绍

用途:作为 L3 Worker 审计项目的物理结构是否体现预期架构,发现让架构难以导航或难以约束的结构漂移。它只关注物理结构,不处理 ignore 文件、临时文件、构建产物、包安全、环境变量卫生、导入层级边界或运行时生命周期,也不会自动移动或删除文件。

主要能力:检查框架期望的源码位置、领域/模块分组、分层目录布局、命名与放置一致性,以及 utils、helpers、common、shared、services、lib 等“杂物抽屉”目录是否混入无关职责。每条发现需给出严重级别、位置、动作、工作量与建议,动作限定为 MOVE_MODULE、SPLIT_JUNK_DRAWER 或 ALIGN_DOMAIN_STRUCTURE,并按 references/audit_scoring.md 计算 X/10 合规分。

使用方式:必须先读取 references/audit_worker_core_contract.md 与 references/mcp_tool_preferences.md。接收包含 tech_stack、architecture、codebase_root、output_dir、domain_mode、scan_path 的 contextStore,确定 scan_root 后做技术栈与结构探测,依次运行结构检查(Layer 1)与上下文验证(Layer 2),收集发现并写报告到 {output_dir}/ln-646--{identifier}.md,类别为 "Project Structure",检查项为 framework_placement、domain_layer_layout、junk_drawers。优先使用 hex-line MCP 读取文件,架构摘要需要时用 hex-graph;MCP 不可用时回退到内置 Read/Grep/Glob/Bash 并在报告中说明。

限制:小型项目可能无需完整领域/分层拆分,框架规则只适用于检测到的技术栈,按应用/包/测试类型拆分且有文档说明的混合布局可接受。评分细节需加载 references/audit_scoring.md,报告模板与摘要契约分别见 references/templates/audit_worker_report_template.md 和 references/audit_summary_contract.md。