用途:forze-skills 是 Forze 框架的参考文档路由索引,帮助开发者按任务查找架构、规格、依赖装配、处理器、聚合、路由、身份、加密、消息、实时通信等主题的说明文件。
核心心智模型:应用声明逻辑规格(如 DocumentSpec、QueueSpec、StorageSpec),只命名资源而不指定物理实现;Deps 模块在装配时把逻辑名称映射到真实后端(Postgres 表、SQS 队列、S3 桶);处理器通过 ExecutionContext 解析出的端口访问基础设施;运行时组装并冻结注册表后按流水线执行操作。
用法:多数任务需按顺序阅读 3 到 5 份参考文档,而非单份文件。索引给出常见任务的阅读顺序,例如新服务引导读 architecture 到 connection-settings,受治理聚合读 aggregate-models 到 testing-with-mock,自定义处理器读 execution-context、handlers、query-dsl,HTTP 暴露读 fastapi-setup 到 fastapi-identity,字段加密读 field-encryption 到 spec-to-backend-config,故障模拟读 dst-simulation 到 testing-with-mock。
覆盖范围:基础架构与执行上下文、规格与装配、领域模型、数据读写、事件与消息、实时传输、持久化执行(Temporal、Inngest)、FastAPI 接口、身份与多租户、密钥、字段加密与 KMS、对象存储、出站 HTTP、分析与图、推理、故障注入测试、错误与可观测性、弹性与停机等。
限制:文档按版本发布,链接使用最新版;若应用锁定较旧的 forze 次版本,需替换 URL 中的 latest 为对应版本号(如 .../forze/0.6/...)或使用站点版本选择器。文档为参考索引,实际内容位于 references/ 目录下的文件中;具体命令、代码示例与安装方式在提供的资料中暂未给出。