prime-backend

Prime Backend：加载后端上下文

目标

通过分析代码库的结构、路由、服务和数据层，针对性地了解后端代码库。仅加载后端上下文，可以让复杂的全栈代码库占用较少的上下文窗口。如果提供了外部任务参考资料，请先加载，以便分析围绕实际工作展开。

流程

步骤 0：加载外部上下文

请在分析代码库之前运行此步骤。 可选参数为：[jira-issue-keys] [confluence-page-ids]。

• Jira 键可以是单个键（ACC-2），也可以是以逗号分隔的多个键（ACC-2,ACC-3）。
• Confluence 页面 ID 是数字页面 ID。

如果提供了 Jira 问题键：

1. 调用 mcp__atlassian__getAccessibleAtlassianResources，获取 cloudId。
2. 对每个 Jira 键，调用 mcp__atlassian__getJiraIssue，并传入该 cloudId、问题键以及 responseContentFormat: "markdown"。
3. 将返回的问题摘要、描述和验收标准作为后续所有工作的任务上下文。

如果提供了 Confluence 页面 ID：

1. 对每个页面 ID 调用 mcp__atlassian__getConfluencePage，并传入 contentFormat: "markdown"（使用上一步获取的 cloudId；如果尚未获取，则通过 mcp__atlassian__getAccessibleAtlassianResources 获取）。
2. 将返回的页面内容作为辅助上下文（规范、设计文档、需求）。

如果未提供任何参数： 完全跳过此步骤，继续步骤 1。

继续操作前，简要总结已加载的任何外部上下文，以此作为后续准备工作的基础。

1. 定位后端

列出所有已跟踪文件，以查找后端根目录：

!git ls-files

常见的后端根目录：backend/、server/、api/、app/（FastAPI/Django）、src/（仅后端项目）。继续之前，先确定正确的根目录。

2. 阅读后端文档

• 阅读 CLAUDE.md 或类似的全局规则文件（了解项目级约定）
• 阅读后端根目录中的任何 README
• 如果 .claude/references/backend-api-best-practices.md 存在，请阅读该文件——其中包含项目特定的 API 约定

3. 确定关键后端文件

根据项目结构，阅读以下内容：

• 主入口文件（main.py、app.py、server.ts、index.ts 等）
• 路由注册文件 / 路由器索引（routes/、api/、routers/）
• 核心配置（pyproject.toml、package.json、tsconfig.json）
• 数据库配置和 ORM 设置（database.py、db.ts、alembic.ini）
• 核心数据模型或架构（models/、schemas/）
• 一两个有代表性的功能切片（路由 + 服务 + 模型），以熟悉既定模式
• 中间件和依赖注入设置

跳过后端根目录之外的文件，除非这些文件定义了后端对外提供的共享类型或契约。

4. 了解当前后端状态

检查近期与后端相关的活动：

!git log -10 --oneline

!git status

记录尚未完成的迁移、待处理的架构变更或正在进行的 API 变更。

输出报告

提供一份简洁的摘要，涵盖以下内容：

外部任务上下文（如已加载）

• Jira 问题：键、标题、单行目标、验收标准
• Confluence 页面：标题及其规范内容

后端概览

• 框架和主要库（FastAPI、Django、Express、NestJS 等）
• 语言和运行时版本
• 数据库和 ORM（PostgreSQL + SQLAlchemy、MongoDB + Mongoose 等）

目录结构

• 后端根目录和关键子目录，并各用一行说明其用途

架构模式

• 路由、服务和数据访问的分层方式
• 所观察到的依赖注入或中间件模式
• 错误处理方式

约定

• 命名约定、模块组织方式
• 迁移工具和当前迁移状态
• 所观察到的测试框架和约定

当前状态

• 当前分支及近期后端变更
• 待处理的迁移或架构变更
• 任何需要立即关注的问题（缺少验证、未处理的错误等）

请让此摘要便于快速浏览——使用项目符号和清晰的标题。