SuperAPI AI 工具集

setting-up-projects

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:在创建新项目、引导仓库或选择任意语言与生态的初始项目形态时使用。先加载 engineering-principles;深入架构决策时再加载 architecting-changes。

先选形态:按预期变更轴与未来调用方决定结构,而非仅按惯例。一次性小工具用单文件脚本并内联依赖,不强制完整项目布局;可复用库用清晰公共 API 的包,必要时加薄 CLI;CLI 应用采用 core/、cli/、utils/、wrappers/ 分层;多接口应用用共享领域层 + 独立展示适配器 + 单一组合根;后端服务/API/worker 使用服务专用布局。

布局模式:给出 project/ 结构起点,含 src/appname/ 下 core(models、services)、cli、ui、utils、wrappers、entrypoint,以及 tests/unit、integration、fixtures、scripts、docs 和各类配置。wrappers 用于隔离第三方、平台相关或弱类型边界;entrypoint 保持薄,只做引导与委托。

设置清单:创建目录结构;复制基线文件(清单、linter、CI、忽略文件、编辑器设置,并放入标准与理念文档);裁剪未用部分;创建薄入口;创建初始冒烟测试(走通入口,不测业务逻辑,显式设置命令行参数);初始化环境(版本控制、依赖、linter、类型检查、测试,用任务运行器而非系统二进制);验证全部通过。

优雅关闭:简单脚本/CLI 捕获中断信号并以标准信号码退出;包装快速子任务的 CLI 立即杀掉进程组;包装复杂外部工具的 CLI 采用优雅信号→等待超时→强杀升级;长驻事件循环应用在事件循环内处理信号。生成子进程时始终使用进程组。目标是 Ctrl+C 始终干净工作。

领域适配:脚手架后按领域调整目录、依赖、linter/类型检查配置、项目导览、编码标准、测试结构和 CI/CD;不熟悉领域时先调研领域惯例与库兼容性。还提供快速定制清单,并指向 engineering-principles、architecting-changes、writing-scripts、building-backends、setting-up-backends、ci-cd-and-automation 等相关技能;Python 可加载 setting-up-python-projects 扩展,其他生态若无专用技能则按上述模式并记录缺口。