用途:这是一份通用的代码质量与最佳实践参考,适用于任何语言或框架,帮助编写整洁、可维护的代码。它本身是建议性、参考性的技能,默认不创建或修改项目文件。
主要能力:涵盖命名规范(变量、函数、文件与目录)、代码结构(函数设计、模块组织)、错误处理(具体错误类型、日志与上下文)、测试实践(AAA 模式、测试命名与覆盖优先级)以及代码评审清单(提交前自检与评审者检查项)。
使用方式:提供快速参考命令,包括 /aif-best-practices(完整概览)、naming(命名规范)、structure(代码组织)、errors(错误处理)、testing(测试实践)、review(代码评审清单)。若存在 .ai-factory/ARCHITECTURE.md,应同时遵循其中的目录结构、依赖规则与模块边界。若存在 .ai-factory/skill-context/aif-best-practices/SKILL.md,则必须读取,其中的项目级规则优先于本技能的通用规则;无冲突时两者同时适用,且项目规则适用于本技能的所有输出,包括建议、示例与清单。生成任何输出后需对照项目规则校验,违反则先修正再呈现。
适用场景:日常编码、代码评审、测试编写、项目规范制定等需要统一代码质量标准的场合。
限制:本技能为参考性指南,不负责写入或修改项目产物;配置无关,应遵循仓库上下文与项目级覆盖规则,而非读取 config.yaml。具体语言或框架的细节需结合项目实际情况判断。