cto-advisor

cto-advisor skill 概覽

cto-advisor 適合用來做什麼

cto-advisor 是一項面向技術領導的 skill，能把混亂、零散的工程問題整理成具備 CTO 視角的結構化建議。它最適合用在架構決策、技術債優先順序、工程指標、技術評估、團隊擴編，以及策略規劃等情境；也就是當你需要的不只是程式碼層級建議，而是包含取捨、執行順序與能向高階主管說明的推理時，cto-advisor 會特別有價值。

最適合的使用者與決策情境

cto-advisor skill 適合創辦人、CTO、VP of Engineering、staff engineer、平台負責人，以及具產品思維的技術主管，用來判斷該修什麼、打造什麼、買什麼、衡量什麼，或重整什麼。當你手上只有部分脈絡時，它尤其實用：例如擴展瓶頸、尚未釐清的架構選擇、一串技術債 backlog，或像「建立 12 個月技術 roadmap」這類來自管理層的要求。

它和一般 prompt 有什麼不同

一般 prompt 可能會產出很寬泛的建議。這個 skill 加入可重複使用的 CTO 框架：ADR 風格的決策紀錄、DORA 與生產力指標、技術評估矩陣、技術債分類，以及團隊擴編計算。它的實務價值不只是「給建議」；更在於協助你把工程上的模糊地帶轉換成有排序的選項、可衡量的風險，以及下一步行動。

cto-advisor 最擅長的場景

當問題同時牽涉技術、人員、成本、可靠性與交付速度時，可以使用 cto-advisor 進行 Strategic Planning。若你能提供系統脈絡、現有限制、商業目標與失敗徵兆，它的表現會最好。相對來說，它不適合高度專門的實作除錯、深入的特定供應商調校，或需要權威審查的法律／合規決策。

如何使用 cto-advisor skill

cto-advisor 安裝方式與優先閱讀的檔案

使用以下指令安裝 skill：

npx skills add alirezarezvani/claude-skills --skill cto-advisor

安裝後，先從 SKILL.md 開始，了解啟用範圍與技術領導工作流程。接著依你的任務閱讀以下檔案：

• references/architecture_decision_records.md：用於架構選擇與 ADR 輸出格式
• references/engineering_metrics.md：用於 DORA、品質、生產力與可靠性指標
• references/technology_evaluation_framework.md：用於 build-vs-buy 或供應商選型
• scripts/tech_debt_analyzer.py：用於技術債評分邏輯
• scripts/team_scaling_calculator.py：用於工程人力與組織結構規劃

這個 repository 不依賴大型 runtime，但輔助腳本是 Python 檔案；如果你想在本機執行，請確認環境中有 Python 3。

讓 cto-advisor 發揮更好效果的輸入

當 prompt 包含商業目標、目前工程狀態、限制條件、正在考慮的選項，以及決策期限時，這個 skill 的效果最好。不要只問「我們的架構應該是什麼？」而不提供脈絡。請改成提供決策驅動因素。

更好的 prompt 模式：

Use cto-advisor to evaluate whether our SaaS platform should move from a modular monolith to services. Current team: 18 engineers, 2 platform engineers, weekly deploys, 99.5% uptime target, PostgreSQL bottlenecks, customer growth from 200 to 1,000 accounts in 12 months. Constraints: 6-month roadmap, limited DevOps capacity, compliance audit in Q3. Produce an ADR-style recommendation with options, risks, migration phases, and metrics to track.

這樣能給 skill 足夠資訊來推理取捨，而不是直接落入流行架構建議。

決策時的實務工作流程

大多數技術領導決策可以採用四步驟流程：

1. 界定決策：定義問題、商業成果、時間範圍，以及不可妥協的限制。
2. 要求結構化分析：依決策類型要求 ADR、技術評估矩陣、技術債修復計畫、團隊擴編模型，或指標儀表板。
3. 驗證假設：檢查輸出是否依賴尚未驗證的事實，例如 incident 頻率、部署資料、團隊技能，或成本估算。
4. 轉成行動：要求 30/60/90 天計畫、負責人、里程碑、風險與可衡量的成功標準。

