整洁代码 - 实用人工智能编码规范

关键技能- 保持简洁、直接、聚焦解决方案。

核心原则

命名规则

规则：如果需要注释来解释一个名称，请重命名它。

函数规则

代码结构

AI编程风格

反模式（避免这样做）

🔴 在编辑任何文件之前（先思考！）

修改文件前，先问自己：

快速检查：

File to edit: UserService.ts
└── Who imports this? → UserController.ts, AuthController.ts
└── Do they need changes too? → Check function signatures

🔴规则：在同一任务中编辑文件及其所有依赖文件。 🔴切勿留下损坏的导入或缺失的更新。

总结

记住：用户需要的是能运行的代码，而不是编程课程。

🔴 完成前自检（强制）

在说“任务完成”之前，请验证：

🔴规则：如果任何检查失败，请在完成前修复。

验证脚本（强制）

🔴关键：每个智能体在完成工作后仅运行其自身技能的脚本。

智能体 → 脚本映射

❌错误： 测试工程师正在运行ux_audit.py✅正确： 前端专家正在运行ux_audit.py

🔴 脚本输出处理（读取 → 总结 → 询问）

运行验证脚本时，您必须：

1. 运行脚本并捕获所有输出
2. 解析输出- 识别错误、警告和通过项
3. 向用户总结使用此格式：

## Script Results: [script_name.py]

### ❌ Errors Found (X items)
- [File:Line] Error description 1
- [File:Line] Error description 2

### ⚠️ Warnings (Y items)
- [File:Line] Warning description

### ✅ Passed (Z items)
- Check 1 passed
- Check 2 passed

**Should I fix the X errors?**

4. 等待用户确认然后再进行修复
5. 修复后→ 重新运行脚本以确认

🔴违规：运行脚本并忽略输出 = 任务失败。 🔴违规：未经询问自动修复 = 不允许。 🔴规则：始终遵循：读取输出 → 总结 → 询问 → 然后修复。