SuperAPI AI 工具集

ln-623-code-principles-auditor

通用与其它

查看项目

更新于 10-15 23:59

技能介绍

用途:这是一个 L3 Worker 级审计技能,用于在代码库中检查编码原则与设计模式合规性,覆盖 DRY、KISS/YAGNI、错误处理、集中式错误处理、依赖注入/集中初始化以及最佳实践文档缺失等 7 类检查。

主要能力:DRY 部分细分为 1.1 至 1.10 十个小类,包括重复代码、重复校验、重复错误消息、相似模式、重复 SQL/ORM、复制粘贴的测试、重复 API 响应、重复中间件链、重复类型定义与重复映射逻辑。可为 Code Principles 类别计算 X/10 合规评分,并用两层检测(候选扫描加上下文验证)降低误报。

使用方式:接收包含 tech_stack、best_practices、principles、codebase_root、output_dir 的 contextStore,支持 domain_mode 与 current_domain 的域感知扫描。优先使用 hex-graph 与 hex-line,若 MCP 不可用则回退到 Read/Grep/Glob/Bash 并在报告中说明。报告写入 {output_dir}/ln-623--{domain}.md(全局模式为 623-principles.md),并包含 FINDINGS-EXTENDED 的 JSON 块,其中 DRY 发现项带 pattern_id 与 pattern_signature,供 ln-620 做跨域匹配。

适用场景:审计代码原则合规性、为重构决策提供依据、跨域识别重复模式。

限制:只报告不自动修复;需排除生成代码、vendor 与迁移文件;工作量估算为 S 小于 1 小时、M 为 1 至 4 小时、L 大于 4 小时;具体命令与工具调用细节依赖宿主 AGENTS.md 策略,相关资料未提供完整命令内容。