trpc-scaffolder
建立類型安全的 tRPC 端點
手動建立 tRPC 路由器和 Zod 架構每個端點需要 20-30 分鐘，且存在類型錯誤和缺少匯出的風險。此技能可透過驗證架構、範例模式和自動註冊檢查來建構完整的類型安全端點。
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"trpc-scaffolder" 사용 중입니다. Create a new tRPC router for analytics with a getDashboardStats query procedure
예상 결과:
- Created router file: frontend/src/lib/trpc/routers/analytics.ts
- Procedure snippet generated for getDashboardStats
- Remember to register analyticsRouter in _app.ts
- Next: Create schemas in lib/trpc/schemas/analytics.schema.ts
"trpc-scaffolder" 사용 중입니다. Add a mutation procedure to create new posts in the blogRouter
예상 결과:
- Procedure template generated for createPost mutation
- Add to blogRouter inside the router({ ... }) object
- Create input/output schemas: createPostInputSchema, createPostOutputSchema
- Run validation to verify registration
보안 감사
낮은 위험This skill scaffolds tRPC routers and schemas using bash scripts with standard Unix utilities. All file operations are constrained to predefined project paths. Documentation backticks flagged as command execution are false positives. The '../..' patterns in scripts are controlled project-root navigation. No network calls or credential access. Safe for marketplace publication.
낮은 위험 문제 (1)
위험 요인
⚡ 스크립트 포함 (4)
📁 파일 시스템 액세스 (3)
품질 점수
만들 수 있는 것
新增 API 端點
為 Next.js 應用程式快速建立遵循專案慣例的類型安全 tRPC 端點
產生驗證架構
為輸入和輸出驗證建立具有正確類型推論的 Zod 架構
強制執行程式碼標準
透過自動驗證檢查確保所有新端點遵循一致的模式
이 프롬프트를 사용해 보세요
為使用者管理建立新的 tRPC 路由器。使用 trpc-scaffolder 技能產生路由器檔案和 Zod 架構。
在現有的 userRouter 中新增名為 getUserProfile 的查詢程序。從 trpc-scaffolder 使用 add-procedure.sh 指令碼。
為通知實體建立 Zod 架構。使用 create-schema.sh 產生具有輸入和輸出架構的架構檔案。
執行 tRPC 驗證指令碼以檢查所有路由器是否在 _app.ts 中正確註冊，以及架構是否正確匯出類型。
모범 사례
- 在建立新端點後務必執行 validate-trpc.sh 以確保正確註冊
- 使用 z.infer<typeof schemaName> 匯出推論的類型以獲得完整的 TypeScript 類型安全
- 對 GET 操作使用查詢程序，對資料修改使用變異程序
피하기
- 跳過路由器在 _app.ts 中的註冊 - 導致執行時的類型錯誤
- 忘記匯出推論的類型 - 破壞 TypeScript 類型推論
- 對讀取操作使用變異 - 違反 REST 慣例和快取行為