SuperAPI AI 工具集

impl-standards

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:在实现阶段应用统一的工程规范,保证代码一致、可维护。适用于编写新生产代码、发布前质量核查,以及用户提到错误处理、常量、魔法数字、进度日志、SSoT、依赖注入、配置单例等场景。

主要能力与规则:错误处理要求抛出并传播,不使用兜底、默认值、重试或静默捕获;常量管理要求把魔法数字抽象为语义化、与版本无关的动态常量;SSoT/依赖注入采用配置单例→None 默认值+解析器→入口点校验;依赖优先使用开源库而非自研,无需向后兼容;超过 1 分钟的操作每 15-60 秒记录一次状态;日志保存为 logs/{adr-id}-YYYYMMDD_HHMMSS.log,可用 nohup 运行,例如 nohup python script.py > logs/2025-12-01-my-feature-20251201_143022.log 2>&1 &;可选提供 catalog-info.yaml 用于服务发现。数据处理优先使用 Polars 而非 Pandas,新数据管道用 Polars,ML 特征工程走 Polars→Arrow→NumPy,MLflow 记录可用 Pandas 但需加例外注释,遗留代码保持原库。

使用方式:在 /itp:go 第一阶段或写新代码时套用上述规则,发布前核查。该技能为自演进型,遇到真实可复现的问题应直接修正本文件。

限制:资料未提供安装命令、收费、平台支持等具体信息;相关技能包括 adr-code-traceability、code-hardcode-audit、ml-data-pipeline-architecture。