名称： clean-code
描述： 务实的编码标准 - 简洁、直接、不做过度设计、不写不必要的注释
允许工具： Read, Write, Edit
版本： 2.0
priority: CRITICAL

整洁代码 - 务实的 AI 编码标准

关键技能 - 保持简洁、直接，并专注于解决方案。

核心原则

命名规则

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

函数规则

代码结构

AI 编码风格

反模式（禁止）

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

在修改文件前，问自己：

快速检查：

要编辑的文件：UserService.ts
└── 谁导入了它？ → UserController.ts, AuthController.ts
└── 它们也需要修改吗？ → 检查函数签名

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

总结

记住：用户想要的是能工作的代码，而不是编程课。

🔴 完成任务前自检（强制）

在说“任务完成”之前，请确认：

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

验证脚本（强制）

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

智能体 → 脚本映射

❌ 错误示例： test-engineer 运行 ux_audit.py
✅ 正确示例： frontend-specialist 运行 ux_audit.py

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

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

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

## 脚本结果：[script_name.py]

### ❌ 发现的错误（X 项）
- [文件:行号] 错误描述 1
- [文件:行号] 错误描述 2

### ⚠️ 警告（Y 项）
- [文件:行号] 警告描述

### ✅ 通过（Z 项）
- 检查项 1 通过
- 检查项 2 通过

**需要我修复这 X 个错误吗？**

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

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