Black-Tortoise Agent Architecture & Quality Skill

使用時機

• 進行架構/設計審視或重構時，需確認層次與品質守則。
• PR 前的結構 sanity check，聚焦高風險違規（跨層依賴、肥介面、重複抽象、RxJS 狀態）。

作業步驟（最小化）

1. 定位規範：依 docs/INDEX.md 讀取對應 AGENTS.md / README.md，鎖定層次邊界與禁止事項。
2. 拆解/排序：sequentialthinking/* 單次列出審查項目與優先序。
3. 查證：
   • API/框架：context7/*（resolve → get docs 一輪）。
   • CLI/schema：angular-cli/*。
4. 品質掃描：必要時 codacy/* 取嚴重/高優先議題。
5. 判斷原則：
   • 高內聚低耦合；單一職責；介面最小暴露。
   • 奧卡姆剃刀：刪除多餘抽象/層級；避免過度設定。
   • Signals-first；禁 RxJS 狀態；禁止 as any。
   • 層次單向：Presentation → Application → Domain → Infrastructure。
6. 產出：
   • 假設/風險 → 問題清單（含檔案鏈結）→ 最小修正步驟 → 驗證建議（lint / architecture:gate / tests）。

MCP 防迴圈

• 同議題對同一 MCP 只呼叫一次；無新資訊即停。
• context7：resolve-library-id → get-library-docs 一次完成。
• Software-planning-mcp：僅在需要計畫更新時使用 start_planning / save_plan 一次。
• sequentialthinking：初次拆解/排序用，不在同一步重入。
• 不巢狀或遞迴 agent/runSubagent。

禁止事項

• 跨能力深層 import、逆向依賴、肥介面、重複抽象。
• 引入 RxJS 狀態管理或 as any。
• 以「大改」取代最小修正；不可破壞可刪除性。

範例輸入

• 「審查 overview capability 最近改動，列出高耦合點與最小修正」
• 「重構 tasks store，確保 Signals-first 並降低介面暴露」