用途:编写与审查后端代码,要求逻辑清晰、安全、可读、可维护、便于复现/扩展/部署;适用于实验代码、模型代码、数据处理代码、可视化代码、后端接口或系统逻辑。
主要能力:写代码前先读现有代码,匹配项目风格、约定与依赖库,不擅自引入新框架;明确输入输出、边界条件与复现要求(种子/版本)。质量标准包括单一职责、小函数、清楚数据流;参数化查询、输入校验、异常处理,不硬编码密钥,不回显敏感值;命名达意、注释解释“为什么”;低耦合、配置化、避免过度工程;固定随机种子、锁依赖版本、记录环境、确定性数据划分。
工程实践:Git 功能分支不直接推 main,提交信息有意义,仅用户明确要求才提交/推送。依赖与环境可用 uv(uv init、uv add、uv lock/uv sync、uv run、uv python pin 3.11)或 Poetry(poetry add、poetry install),始终提交 lock 文件。测试用 pytest,文件 test_.py、函数 test_ 自动发现,纯 assert,fixture 做依赖注入,parametrize 跑多组输入,共享 fixture 放 conftest.py,改完跑 pytest -x,覆盖率用 pytest --cov。质量门包括 Ruff(ruff check . 与 ruff format --check . 分开跑)、mypy/pyright 静态类型检查、pre-commit(rev 锁版本,pre-commit install,CI 跑 pre-commit run --all-files)、必要时 SonarQube。CI 用 GitHub Actions,典型流水线 checkout → 装依赖 → ruff check → pytest,secrets 用 ${{ secrets.X }} 注入。
调试与审查:系统化调试先定位根因,逐字读错误、稳定复现、查最近改动、边界埋点、反向追数据流,一次只改一个变量,连修 3 次仍失败则质疑架构;自我代码审查按 Critical/Important/Minor 分级;用“删除测试”诊断浅模块与深模块;拆子任务与收尾分支。推荐 TDD:先写最小失败测试并看它失败,再写最简实现转绿,绿灯后才重构。
限制与衔接:创建网络暴露接口/服务时若无鉴权必须主动指出安全影响,不静默上线无认证服务。产出为可运行代码、测试、依赖/环境说明、README 与运行命令。实现方案与流水线,优先复用已验证的官方实现/库而非从零造轮子。工具硬信息、TDD 红旗、调试协议、自审清单、资产清单治理与技能自测等细节见同目录 references 与 assets。具体收费、价格、平台与效果资料暂未提供。