Agent skill · software engineering · affaan-m
project-guidelines-example
Project-specific skill template covering architecture, patterns, testing, and deployment guidance.
Why this skill is useful
Provides specific architectural patterns, testing requirements, and deployment workflows tailored for a unique tech stack that the AI wouldn't reliably generate on its own.
What it needs
Requires fastapi, google-cloud-run, next.js, playwright, pytest, supabase installed locally. About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
專案指南技能（範例） 這是專案特定技能的範例。使用此作為你自己專案的範本。 基於真實生產應用程式：Zenith - AI 驅動的客戶探索平台。 --- 何時使用 在處理專案特定設計時參考此技能。專案技能包含： 架構概覽 檔案結構 程式碼模式 測試要求 部署工作流程 --- 架構概覽 技術堆疊： 前端：Next.js 15（App Router）、TypeScript、React 後端：FastAPI（Python）、Pydantic 模型 資料庫：Supabase（PostgreSQL） AI：Claude API 帶工具呼叫和結構化輸出 部署：Google Cloud Run 測試：Playwright（E2E）、pytest（後端）、React Testing Library 服務： --- 檔案結構 --- 程式碼模式 API 回應格式（FastAPI） 前端 API 呼叫（TypeScript） Claude AI 整合（結構化輸出） 自訂 Hooks（React） --- 測試要求 後端（pytest） 測試結構： 前端（React Testing Library） 測試結構： --- 部署工作流程 部署前檢查清單 [ ] 本機所有測試通過 [ ] npm run build 成功（前端） [ ] poetry run pytest 通過（後端） [ ] 無寫死密鑰 [ ] 環境變數已記錄 [ ] 資料庫 migrations 準備就緒 部署指令 環境變數 --- 關鍵規則 1. 無表情符號 在程式碼、註解或文件中 2. 不可變性 - 永遠不要突變物件或陣列 3. TDD - 實作前先寫測試 4. 80% 覆蓋率 最低 5. 多個小檔案 - 200-400 行典型，最多 800 行 6. 無 console.log 在生產程式碼中 7. 適當錯誤處理 使用 try/catch 8. 輸入驗證 使用 Pydantic/Zod --- 相關技能 coding-standards.md - 一般程式碼最佳實務 backend-patterns.md - API 和資料庫模式 frontend-patterns.md - React 和 Next.js 模式 tdd-workflow/ - 測試驅動開發方法論
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/project-guidelines-example--c3df4b