SuperAPI AI 工具集

code-generation-developer

编程与开发

查看项目

更新于 10-15 19:57

技能介绍

用途:这是 anytype-swift 仓库中的代码生成智能路由技能,用于在涉及代码生成时给出上下文相关的指引,覆盖 SwiftGen、Sourcery、功能开关(Feature Flags)与 Protobuf 四类生成工作流,帮助判断何时以及如何运行生成器。

主要能力:在运行或讨论 make generate、添加功能开关、处理生成文件等场景下自动激活。核心规则包括:绝不手动编辑带“// Generated using Sourcery/SwiftGen”标记的生成文件;修改模板、开关、资源或本地化后必须运行 make generate;新功能应使用功能开关包裹;应修改源文件而非生成代码。

必要用法:常用命令为 make generate(运行全部生成器,含 SwiftGen、Sourcery、资源与本地化)、make generate-middle(依赖变化时重新生成中间件与 protobuf)、make setup-middle(中间件初始设置)。功能开关流程为:在 FeatureDescription+Flags.swift 中定义开关,运行 make generate 生成 FeatureFlags.swift,再在代码中通过 import AnytypeCore 后使用。开关类型有 .debug 与 .feature(author:releaseVersion:)。

适用场景:新增或更新 .xcstrings、功能开关、Assets.xcassets 图标、Sourcery 模板,或更新中间件版本时,分别对应运行 make generate 或 make generate-middle。

限制与注意:编辑生成文件会被覆盖;忘记生成会导致标识符未解析错误;中间件二进制缺失时可用 make setup-middle 或 make generate 处理。完整细节需参考仓库内 CODE_GENERATION_GUIDE.md。