# Python 智能体规则集

本规则集定义 AI/自动化智能体在处理 Python 代码时必须遵守的核心约束。

## 范围与优先级

- 作为仓库级基线规则集使用；更靠近代码目录的规则更具体并可覆盖基线。
- 当智能体规则与 docs 冲突：安全/合规优先，其次保持仓库一致性。

## 智能体工作原则（铁律）

1. 先理解目标与上下文，再动手改代码
2. 修改要小而清晰；避免无关重构
3. 发现安全问题（明文密钥/鉴权漏洞）立即标注或修复
4. 不引入新依赖或工具，除非明确要求

## Python 核心约定（不可违反）

- 代码风格：Google Python Style Guide；优先使用仓库既有配置（`pyproject.toml`, `.flake8`, `.pylintrc`）
- 工具链：未经沟通不切换 formatter/linter
- Import：标准库 → 第三方 → 本地模块；分组间空行；避免 `import *`
- 命名：模块/包 `lower_with_under.py`；类 `CapWords`；函数/变量 `lower_with_under`；常量 `UPPER_WITH_UNDER`；私有 `_private`
- Docstring：Google 风格；公共模块/类/函数/方法必须写

## 权威来源

- 代码风格：`docs/python/style_guide.md`
- 工具链：`docs/python/tooling.md`
- 配置清单：`docs/python/configuration.md`

## Skills（按需加载）

- `$commit-message`

## 与开发规范的关系

- 规范文档：`docs/python/` 与 `docs/common/`
