目實(shí)踐：基于 Express.js + TypeScript + Prisma 的 REST API 模板全解析)
Agentic Awesome Skills 項(xiàng)目實(shí)踐基于 Express.js TypeScript Prisma 的 REST API 模板全解析【免費(fèi)下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills導(dǎo)讀本文以 Agentic Awesome SkillsAAS倉庫中 app-builder 技能的 express-api 項(xiàng)目模板 為核心主體系統(tǒng)拆解一套以 Node.js 20、Express.js、TypeScript、PostgreSQL Prisma、Zod、JWT bcrypt 為技術(shù)棧的 REST API 腳手架原則。讀完本文你將掌握這套模板的目錄分層、中間件裝配順序、統(tǒng)一響應(yīng)契約、初始化命令與工程最佳實(shí)踐并理解它如何在 AAS 的 app-builder 編排體系中通過關(guān)鍵詞檢測(cè)被自動(dòng)選中作為 Agent 快速落地 API 服務(wù)的基線規(guī)范。模板定位App Builder 技能樹中的 REST API 分支在 AAS 倉庫中express-api 模板并不是孤立存在的文件而是 app-builder 技能 下 13 個(gè)項(xiàng)目模板之一。該技能整體承擔(dān)應(yīng)用構(gòu)建編排器職責(zé)分析用戶自然語言請(qǐng)求 → 判定項(xiàng)目類型 → 選擇技術(shù)棧 → 規(guī)劃目錄結(jié)構(gòu) → 協(xié)調(diào)多個(gè)專職 Agent 分工實(shí)施。在 templates/SKILL.md 的模板索引表中express-api對(duì)應(yīng)的技術(shù)棧標(biāo)記為 Express JWT適用場(chǎng)景明確為REST API在 project-detection.md 的關(guān)鍵詞矩陣中當(dāng)用戶請(qǐng)求中出現(xiàn)api、backend、service、rest等關(guān)鍵詞時(shí)項(xiàng)目類型被判定為 API Service并自動(dòng)路由到express-api模板該技能同時(shí)維護(hù)了配套的 tech-stack.md2025 默認(rèn)技術(shù)棧選型與 scaffolding.md目錄結(jié)構(gòu)與核心文件原則本文討論的模板正是這些全局原則在純后端 API場(chǎng)景下的具體落地。因此這套模板的目標(biāo)讀者與使用者是需要從零搭建后端服務(wù)的 Agent 或開發(fā)者希望獲得一套開箱即用、結(jié)構(gòu)清晰、類型安全、帶鑒權(quán)與校驗(yàn)?zāi)芰Φ?Express 工程基線。技術(shù)?？傆[模板在 frontmatter 中聲明了核心定位Express.js REST API template principles. TypeScript, Prisma, JWT.并以表格固化了一組默認(rèn)選型組件技術(shù)運(yùn)行時(shí)Node.js 20框架Express.js語言TypeScript數(shù)據(jù)庫PostgreSQL Prisma校驗(yàn)Zod鑒權(quán)JWT bcrypt這組選型與 AAS 全局技術(shù)棧文檔 tech-stack.md 的默認(rèn)方向保持一致數(shù)據(jù)庫首選 PostgreSQL、ORM 首選 Prisma/Drizzle、校驗(yàn)首選 Zod/TypeBox?？梢酝茢嗄０灏押蠖?API 場(chǎng)景收斂為一條確定性的技術(shù)路徑Express 負(fù)責(zé) HTTP 層Prisma 負(fù)責(zé)類型安全的數(shù)據(jù)庫訪問Zod 負(fù)責(zé)運(yùn)行時(shí)輸入校驗(yàn)JWT bcrypt 負(fù)責(zé)身份認(rèn)證與密碼哈希TypeScript 在編譯期提供全鏈路類型保障。需要說明的適用前提Node.js 20 是模板聲明的最低運(yùn)行時(shí)版本要求PostgreSQL 是 Prisma 的默認(rèn)數(shù)據(jù)庫目標(biāo)實(shí)際使用時(shí)需在prisma/schema.prisma中配置正確的數(shù)據(jù)源連接串。目錄結(jié)構(gòu)分層架構(gòu)的物理映射模板給出了標(biāo)準(zhǔn)的目錄骨架這是整套工程規(guī)范的核心骨架完整繼承如下project-name/ ├── prisma/ │ └── schema.prisma ├── src/ │ ├── app.ts # Express setup │ ├── config/ # Environment │ ├── routes/ # Route handlers │ ├── controllers/ # Business logic │ ├── services/ # Data access │ ├── middleware/ │ │ ├── auth.ts # JWT verify │ │ ├── error.ts # Error handler │ │ └── validate.ts # Zod validation │ ├── schemas/ # Zod schemas │ └── utils/ └── package.json該結(jié)構(gòu)與 scaffolding.md 中強(qiáng)調(diào)的分層架構(gòu)、職責(zé)單一原則一脈相承每一層有明確邊界prisma/schema.prisma唯一的數(shù)據(jù)庫模型定義入口數(shù)據(jù)模型、枚舉、關(guān)系都在此聲明是后續(xù)遷移與類型生成的源頭src/app.tsExpress 應(yīng)用裝配入口負(fù)責(zé)注冊(cè)中間件棧、掛載路由、啟動(dòng)服務(wù)src/config/集中管理環(huán)境變量讀取與配置對(duì)象避免配置散落各處對(duì)應(yīng)最佳實(shí)踐Environment-based configsrc/routes/只做 URL 到 handler 的映射保持薄路由具體邏輯下沉到 controllersrc/controllers/業(yè)務(wù)編排層接收請(qǐng)求、調(diào)用 service、組裝響應(yīng)對(duì)應(yīng)最佳實(shí)踐Layer architecture的中間層src/services/數(shù)據(jù)訪問層封裝 Prisma 查詢與領(lǐng)域操作controller 不直接觸碰數(shù)據(jù)庫src/middleware/auth.tsJWT 校驗(yàn)中間件保護(hù)需要認(rèn)證的路由src/middleware/error.ts全局錯(cuò)誤處理中間件統(tǒng)一輸出錯(cuò)誤響應(yīng)src/middleware/validate.ts基于 Zod schema 的請(qǐng)求校驗(yàn)中間件src/schemas/集中存放 Zod schema供校驗(yàn)中間件與類型推導(dǎo)復(fù)用src/utils/通用工具函數(shù)?？蓮?fù)制執(zhí)行的目錄創(chuàng)建命令如下示例mkdir -p project-name/src/{config,routes,controllers,services,middleware,schemas,utils} mkdir -p project-name/prisma中間件棧請(qǐng)求生命周期的裝配順序模板明確規(guī)定了中間件裝配的六步順序這一順序直接影響請(qǐng)求處理的安全性與正確性順序中間件職責(zé)1helmet安全防護(hù)設(shè)置各類 HTTP 安全響應(yīng)頭2cors跨域資源共享配置3morganHTTP 請(qǐng)求日志4body parsing解析 JSON/urlencoded 請(qǐng)求體5routes業(yè)務(wù)路由6error handler統(tǒng)一錯(cuò)誤兜底順序背后的原理可以這樣理解helmet 與 cors 屬于全局安全前置必須在任何業(yè)務(wù)邏輯前生效morgan 記錄請(qǐng)求日志應(yīng)盡早介入以捕獲完整請(qǐng)求信息body parsing 必須在路由之前執(zhí)行否則控制器拿不到請(qǐng)求體錯(cuò)誤處理中間件必須放在最后才能捕獲前面所有環(huán)節(jié)拋出的異常。這是 Express 中間件洋蔥模型的標(biāo)準(zhǔn)排布方式。對(duì)應(yīng)的裝配示例依據(jù)模板順序展開import express from express; import helmet from helmet; import cors from cors; import morgan from morgan; import { errorHandler } from ./middleware/error; import routes from ./routes; const app express(); app.use(helmet()); // 1. security headers app.use(cors()); // 2. cross-origin app.use(morgan(dev)); // 3. logging app.use(express.json()); // 4. body parsing app.use(routes); // 5. business routes app.use(errorHandler); // 6. error handler export { app };API 響應(yīng)契約統(tǒng)一的數(shù)據(jù)信封模板定義了前后端約定俗成的統(tǒng)一響應(yīng)結(jié)構(gòu)這是團(tuán)隊(duì)協(xié)作與前端類型化的基礎(chǔ)類型結(jié)構(gòu)成功{ success: true, data: {...} }失敗{ error: message, details: [...] }成功響應(yīng)統(tǒng)一包一層success: true布爾標(biāo)記與data數(shù)據(jù)負(fù)載客戶端據(jù)此無需再自行判斷狀態(tài)碼語義錯(cuò)誤響應(yīng)使用error字段承載人類可讀的錯(cuò)誤信息details數(shù)組用于攜帶結(jié)構(gòu)化細(xì)節(jié)典型場(chǎng)景是 Zod 校驗(yàn)失敗時(shí)的字段級(jí)錯(cuò)誤列表。這一契約由middleware/error.ts全局錯(cuò)誤處理器與middleware/validate.tsZod 校驗(yàn)失敗轉(zhuǎn)換共同保障確保所有路由共享同一套錯(cuò)誤格式。示例錯(cuò)誤響應(yīng)形狀{ error: Validation failed, details: [ { field: email, message: Invalid email address } ] }初始化步驟從空目錄到可運(yùn)行服務(wù)模板給出了六步初始化流程這是落地最快的路徑創(chuàng)建項(xiàng)目目錄mkdir project-name初始化包管理npm init -y安裝依賴npm install express prisma zod bcrypt jsonwebtoken配置 Prismanpx prisma init生成 schema 與連接配置并在prisma/schema.prisma中聲明數(shù)據(jù)模型推送數(shù)據(jù)庫結(jié)構(gòu)npm run db:push對(duì)應(yīng)prisma db push將 schema 同步到 PostgreSQL啟動(dòng)開發(fā)服務(wù)npm run dev對(duì)應(yīng)tsx watch或nodemon驅(qū)動(dòng)的 TypeScript 開發(fā)腳本由于模板同時(shí)使用 TypeScript 與 Prisma實(shí)際工程通常還需補(bǔ)充以下開發(fā)依賴與腳本依據(jù)技術(shù)棧推導(dǎo)供參考npm install -D typescript tsx types/express types/jsonwebtoken types/bcrypt// package.json scripts示意 { scripts: { dev: tsx watch src/app.ts, build: tsc, db:push: prisma db push, db:migrate: prisma migrate dev } }關(guān)于db:push與db:migrate的取舍db:push適合模板初始化階段的快速建表直接依據(jù) schema 同步數(shù)據(jù)庫結(jié)構(gòu)而不產(chǎn)生遷移歷史進(jìn)入正式迭代后應(yīng)切換到prisma migrate dev生成可版本化的遷移文件。最佳實(shí)踐模板背后的工程底線模板在結(jié)尾固化了一批最佳實(shí)踐逐條展開如下分層架構(gòu)routes → controllers → services嚴(yán)格的三層依賴方向路由不寫業(yè)務(wù)、控制器不寫 SQL、服務(wù)層負(fù)責(zé)數(shù)據(jù)訪問對(duì)應(yīng)目錄結(jié)構(gòu)中的routes/、controllers/、services/三個(gè)目錄。這與 scaffolding.md 強(qiáng)調(diào)的薄路由、邏輯下沉原則一致使用 Zod 校驗(yàn)所有輸入所有請(qǐng)求體、查詢參數(shù)、路徑參數(shù)都應(yīng)經(jīng)過middleware/validate.ts校驗(yàn)schema 統(tǒng)一存放在schemas/既能運(yùn)行時(shí)攔截非法輸入又能通過z.infertypeof schema推導(dǎo)出靜態(tài)類型集中式錯(cuò)誤處理絕不散落 try/catch統(tǒng)一交給middleware/error.ts收口配合統(tǒng)一的{ error, details }響應(yīng)契約避免錯(cuò)誤格式漂移基于環(huán)境的配置連接串、JWT 密鑰、端口等敏感與可變值全部來自環(huán)境變量集中在config/讀取并導(dǎo)出類型化配置對(duì)象配合.env.example提交模板、.env本地注入的慣例使用 Prisma 實(shí)現(xiàn)類型安全的數(shù)據(jù)庫訪問以prisma/schema.prisma為唯一模型源生成的 Prisma Client 在編譯期約束查詢字段與返回類型從根源上減少手寫 SQL 的拼寫錯(cuò)誤與類型失配。在 App Builder 編排流程中的落地方式了解模板本身之后還應(yīng)理解它在 Agent 工作流中的觸發(fā)與執(zhí)行方式。根據(jù) SKILL.md 的選擇性閱讀規(guī)則當(dāng)收到類似創(chuàng)建一個(gè)帶用戶認(rèn)證的 REST API請(qǐng)求時(shí)編排流程如下project-detection.md 對(duì)請(qǐng)求做關(guān)鍵詞分詞命中api/backend/service/rest后判定項(xiàng)目類型為 API Service指向express-api模板只讀取 templates/express-api/TEMPLATE.md 這一個(gè)模板文件按其技術(shù)棧與目錄結(jié)構(gòu)落地按 agent-coordination.md 的流水線由 Database Architect 設(shè)計(jì) Prisma schema → Backend Specialist 實(shí)現(xiàn) routes/controllers/services/middleware → 進(jìn)入并行階段由 Security Auditor 與 Test Engineer 審查與補(bǔ)測(cè) → 最后由 DevOps Engineer 配置環(huán)境與部署。這套模板的價(jià)值在于把Express API 工程長(zhǎng)什么樣的隱性經(jīng)驗(yàn)顯性化為可復(fù)用的模板文件讓 Agent 與開發(fā)者共享同一套結(jié)構(gòu)、契約與規(guī)范減少每次從零搭建時(shí)的決策成本與風(fēng)格漂移。小結(jié)express-api 模板是 AAS app-builder 技能面向純后端 REST API場(chǎng)景的標(biāo)準(zhǔn)化答案以 Node.js 20 為運(yùn)行時(shí)、TypeScript 貫穿全鏈路Express 承載 HTTP 層Prisma 提供 PostgreSQL 的類型安全訪問Zod 把關(guān)所有輸入JWT bcrypt 完成認(rèn)證與密碼安全六步初始化流程可在數(shù)分鐘內(nèi)拉起可運(yùn)行服務(wù)統(tǒng)一響應(yīng)契約與六段式中間件棧則保障了工程的一致性與可維護(hù)性。對(duì)希望讓 Agent 穩(wěn)定產(chǎn)出高質(zhì)量 API 工程的團(tuán)隊(duì)而言這套模板既是腳手架也是一份可直接引用的架構(gòu)規(guī)范。【免費(fèi)下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Agentic Awesome Skills 項(xiàng)目實(shí)踐：基于 Express.js + TypeScript + Prisma 的 REST API 模板全解析
Agentic Awesome Skills 項(xiàng)目實(shí)踐基于 Express.js TypeScript Prisma 的 REST API 模板全解析【免費(fèi)下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills導(dǎo)讀本文以 Agentic Awesome SkillsAAS倉庫中 app-builder 技能的 express-api 項(xiàng)目模板 為核心主體系統(tǒng)拆解一套以 Node.js 20、Express.js、TypeScript、PostgreSQL Prisma、Zod、JWT bcrypt 為技術(shù)棧的 REST API 腳手架原則。讀完本文你將掌握這套模板的目錄分層、中間件裝配順序、統(tǒng)一響應(yīng)契約、初始化命令與工程最佳實(shí)踐并理解它如何在 AAS 的 app-builder 編排體系中通過關(guān)鍵詞檢測(cè)被自動(dòng)選中作為 Agent 快速落地 API 服務(wù)的基線規(guī)范。模板定位App Builder 技能樹中的 REST API 分支在 AAS 倉庫中express-api 模板并不是孤立存在的文件而是 app-builder 技能 下 13 個(gè)項(xiàng)目模板之一。該技能整體承擔(dān)應(yīng)用構(gòu)建編排器職責(zé)分析用戶自然語言請(qǐng)求 → 判定項(xiàng)目類型 → 選擇技術(shù)棧 → 規(guī)劃目錄結(jié)構(gòu) → 協(xié)調(diào)多個(gè)專職 Agent 分工實(shí)施。在 templates/SKILL.md 的模板索引表中express-api對(duì)應(yīng)的技術(shù)棧標(biāo)記為 Express JWT適用場(chǎng)景明確為REST API在 project-detection.md 的關(guān)鍵詞矩陣中當(dāng)用戶請(qǐng)求中出現(xiàn)api、backend、service、rest等關(guān)鍵詞時(shí)項(xiàng)目類型被判定為 API Service并自動(dòng)路由到express-api模板該技能同時(shí)維護(hù)了配套的 tech-stack.md2025 默認(rèn)技術(shù)棧選型與 scaffolding.md目錄結(jié)構(gòu)與核心文件原則本文討論的模板正是這些全局原則在純后端 API場(chǎng)景下的具體落地。因此這套模板的目標(biāo)讀者與使用者是需要從零搭建后端服務(wù)的 Agent 或開發(fā)者希望獲得一套開箱即用、結(jié)構(gòu)清晰、類型安全、帶鑒權(quán)與校驗(yàn)?zāi)芰Φ?Express 工程基線。技術(shù)?？傆[模板在 frontmatter 中聲明了核心定位Express.js REST API template principles. TypeScript, Prisma, JWT.并以表格固化了一組默認(rèn)選型組件技術(shù)運(yùn)行時(shí)Node.js 20框架Express.js語言TypeScript數(shù)據(jù)庫PostgreSQL Prisma校驗(yàn)Zod鑒權(quán)JWT bcrypt這組選型與 AAS 全局技術(shù)棧文檔 tech-stack.md 的默認(rèn)方向保持一致數(shù)據(jù)庫首選 PostgreSQL、ORM 首選 Prisma/Drizzle、校驗(yàn)首選 Zod/TypeBox?？梢酝茢嗄０灏押蠖?API 場(chǎng)景收斂為一條確定性的技術(shù)路徑Express 負(fù)責(zé) HTTP 層Prisma 負(fù)責(zé)類型安全的數(shù)據(jù)庫訪問Zod 負(fù)責(zé)運(yùn)行時(shí)輸入校驗(yàn)JWT bcrypt 負(fù)責(zé)身份認(rèn)證與密碼哈希TypeScript 在編譯期提供全鏈路類型保障。需要說明的適用前提Node.js 20 是模板聲明的最低運(yùn)行時(shí)版本要求PostgreSQL 是 Prisma 的默認(rèn)數(shù)據(jù)庫目標(biāo)實(shí)際使用時(shí)需在prisma/schema.prisma中配置正確的數(shù)據(jù)源連接串。目錄結(jié)構(gòu)分層架構(gòu)的物理映射模板給出了標(biāo)準(zhǔn)的目錄骨架這是整套工程規(guī)范的核心骨架完整繼承如下project-name/ ├── prisma/ │ └── schema.prisma ├── src/ │ ├── app.ts # Express setup │ ├── config/ # Environment │ ├── routes/ # Route handlers │ ├── controllers/ # Business logic │ ├── services/ # Data access │ ├── middleware/ │ │ ├── auth.ts # JWT verify │ │ ├── error.ts # Error handler │ │ └── validate.ts # Zod validation │ ├── schemas/ # Zod schemas │ └── utils/ └── package.json該結(jié)構(gòu)與 scaffolding.md 中強(qiáng)調(diào)的分層架構(gòu)、職責(zé)單一原則一脈相承每一層有明確邊界prisma/schema.prisma唯一的數(shù)據(jù)庫模型定義入口數(shù)據(jù)模型、枚舉、關(guān)系都在此聲明是后續(xù)遷移與類型生成的源頭src/app.tsExpress 應(yīng)用裝配入口負(fù)責(zé)注冊(cè)中間件棧、掛載路由、啟動(dòng)服務(wù)src/config/集中管理環(huán)境變量讀取與配置對(duì)象避免配置散落各處對(duì)應(yīng)最佳實(shí)踐Environment-based configsrc/routes/只做 URL 到 handler 的映射保持薄路由具體邏輯下沉到 controllersrc/controllers/業(yè)務(wù)編排層接收請(qǐng)求、調(diào)用 service、組裝響應(yīng)對(duì)應(yīng)最佳實(shí)踐Layer architecture的中間層src/services/數(shù)據(jù)訪問層封裝 Prisma 查詢與領(lǐng)域操作controller 不直接觸碰數(shù)據(jù)庫src/middleware/auth.tsJWT 校驗(yàn)中間件保護(hù)需要認(rèn)證的路由src/middleware/error.ts全局錯(cuò)誤處理中間件統(tǒng)一輸出錯(cuò)誤響應(yīng)src/middleware/validate.ts基于 Zod schema 的請(qǐng)求校驗(yàn)中間件src/schemas/集中存放 Zod schema供校驗(yàn)中間件與類型推導(dǎo)復(fù)用src/utils/通用工具函數(shù)?？蓮?fù)制執(zhí)行的目錄創(chuàng)建命令如下示例mkdir -p project-name/src/{config,routes,controllers,services,middleware,schemas,utils} mkdir -p project-name/prisma中間件棧請(qǐng)求生命周期的裝配順序模板明確規(guī)定了中間件裝配的六步順序這一順序直接影響請(qǐng)求處理的安全性與正確性順序中間件職責(zé)1helmet安全防護(hù)設(shè)置各類 HTTP 安全響應(yīng)頭2cors跨域資源共享配置3morganHTTP 請(qǐng)求日志4body parsing解析 JSON/urlencoded 請(qǐng)求體5routes業(yè)務(wù)路由6error handler統(tǒng)一錯(cuò)誤兜底順序背后的原理可以這樣理解helmet 與 cors 屬于全局安全前置必須在任何業(yè)務(wù)邏輯前生效morgan 記錄請(qǐng)求日志應(yīng)盡早介入以捕獲完整請(qǐng)求信息body parsing 必須在路由之前執(zhí)行否則控制器拿不到請(qǐng)求體錯(cuò)誤處理中間件必須放在最后才能捕獲前面所有環(huán)節(jié)拋出的異常。這是 Express 中間件洋蔥模型的標(biāo)準(zhǔn)排布方式。對(duì)應(yīng)的裝配示例依據(jù)模板順序展開import express from express; import helmet from helmet; import cors from cors; import morgan from morgan; import { errorHandler } from ./middleware/error; import routes from ./routes; const app express(); app.use(helmet()); // 1. security headers app.use(cors()); // 2. cross-origin app.use(morgan(dev)); // 3. logging app.use(express.json()); // 4. body parsing app.use(routes); // 5. business routes app.use(errorHandler); // 6. error handler export { app };API 響應(yīng)契約統(tǒng)一的數(shù)據(jù)信封模板定義了前后端約定俗成的統(tǒng)一響應(yīng)結(jié)構(gòu)這是團(tuán)隊(duì)協(xié)作與前端類型化的基礎(chǔ)類型結(jié)構(gòu)成功{ success: true, data: {...} }失敗{ error: message, details: [...] }成功響應(yīng)統(tǒng)一包一層success: true布爾標(biāo)記與data數(shù)據(jù)負(fù)載客戶端據(jù)此無需再自行判斷狀態(tài)碼語義錯(cuò)誤響應(yīng)使用error字段承載人類可讀的錯(cuò)誤信息details數(shù)組用于攜帶結(jié)構(gòu)化細(xì)節(jié)典型場(chǎng)景是 Zod 校驗(yàn)失敗時(shí)的字段級(jí)錯(cuò)誤列表。這一契約由middleware/error.ts全局錯(cuò)誤處理器與middleware/validate.tsZod 校驗(yàn)失敗轉(zhuǎn)換共同保障確保所有路由共享同一套錯(cuò)誤格式。示例錯(cuò)誤響應(yīng)形狀{ error: Validation failed, details: [ { field: email, message: Invalid email address } ] }初始化步驟從空目錄到可運(yùn)行服務(wù)模板給出了六步初始化流程這是落地最快的路徑創(chuàng)建項(xiàng)目目錄mkdir project-name初始化包管理npm init -y安裝依賴npm install express prisma zod bcrypt jsonwebtoken配置 Prismanpx prisma init生成 schema 與連接配置并在prisma/schema.prisma中聲明數(shù)據(jù)模型推送數(shù)據(jù)庫結(jié)構(gòu)npm run db:push對(duì)應(yīng)prisma db push將 schema 同步到 PostgreSQL啟動(dòng)開發(fā)服務(wù)npm run dev對(duì)應(yīng)tsx watch或nodemon驅(qū)動(dòng)的 TypeScript 開發(fā)腳本由于模板同時(shí)使用 TypeScript 與 Prisma實(shí)際工程通常還需補(bǔ)充以下開發(fā)依賴與腳本依據(jù)技術(shù)棧推導(dǎo)供參考npm install -D typescript tsx types/express types/jsonwebtoken types/bcrypt// package.json scripts示意 { scripts: { dev: tsx watch src/app.ts, build: tsc, db:push: prisma db push, db:migrate: prisma migrate dev } }關(guān)于db:push與db:migrate的取舍db:push適合模板初始化階段的快速建表直接依據(jù) schema 同步數(shù)據(jù)庫結(jié)構(gòu)而不產(chǎn)生遷移歷史進(jìn)入正式迭代后應(yīng)切換到prisma migrate dev生成可版本化的遷移文件。最佳實(shí)踐模板背后的工程底線模板在結(jié)尾固化了一批最佳實(shí)踐逐條展開如下分層架構(gòu)routes → controllers → services嚴(yán)格的三層依賴方向路由不寫業(yè)務(wù)、控制器不寫 SQL、服務(wù)層負(fù)責(zé)數(shù)據(jù)訪問對(duì)應(yīng)目錄結(jié)構(gòu)中的routes/、controllers/、services/三個(gè)目錄。這與 scaffolding.md 強(qiáng)調(diào)的薄路由、邏輯下沉原則一致使用 Zod 校驗(yàn)所有輸入所有請(qǐng)求體、查詢參數(shù)、路徑參數(shù)都應(yīng)經(jīng)過middleware/validate.ts校驗(yàn)schema 統(tǒng)一存放在schemas/既能運(yùn)行時(shí)攔截非法輸入又能通過z.infertypeof schema推導(dǎo)出靜態(tài)類型集中式錯(cuò)誤處理絕不散落 try/catch統(tǒng)一交給middleware/error.ts收口配合統(tǒng)一的{ error, details }響應(yīng)契約避免錯(cuò)誤格式漂移基于環(huán)境的配置連接串、JWT 密鑰、端口等敏感與可變值全部來自環(huán)境變量集中在config/讀取并導(dǎo)出類型化配置對(duì)象配合.env.example提交模板、.env本地注入的慣例使用 Prisma 實(shí)現(xiàn)類型安全的數(shù)據(jù)庫訪問以prisma/schema.prisma為唯一模型源生成的 Prisma Client 在編譯期約束查詢字段與返回類型從根源上減少手寫 SQL 的拼寫錯(cuò)誤與類型失配。在 App Builder 編排流程中的落地方式了解模板本身之后還應(yīng)理解它在 Agent 工作流中的觸發(fā)與執(zhí)行方式。根據(jù) SKILL.md 的選擇性閱讀規(guī)則當(dāng)收到類似創(chuàng)建一個(gè)帶用戶認(rèn)證的 REST API請(qǐng)求時(shí)編排流程如下project-detection.md 對(duì)請(qǐng)求做關(guān)鍵詞分詞命中api/backend/service/rest后判定項(xiàng)目類型為 API Service指向express-api模板只讀取 templates/express-api/TEMPLATE.md 這一個(gè)模板文件按其技術(shù)棧與目錄結(jié)構(gòu)落地按 agent-coordination.md 的流水線由 Database Architect 設(shè)計(jì) Prisma schema → Backend Specialist 實(shí)現(xiàn) routes/controllers/services/middleware → 進(jìn)入并行階段由 Security Auditor 與 Test Engineer 審查與補(bǔ)測(cè) → 最后由 DevOps Engineer 配置環(huán)境與部署。這套模板的價(jià)值在于把Express API 工程長(zhǎng)什么樣的隱性經(jīng)驗(yàn)顯性化為可復(fù)用的模板文件讓 Agent 與開發(fā)者共享同一套結(jié)構(gòu)、契約與規(guī)范減少每次從零搭建時(shí)的決策成本與風(fēng)格漂移。小結(jié)express-api 模板是 AAS app-builder 技能面向純后端 REST API場(chǎng)景的標(biāo)準(zhǔn)化答案以 Node.js 20 為運(yùn)行時(shí)、TypeScript 貫穿全鏈路Express 承載 HTTP 層Prisma 提供 PostgreSQL 的類型安全訪問Zod 把關(guān)所有輸入JWT bcrypt 完成認(rèn)證與密碼安全六步初始化流程可在數(shù)分鐘內(nèi)拉起可運(yùn)行服務(wù)統(tǒng)一響應(yīng)契約與六段式中間件棧則保障了工程的一致性與可維護(hù)性。對(duì)希望讓 Agent 穩(wěn)定產(chǎn)出高質(zhì)量 API 工程的團(tuán)隊(duì)而言這套模板既是腳手架也是一份可直接引用的架構(gòu)規(guī)范。【免費(fèi)下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考