根据参考文档修改一部分规范

03 - Coding & Frameworks/01 - Language Coding Specification/Python 编码与开发规范.md

@@ -21,6 +21,8 @@ Python 是一门极其灵活的动态语言，但“灵活”在大型团队协
       ...
 
 * **常量（Constants）：** 强制使用 SCREAMING\_SNAKE\_CASE（全大写加下划线），定义在模块顶部。  
+* **布尔语义命名：** 布尔变量与布尔返回值应使用 `is_`、`has_`、`can_`、`allow_` 前缀，避免语义歧义。  
+* **集合语义命名：** 列表、集合、查询结果变量应使用复数命名（如 `users`, `orders`, `permission_codes`）。  
 * **私有与受保护属性：** \* 单下划线 \_private\_var：表示内部使用（软性约束，仅作提示）。  
   * 双下划线 \_\_strict\_private：触发名称改写（Name Mangling），除非极特殊情况（如防止子类重写），**日常业务开发中不推荐使用**，以免增加调试难度。
 
@@ -90,6 +92,7 @@ class UserCreateRequest(BaseModel):
 
 * **禁止吞噬异常：** 绝不允许出现 except Exception: pass 这种掩耳盗铃的代码。  
 * **自定义异常层次：** 模块应当抛出特定业务领域的异常（如继承自 ValueError 的 OrderNotFoundError），而不是直接抛出裸露的 Exception。
+* **边界层错误策略：** 在 API、CLI、任务入口等边界层，应优先“抛异常并交由统一处理”，避免在底层函数中拼接错误响应字符串。
 
 ### **4\. 资源释放与安全**