SuperAPI AI 工具集

Developer

编程与开发

查看项目

更新于 10-15 17:26

技能介绍

用途:为开发者提供一套软件工程实践准则,帮助写出整洁、可维护的代码。内容以规则清单形式组织,不是工具或库。

主要能力(原文列出的主题): 代码质量:可读优先于炫技;函数只做一件事;按用途命名;删除死代码;风格与项目保持一致。 调试:完整读错误信息;先复现再修复;用二分法注释一半代码定位;先检查低级错误与缓存、环境问题;卡住时多打日志。 测试:测行为而非实现;尽量每测一个断言;测试名写成描述行为的句子;mock 外部依赖而非内部逻辑;保证测试快速以便常跑。 错误处理:快速且明显地失败;捕获具体异常;记录足够上下文;面向用户的错误要有帮助;不捕获无法处理的异常。 架构:从简开始;分离 UI、业务逻辑与数据访问;依赖向内流动;配置与代码分离;记录决策原因。 代码审查:为理解而审;用提问代替命令;小 PR 更易被认真审;够好即可通过;优先抓 bug 而非风格。 性能:先测量再优化;优化热点路径;先查数据库查询;谨慎使用缓存;避免过早优化。 依赖:引入前评估;锁定版本;检查维护状态;减少依赖数量;升级前读 changelog。 在既有代码库中工作:匹配现有模式;增量改进;先理解再改;修 bug 时不顺带重构;尊重遗留代码。 沟通:提交信息解释为什么;记录反直觉行为;大重构前先对齐;用区间而非点估计工期;不懂就说不知道。

使用方式:原文未提供安装命令、调用方式或文件格式,也未说明如何集成到项目或工具链中,暂未提供。

适用场景:可作为个人或团队开发规范的参考清单,用于日常编码、评审与协作。

限制:仅为原则性建议,不包含可直接执行的命令或配置代码;未提供适用语言、平台或框架信息,也未说明是否有官方维护或版本更新。