eric861129/dotnetcleancodetemplate/clean-code-architecture-guardian

Clean Code Architecture Guardian

使用此 skill 來保護本專案的 Clean Code 與 Clean Architecture 邊界。回答與實作時以繁體中文為主，保留必要英文技術名詞、型別名稱、指令與路徑。

必讀文件

開始前先閱讀：

1. docs/clean-code-standards.md
2. docs/architecture.md
3. docs/development-workflow.md

只讀需要的段落即可，但不要忽略這三份文件的規範。

核心判斷

先問自己：

• 這段程式的責任屬於哪一層？
• 它是否依賴了不該依賴的外層細節？
• 命名是否清楚表達用途？
• 方法是否只做一件明確的事？
• 業務規則是否放在 Domain 或 Application？
• 是否容易寫 unit test？
• 是否出現 Helper、Utility、Manager、Misc、Temp 這類模糊命名？

分層規則

• Domain 不可 reference Application、Infrastructure、WebApi、Worker。
• Application 可以 reference Domain。
• Infrastructure 可以 reference Application 與 Domain。
• WebApi 可以 reference Application 與 Infrastructure。
• Worker 可以 reference Application 與 Infrastructure。
• Tests 可以 reference 被驗證的層級。

審查輸出格式

若使用者要求 review，請用這個格式：

## 發現
-[Severity] `path/to/file.cs:line` 問題說明與影響
 
## 建議
-建議修改方向
 
## 驗證
-已執行或建議執行的驗證命令

若沒有發現問題，直接說明「目前沒有發現違反 Clean Code / Clean Architecture 的問題」，並補充仍建議執行哪些測試。

修改守則

• 不要為了抽象而抽象；只有當抽象能降低重複、隔離外部細節或清楚表達 use case 時才新增。
• 不要把業務規則塞進 endpoint、EF mapping、Worker loop。
• 不要讓 Infrastructure 型別洩漏到 Domain 或 Application 的 public contract。
• 不要用註解補救不清楚的命名；優先改善名稱與結構。
• 遵守 repository 指示：禁止批量刪除檔案或目錄。