SuperAPI AI 工具集

forge-idiomatic-developer

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

用途:在编写、编辑或审查任何语言中使用 forgelib 库的代码时加载本技能,避免凭相似库推断 Forge 行为。

主要能力:Forge 提供多数应用需要的后端原语,默认使用 Postgres 后端。需从 forge.toml 初始化一个客户端,并使用 Forge 实际 API。应使用项目解析出的 Forge 版本;当签名或行为重要时,查看已安装声明;编辑 Forge 本身时使用仓库源码。

语言参考:Node.js/TypeScript 见 references/node.md,Python 见 references/python.md,Rust 见 references/rust.md。仅在适用时读取:references/runtime-contract.md(配置、错误、部署、队列、调度、限流、发布订阅、预签名、标志、维护)、references/application-design.md(非平凡服务、存储决策、认证流程、跨系统副作用、生命周期、测试策略)、references/nextjs.md(Next.js 集成)。不要预加载无关语言或框架参考。

原语选择:kv 用于直接键值、TTL 状态、计数器、CAS,限制为单键操作与弱一致前缀扫描;queue 用于持久后台工作与重试,需有归属消费者,至少一次;pubsub 用于临时实时扇出,至多一次且仅在线订阅者;blob 用于文件与预签名传输 URL,应用须自行执行归属策略;auth 用于密码、会话、API 密钥、一次性令牌,应用拥有用户与授权记录;ratelimit 用于请求限流,失败模式是安全/可用性选择,不是业务计数器;schedule 用于 Cron 或延迟入队,应用须运行调度器 tick;config 用于运行时设置与发布标志,有缓存,密钥仍由环境提供。

核心契约:队列投递并发且至少一次,用投递回执或租约作业结算,而非稳定 id;仅在逻辑效果成功后确认。幂等性应限定到逻辑效果,作业 id 可作重投基础,扇出可能需要 job-id:recipient-id,重复作业可能需要稳定领域操作 id。尽量使用托管 worker,保留其 promise/task/future,发出关闭信号并等待完成。按所选功能运行调度与维护循环。连接字符串保留在服务端,Forge 内部表保持私有。预签名需要非空密钥且无空回退,须授权访问并精确校验签发方法、键、过期、最大字节与签名。

完成前:对照项目已安装 Forge 版本核验方法名、同步/异步、选项顺序、默认值与错误行为;确认所选原语支持所需行为;确认每个产生的队列在部署系统中有明确消费者,并在逻辑副作用边界测试重投;在应用真实进程拓扑中验证生命周期;测试 Forge 边界与对变更重要的失败模式。

限制:资料未提供具体安装命令、价格、平台支持范围或性能数据。