Black-Tortoise Agent Architecture & Quality Skill
使用時機
- 進行架構/設計審視或重構時，需確認層次與品質守則。
- PR 前的結構 sanity check，聚焦高風險違規（跨層依賴、肥介面、重複抽象、RxJS 狀態）。
作業步驟（最小化）
- 定位規範：依
docs/INDEX.md讀取對應AGENTS.md/README.md，鎖定層次邊界與禁止事項。 - 拆解/排序：
sequentialthinking/*單次列出審查項目與優先序。 - 查證：
- API/框架：context7/*（resolve → get docs 一輪）。 - CLI/schema：angular-cli/*。
- 品質掃描：必要時
codacy/*取嚴重/高優先議題。 - 判斷原則：
- 高內聚低耦合；單一職責；介面最小暴露。 - 奧卡姆剃刀：刪除多餘抽象/層級；避免過度設定。 - Signals-first；禁 RxJS 狀態；禁止 as any。 - 層次單向：Presentation → Application → Domain → Infrastructure。
- 產出：
- 假設/風險 → 問題清單（含檔案鏈結）→ 最小修正步驟 → 驗證建議（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 並降低介面暴露」