1.1 KiB
1.1 KiB
Python 智能体规则集
本规则集定义 AI/自动化智能体在处理 Python 代码时必须遵守的核心约束。
范围与优先级
- 作为仓库级基线规则集使用；更靠近代码目录的规则更具体并可覆盖基线。
- 当智能体规则与 docs 冲突：安全/合规优先，其次保持仓库一致性。
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/