若是技術債相關工作，請執行或檢視 scripts/tech_debt_analyzer.py，了解它如何在架構、程式碼品質、基礎設施、安全性與效能之間設定債務分類權重。若是團隊成長規劃，在接受建議的角色比例之前，先閱讀 scripts/team_scaling_calculator.py。

依任務類型設計 prompt 範例

技術債：
Use cto-advisor to prioritize technical debt across architecture, infrastructure, security, and performance. Our main pain points are manual deployments, low test coverage, slow queries, and outdated dependencies. Create a severity-ranked remediation plan with business impact, effort, dependencies, and first 3 actions.

技術評估：
Use cto-advisor to compare Kafka, RabbitMQ, and managed cloud queues for event-driven order processing. Include functional requirements, non-functional requirements, TCO, operational burden, team expertise, exit risk, and a scoring matrix.

工程指標：
Use cto-advisor to design an engineering metrics dashboard for a 35-person product engineering org. Include DORA metrics, quality indicators, reliability metrics, measurement method, target ranges, and behaviors to avoid incentivizing.

cto-advisor skill 常見問題

cto-advisor 適合初學者嗎？

可以，只要使用者需要的是決策框架，而不是一份完成版的高階策略。初學者應該要求定義、範例與逐步推理。不過，這些建議仍需要由理解系統、組織與商業限制的人來審查。

什麼時候不該使用 cto-advisor？

不要把 cto-advisor 當成安全簽核、法律合規、財務預測，或正式生產架構核准的最終依據。它可以協助整理分析、揭露取捨，並草擬決策紀錄；但真正的決策仍應透過系統資料、利害關係人意見與專家審查來驗證。

cto-advisor 和架構 skill 有什麼不同？

只聚焦架構的 skill 通常著重在系統設計。cto-advisor skill 則把架構視為更大範圍技術領導決策的一部分：roadmap 對齊、團隊產能、技術債、交付指標、招募影響、成本、風險與治理。因此，它更適合跨職能規劃，而不是單點式的設計圖產出。

小團隊和新創公司適合用嗎？

適合。小團隊可以用它來避免過度工程化、比較 build-vs-buy 選項、規劃招募，以及判斷哪些技術債可以暫時接受。關鍵是要清楚說明新創限制：runway、團隊規模、客戶急迫性、營運容忍度，以及哪些事情必須保持簡單。

如何改進 cto-advisor skill 的使用效果

用更精準的脈絡改善 cto-advisor 輸出

提升 cto-advisor 結果最快的方法，是用可直接支援決策的脈絡取代模糊目標。請包含目前團隊規模、架構、部署節奏、incident 歷史、成本限制、客戶成長、合規需求與已知限制。如果你缺乏指標，請直接說明，並要求 skill 在決策前指出需要先蒐集哪些資料。

需要留意的常見失敗模式

主要風險是收到對你團隊產能而言過於理想化的建議。請特別留意那些假設你已具備更成熟的平台能力、自動化程度、人力配置或預算的計畫。若輸出建議導入 microservices、沉重治理，或大範圍指標計畫，卻沒有明確連結到商業問題，也應該提出質疑。

從策略逐步迭代到執行

拿到第一版輸出後，提出能迫使優先排序的追問：

• What assumptions would change this recommendation?
• What is the smallest reversible next step?
• Which option is best if we optimize for 6-month delivery speed?
• Which risks need executive approval?
• Turn this into an ADR with negative consequences included.

這會把 cto-advisor 的使用方式，從一次性的建議產出，轉成完整的決策工作流程。

用 repository 框架與腳本驗證結果

採納答案之前，請把內附 references 當成檢查清單使用。用 references/architecture_decision_records.md 對照架構建議，用 references/engineering_metrics.md 對照指標建議，並用 references/technology_evaluation_framework.md 對照供應商比較。若涉及量化規劃，請檢視或調整 Python 腳本，而不是把生成出來的數字直接視為權威結論。