SuperAPI AI 工具集

coding-standards

编程与开发

查看项目

更新于 10-17 09:09

技能介绍

历史资料:来源为 2026 年 9 月 8 日(UTC)的公开提交。当前核对的仓库版本中已无该文件路径,现行安装和兼容性未验证。

用途:在 TypeScript 或 Effect 开发中约束接口、数据边界、错误、副作用和测试设计,也可供其他流程引用编码规范。

核心内容:优先保证正确性、安全性和可调试性;将预期失败表示为值,将外部数据解析为有意义的类型;保持领域计算纯粹,把应用策略、框架机制和资源组装交给各自模块。

流程:先读本地约定和版本,沿调用方可见行为梳理输入、决策、效果和结果,再按涉及的主题读取错误、持久化、幂等、配置、测试等参考文档,确认公共契约后实现完整路径。

验收:通过真实接口或忠实实现验证行为、失败和恢复语义,运行仓库要求的检查,并说明必要抽象和权衡。本文件引用多份配套文档,单独保存这一入口不代表配套材料均已取得。