diff --git a/.agents/skills/01-awoooi-frontend-aesthetics.md b/.agents/skills/01-awoooi-frontend-aesthetics.md index a4b90d08..8b2fe491 100644 --- a/.agents/skills/01-awoooi-frontend-aesthetics.md +++ b/.agents/skills/01-awoooi-frontend-aesthetics.md @@ -47,6 +47,27 @@ useState() // 管理 SSE 串流狀態 - 無數據時顯示 `"--"` 或空狀態組件 - 禁止使用假數據填充 UI +### 5. ADR-013 代碼註解規範 + +**強制 JSDoc 場景**: +```typescript +/** + * 簽核待審批請求 + * @param id - Approval UUID + * @param signerId - 簽核者 ID (需有對應 Tier 權限) + * @returns 簽核結果,包含是否觸發執行 + * @throws {UnauthorizedError} 簽核者權限不足 + */ +async function signApproval(id: string, signerId: string): Promise +``` + +**強制 data-testid**: +```tsx +// 命名: -[-] +