SuperAPI AI 工具集

coding

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:该技能适用于所有编程相关任务,在实现新功能、重构现有代码或审查代码时使用,以确保高质量与可维护性。

核心原则:DRY(避免逻辑重复,重复代码应抽象)、KISS(优先简单直接的方案,避免过度工程)、YAGNI(不要实现尚未需要的功能或抽象)。SOLID 原则包括单一职责、开闭、里氏替换、接口隔离和依赖倒置。同时要求遵循项目现有指南(如 CLAUDE.md、AGENT.md 等)。

实现指南:使用描述性命名;保持函数小而专注;主动进行错误处理,验证输入并优雅处理异常;文档说明“为什么”而非“是什么”;安全方面需净化输入、避免硬编码密钥、遵循最小权限原则;关注时间与空间复杂度,但避免过早优化。

自动化分析与质量控制:每个项目必须有自动化 lint、格式化和静态分析(如 ESLint、Prettier、Ruff、Sonar),需检查是否已配置,缺失时立即提议添加(如 npm install --save-dev eslint)。确保配置测试运行器(如 Jest、Pytest),检查 tests/ 目录或 package.json/pyproject.toml 中的测试配置,缺失时提议测试框架与初始设置。

验证代码变更:完成任务前必须执行验证循环——使用 code-simplifier 插件简化代码;对照任务需求自查,确保符合 DRY、KISS、SOLID,检查安全漏洞或性能回归;运行项目 lint/格式命令(如 npm run lint、prettier --check .)并修复问题;若新增逻辑则编写覆盖正常路径与边界情况的单元测试,运行测试套件(如 npm test、pytest)并确保全部通过,失败则修复实现或测试。

关键原则:清晰优于聪明,代码首先为人而写;保持与现有代码库模式与风格一致;组合优于继承,优先组合简单对象而非深层继承。

限制:资料未提供具体收费、价格、平台支持范围或效果数据。