Archestra后端接口开发
输入Archestra后端接口新增或修改需求,联动调整路由、权限与数据访问,生成配套客户端并验证改动。
功能与用途
用于在Archestra项目中新增或修改后端接口。提供接口需求、请求与响应字段、访问权限及相关业务逻辑后,可按项目约定调整路由、服务和数据模型,并同步关联的MCP工具、接口文档及生成式客户端。还涵盖分页、错误响应和环境变量配置,帮助交付配套完整的后端改动。使用前需具备项目源码及可运行的开发环境;涉及数据库结构变更时,需要配合迁移技能。
适用场景
- 新增业务接口:为新实体添加接口、路由注册和权限映射,并生成对应的接口文档与客户端代码。
- 同步接口字段变更:修改请求或响应字段,同时更新关联MCP工具及生成式客户端,保持调用契约一致。
- 排查接口权限异常:检查接口标识、权限映射及数据库角色读取逻辑,定位新增接口返回403的问题。
- 接入后端配置项:添加环境变量解析、示例配置和部署文档,并在需要时向前端开放配置。
适用人群
- Archestra后端开发者
- Archestra全栈开发者
- Archestra开源贡献者
使用步骤
- 提供接口需求、字段定义、权限范围和相关代码。
- 确认路由、服务与模型需要调整的位置。
- 修改接口并补齐注册、权限和关联MCP工具。
- 重新生成接口文档与API客户端代码。
- 运行类型、代码规范、测试和未使用代码检查。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-11-03
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when adding or changing Archestra backend routes, models, services, API request/response schemas, endpoint permissions, or OpenAPI/codegen for the generated API client.
使用前准备
- 已取得Archestra项目源码,并具备可运行的项目开发环境。
- 了解TypeScript后端开发,能说明接口字段、业务逻辑及权限要求。
- 涉及数据库结构变更时,需配合archestra-dev-migrations;单元测试规范需参考关联测试文档。