SuperAPI AI 工具集

planning

编程与开发

查看项目

更新于 10-16 02:40

技能介绍

用途:在开始非平凡的功能开发、重构或多文件改动前,强制先做结构化设计思考,避免没有明确方向就动手写代码。

适用场景:跨多个文件或模块的新功能;涉及后端、前端或数据接入层的重构;根因不明确的缺陷修复;以及实现思路不直观的任务。

工作流程分四个阶段。第一阶段理解问题:先阅读相关代码、schema 和测试,不修改未读过的代码;一次只问一个澄清问题;识别约束,包括受影响层次(Java 后端、React 前端、Python 接入、JSON schema)、可参考的既有模式、是否需要数据库迁移(bootstrap/sql/migrations/ 中的 Flyway)、是否需要 schema 变更(openmetadata-spec/ 的 JSON schema)。

第二阶段提出方案:给出 2 到 3 个方案及取舍,每个方案说明实现方式、优点、缺点、受影响文件和风险等级,并给出推荐及理由,等待用户批准后再继续。

第三阶段制定实施计划:将方案拆成有序任务,每个任务可在单步内完成,需写明要创建或修改的确切文件路径、具体改动内容以及验证命令;按依赖排序,schema 变更先于模型生成,后端先于前端,最后包含运行相关测试的验证任务。OpenMetadata 的典型顺序为:JSON Schema 变更、运行 make generate、Java 后端变更、运行 mvn spotless:apply && mvn test-compile、Python 接入变更、运行 cd ingestion && make py_format && make py_format_check && make unit_ingestion_dev_env、前端变更、运行 yarn lint && yarn test、必要时数据库迁移、最后运行 mvn test 或相关集成测试。

第四阶段执行:按任务推进并标记完成,遇到阻塞应停下讨论而非擅自偏离计划,全部完成后运行最终验证。

规则:不得跳过第二阶段;不使用占位代码,每步须描述真实完整的改动;涉及数据模型时遵循 schema 优先;计划获批前不写代码。

限制:该技能面向 OpenMetadata 仓库的技术栈与目录结构,其他项目需自行调整;资料未提供安装方式、收费或平台信息。