SuperAPI AI 工具集

architecting-python-changes

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:这是 myai 的 architecting-changes 技能的 Python 专属扩展,面向非平凡的 Python 架构决策,既是精简指南,也是通往更深项目文档与领域技能的“路由器”。

使用前提:需先加载 myai 的 architecting-changes(父技能);using-my-skills 与 engineering-principles 假定已通过 myai bootstrap 加载。通用架构决策框架(边界、分层、包装器、可复用核心、组合根、框架选择)见父技能;本技能补充 Python 专属内容。

主要能力:默认遵循父技能 6 步流程(classify → find change axis → identify question → choose boundary → route → continue),再用 Python 专属路由定位合适的 Python 技能。Python 专属启发式:用 pyproject.toml 中的 ruff banned-api 强制执行第三方包装器;选库时分析类型支持(basedpyright strict 兼容);多 UI 模式见 building-multi-ui-apps;平台边界默认跨平台(Windows/macOS/Linux),刻意 OS 专属项目是例外,独立脚本可保持 OS 专属;复杂 OS 行为作为边界,用 Protocol 每 OS 一个实现并在启动时选择一次,禁止在业务逻辑中散落 if sys.platform。

查阅来源:engineering-principles(核心架构原则)、docs/coding_rules.md(包装器强制、循环导入处理、架构边界、错误边界、布局期望)、setting-up-python-projects(仓库/包结构、脚手架、框架选择)、setting-up-python-backends(后端、API 服务、worker 系统)、building-backends(后端/服务分层、事务、认证、worker)、building-multi-ui-apps(CLI/GUI/API/自动化共享业务逻辑、适配器、组合根)、building-qt-apps(PySide6/Qt、事件循环、信号、平台集成)、writing-python-code(结构选定后,实现类型化包装器、处理导入环、编码边界)。

交接:架构方向明确后继续 writing-python-code;若是全新项目或重大重塑,同时查阅 setting-up-python-projects;若需正式计划,先走项目正常规划流程再实施。

限制:本技能是父技能扩展与路由,本身不提供完整代码示例;具体实现与项目细节需依赖上述相关技能与文档。其他收费、平台、效果等信息暂未提供。