用途:为 AI 编码代理提供一套务实的代码规范,目标是产出简洁、直接、以解决问题为导向的代码,而非教程式讲解。
主要能力:核心原则包括单一职责(SRP)、避免重复(DRY)、保持简单(KISS)、不做无用功能(YAGNI)以及“童子军规则”(让代码比接手时更整洁)。命名规则要求变量体现意图(如 userCount 而非 n)、函数用动词加名词(如 getUserById)、布尔值用疑问式(如 isActive)、常量用全大写下划线(如 MAX_RETRY_COUNT)。函数规则要求短小(最多 20 行,理想 5-10 行)、只做一件事、单一抽象层级、参数最多 3 个、避免意外副作用。结构上提倡卫语句提前返回、嵌套不超过 2 层、小函数组合、相关代码就近放置。
使用方式:AI 在用户要求功能时直接写代码,报告缺陷时直接修复而不先解释,需求不清时先询问而非假设。编辑任何文件前需先思考:谁导入了该文件、该文件导入了什么、哪些测试覆盖它、是否为共享组件,并在同一任务中同步修改所有依赖文件,避免留下断裂的导入。完成任务前需自检目标是否达成、文件是否改全、代码是否可用、有无错误与遗漏。
验证脚本:资料列出各代理对应的脚本命令,例如前端专家运行 python .agents/skills/frontend-design/scripts/ux_audit.py .,后端专家运行 python .agents/skills/api-patterns/scripts/api_validator.py .,测试工程师运行 python .agents/skills/testing-patterns/scripts/test_runner.py . 等;每个代理只运行自己技能的脚本。脚本输出需按“读取→汇总→询问”流程处理,先汇总错误、警告与通过项,再等待用户确认后才修复,修复后重跑确认。
限制:资料未提供该技能的安装方式、收费、价格、支持平台或具体效果数据。