# AI Backend Foundry

> 设计或扩展可复用的 Python AI 后端模板，覆盖 Core、业务集成、RAG、Agent 和工作流；适用于架构落地与模块解耦。

- Skill: `hongbozcode/ai-backend-foundry` (Agent Skill, multi-file: 30 files)
- Install (CLI): `npx skillmds@latest add hongbozcode/ai-backend-foundry`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hongbozcode/ai-backend-foundry/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: hongbozcode (https://skillmd.com/u/hongbozcode)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/hongbozcode/ai-backend-foundry

---


# AI Backend Foundry · AI 后端工坊

这是跨项目通用 AI 后端 Skill，不依赖其他 Skill、MCP 服务或插件；可选框架样例的 Python 库依赖见运行说明。参考项目不是运行依赖。遵循目标仓库约定和用户技术选型。确认涉及模块，区分演示与生产能力，再修改和验证。

## 按需读取

只读本次相关参考；不遍历全部文档或源码。遇到跨模块依赖或实现问题再展开。

| 任务 | 参考 |
|---|---|
| 新建骨架、跨模块依赖 | [架构](references/architecture.md) |
| 配置、日志、认证授权 | [Core](references/core.md) |
| 业务后端、第三方调用 | [Biz](references/biz.md) |
| 入库、切片、索引、检索 | [RAG](references/rag.md) |
| 调度、工具、记忆 | [Agent](references/agent.md) |
| 节点编排、引擎 | [Workflows](references/workflows.md) |
| 修改框架接入 | [LangChain / LangGraph](references/langchain-langgraph.md) |
| 运行样例、配置驱动 | [配置与运行](references/configuration.md) |

## 约束与落地

- 核心依赖接口，组合根选择驱动，业务规则留在场景包；Core 不依赖上层。
- 身份来自可信上下文，工具和资源均鉴权；凭据不进日志、模型或状态。
- 未注册配置启动失败；禁用 Biz 不注册工具。失败不能冒充空数据或成功。
- 写操作需业务授权；未知结果先查状态，不自动重放。不可信数据不能改变权限。
- 新项目按需复制 `assets/starter/`，不覆盖已有文件；复制或运行无需先全文阅读。CLI 为本地演示，框架样例使用真实框架和测试模型，不代表生产驱动已接通。
- 完整设计保留职责、抽象、扩展点、默认实现、未来适配五部分；局部任务只交付相关变更。SDK 用法核对所用版本的官方文档；查询方式遵循目标环境约定，不依赖特定检索工具或插件。
- 验证受影响流程及失败边界，报告验证结果与限制；无需每次运行所有样例。