Elf Express 撰寫 / 修改 MCP server(TypeScript + @modelcontextprotocol/sdk)的團隊規範與完整範本:專案結構、工具命名與描述、 zod 輸入 schema、唯讀 annotations、錯誤以文字結果回傳、輸出截斷、stdio 與 Streamable HTTP 雙 transport、Bearer token、 /health、stderr 日誌、測試、Dockerfile,以及「禁止簡化」清單。當任務涉及新建 MCP server、修改…
Elf Express 領域建模規範(C# + SqlSugar 實體)。當任務涉及設計或修改 Entity、Value Object、聚合(Aggregate)、 主鍵型別、審計欄位(CreatedAt / CreatedBy / UpdatedAt / UpdatedBy)、多租戶邊界(ICompanyEntity / CompanyId)、 軟刪除(ISoftDelete / IsDeleted)、enum 與狀態轉換、工廠方法、領域事件、Repository / UnitOfWork 取捨時觸發。
Elf Express ASP.NET Core 10 後端規範(minimal API + SqlSugar + PostgreSQL)。 當任務涉及建立或修改 server/ 下的 .NET 方案、專案結構(.slnx、.csproj、Directory.*.props)、Program.cs、 minimal API endpoint、服務層、依賴注入生命週期(Singleton/Scoped/Transient)、appsettings 與環境變數、 連線字串、例外處理、ILogger…
Elf Express SqlSugar 5.x ORM 使用規範(PostgreSQL 18,DbType.PostgreSQL)。 當代碼涉及 SqlSugarScope 註冊、ConnectionConfig、db.Queryable / Insertable / Updateable / Deleteable、 CodeFirst / InitTables / DbMaintenance、SugarTable / SugarColumn / SugarIndex、snake_case 命名轉換、…
Elf Express 技術堆疊版本的唯一真實來源(single source of truth),規定每個工具的版本與在 repo 中的釘選方式。 當任務涉及建立新專案、新增或升級套件 / SDK / runtime、撰寫 global.json、.nvmrc、package.json 的 engines 或 packageManager、Directory.Packages.props、docker image tag、CI 的 setup-* 版本,或需要回答「團隊用哪一版」時觸發。
Elf Express 以 Allure Report v3 作為跨框架的測試報告 UI:Playwright、Vitest、xUnit 的結果統一寫入 repo 根目錄 `allure-results/`,再以 `allure` CLI(npm 套件,pnpm 安裝)產出 HTML 報告。 當任務涉及設置測試報告、讓測試框架輸出 Allure 結果、撰寫 `allurerc.*`、CI 產出 / 上傳報告、 quality gate、watch 即時報告、多框架或 rerun 結果合併時觸發。
Elf Express E2E 端對端測試規範(Playwright + 已安裝的 Chrome):團隊定本 `playwright.config.ts`、 `e2e/` 目錄結構、selector 優先順序、頁面物件模式(POM)、錄影 / 截圖 / trace、retries 與 workers、CI job。 預設以 mock 模式(`VITE_USE_MOCK` 預設開)跑、不需要後端與登入;登入 / 真後端為 opt-in 變體。 當任務涉及 Playwright 設定、撰寫或重構…
Elf Express 後端整合測試規範:以 `WebApplicationFactory<Program>` 啟動真 ASP.NET Core 管線, 透過 Testcontainers 跑真 PostgreSQL 18,SqlSugar 建表 / 清資料,HttpClient 打 API,TestAuthHandler 模擬登入。 當任務涉及 API endpoint 測試、SqlSugar 查詢 / 交易 / 多租戶過濾的測試、測試資料庫建立與清除、 認證授權測試、替換外部 HTTP 服務、或新增…