用途 该技能用于后端代码编写与审查,适合需要写实验代码、模型代码、数据处理代码、可视化代码、后端接口或系统逻辑的任务。目标产出要求逻辑清晰、安全、可读、可维护,并便于复现、扩展与部署。
主要能力 写代码前先读现有代码,匹配项目的风格、约定与依赖库,不擅自引入新框架,明确输入输出、边界条件与复现要求。代码质量方面强调单一职责、小函数、清楚的数据流;参数化查询、输入校验与异常处理;不硬编码密钥,走环境变量或配置,不回显敏感值;命名达意,注释解释“为什么”;低耦合、配置化、避免过度工程;固定随机种子、锁依赖版本、记录环境。
工程实践 支持 Git 版本控制,功能分支不直接推 main,提交信息有意义,仅用户明确要求才提交或推送。依赖与环境方面给出 uv 路线:uv init、uv add、uv lock/uv sync、uv run、uv python pin;也支持 Poetry:poetry add、poetry install,依赖放 PEP 621 的 [project.dependencies],dev 依赖入 [tool.poetry.group.dev],CI 固定 Poetry 版本;始终提交 lock 文件。测试使用 pytest,覆盖 test_.py、test_ 自动发现、纯 assert、fixture 作用域、parametrize、conftest.py、pytest -x、覆盖率报告。质量门包括 Ruff 的 lint 与 format 两条命令、mypy/pyright 按项目性质选档、pre-commit 用 rev 锁版本并接 ruff-pre-commit、必要时使用 SonarQube 卡质量阈值。CI 使用 GitHub Actions,checkout、setup-python、依赖安装、ruff check、pytest,矩阵多版本并行,secrets 注入。文档要求 README 含安装、运行、复现命令,关键模块注释与运行说明。
调试与审查 提供系统化调试方法:逐字读错误、稳定复现、查最近改动、边界埋点定位、反向追数据流到源头修,一次只改一个变量,连修三次仍失败则停手质疑架构。自我代码审查按 Critical/Important/Minor 分级并过五查与 YAGNI。另有改进架构的“删除测试”诊断、拆子任务与收尾分支流程。安全方面,创建网络暴露接口若无鉴权必须主动指出安全影响。
使用方式与产出 推荐 TDD:先写最小失败测试并确认其失败,再写最简实现转绿,绿灯后才重构。起步可复制同目录 assets/project-scaffold/,含 pyproject.toml、pre-commit 配置、CI、示例模块与测试、代码审查清单、调试脚本。产出可运行代码、测试、依赖与环境说明、README 与运行命令,结构规整后交接;实验代码阶段的标准交接工件为 run_manifest.md,记录运行命令、环境、产物路径与关键指标。
适用场景与限制 适用于后端接口、系统逻辑、实验与数据处理代码的编写和审查,以及论文复现落地中的实现差异逼近。论文复现失败归因指向原文问题时移交 research-ethics,不在代码里轻率断言原文有错。单人脚本或一次性实验依靠本地 ruff、mypy、pytest 即可,不必上 SonarQube 等重型基建。具体工具硬信息与专题细节需查阅同目录 references 文件;价格、收费与平台支持等资料暂未提供。