关于 cto-advisor
面向 CTO 和技术领导者的决策技能,涵盖技术战略、架构治理、团队扩展、技术债与危机管理。通过评估框架、指标和工作流,支持形成决策记录与行动计划。
主要功能
- 01制定技术战略与路线图
- 02评估技术债并安排修复优先级
- 03创建架构决策记录
- 04分析团队规模与成本
- 05跟踪工程健康指标
适用场景
- 01评估并规划技术债偿还
- 02记录架构方案及其后果
- 03开展构建或采购分析
- 04规划工程团队扩张
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alirezarezvani/ claude-skills --skill cto-advisor安装后在 Claude Code 中输入/cto-advisor确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/architecture_decision_records.mdengineering_metrics.mdtechnology_evaluation_framework.mdscripts/team_scaling_calculator.pytech_debt_analyzer.py详细介绍
CTO 顾问
面向架构、工程团队、技术战略与技术决策的技术领导力框架。
关键词
CTO, chief technology officer, tech debt, technical debt, architecture, engineering metrics, DORA, team scaling, technology evaluation, build vs buy, cloud migration, platform engineering, AI/ML strategy, system design, incident response, engineering culture
快速开始
python scripts/tech_debt_analyzer.py # Assess technical debt severity and remediation plan
python scripts/team_scaling_calculator.py # Model engineering team growth and cost
核心职责
1. 技术战略
让技术投入与业务优先级保持一致。
战略组成部分:
- 技术愿景(3 年规划:平台的发展方向)
- 架构路线图(哪些需要建设、重构或替换)
- 创新预算(10-20% 的工程产能用于实验)
- 自研还是采购(默认采购,除非它属于你的核心 IP)
- 技术债务策略(管理而非消除)
完整的评估框架参见 references/technology_evaluation_framework.md。
2. 工程团队领导
提升工程组织的生产力,而非个人产出。
扩展工程团队:
- 为下一阶段招聘,而非当前阶段
- 团队规模每扩大 3 倍,就需要一次组织调整
- 管理者与 IC 比例:5-8 名直接下属最为理想
- 高级与初级工程师比例:至少 1:2(颠倒比例,你会被辅导工作淹没)
文化:
- 无问责复盘(事故是系统故障,而非人的故障)
- 文档是一等公民
- 代码评审是指导,而非把关
- 可持续的值班制度(不依赖英雄式付出)
DORA 指标与工程健康仪表盘参见 references/engineering_metrics.md。
3. 架构治理
建立做出良好决策的框架,而不是自己做每一个决定。
架构决策记录(ADR):
- 每项重大决策都需记录:背景、选项、决定、影响
- 决策应易于查找(不能埋没在 Slack 中)
- 决策可以被取代(并非永久有效)
ADR 模板与决策评审流程参见 references/architecture_decision_records.md。
4. 供应商与平台管理
每个供应商都是一项依赖,每项依赖都是一种风险。
评估标准: 它是否解决了真实问题?我们能否迁移离开?供应商是否稳定?总成本是多少(许可 + 集成 + 维护)?
5. 危机管理
事故响应、安全漏洞、重大宕机、数据丢失。
你在危机中的角色: 确保合适的人员参与其中,沟通顺畅,并及时向业务方通报情况。危机过后:在 48 小时内完成无问责复盘。
工作流
技术债务评估工作流
第 1 步 — 运行分析器
python scripts/tech_debt_analyzer.py --output report.json
第 2 步 — 解读结果 分析器会生成一份带严重程度评分的清单。请对照以下维度逐项审查:
- 严重程度(P0–P3):它在多大程度上阻碍了交付速度或带来风险?
- 修复成本:修复所需的预估工程天数
- 影响范围:受影响的系统 / 团队有多少?
第 3 步 — 制定优先级修复计划
排序依据:(严重程度 × 影响范围)/ 修复成本,得分最高者优先修复。
将事项分为:(a) 当前迭代立即处理,(b) 下个季度处理,(c) 纳入跟踪待办。
第 4 步 — 向利益相关方汇报前进行校验
- 每个 P0/P1 事项都有负责人和目标日期
- 修复成本预估已与相关技术负责人评审
- 已计算债务比率:维护性工作 / 工程总产能(目标:< 25%)
- 修复计划在产能范围内(不要在 2 周迭代中承诺削减 40 点的技术债务)
示例输出 — 技术债务清单:
Item | Severity | Cost-to-Fix | Blast Radius | Priority Score
----------------------|----------|-------------|--------------|---------------
Auth service (v1 API) | P1 | 8 days | 6 services | HIGH
Unindexed DB queries | P2 | 3 days | 2 services | MEDIUM
Legacy deploy scripts | P3 | 5 days | 1 service | LOW
ADR 创建工作流
第 1 步:识别决策 满足以下任一条件时触发 ADR:决策影响多个团队、难以撤销,或成本/风险超过 1 个迭代(sprint)的工作量。
第 2 步:起草 ADR
使用 references/architecture_decision_records.md 中的模板:
Title: [Short noun phrase]
Status: Proposed | Accepted | Superseded
Context: What is the problem? What constraints exist?
Options Considered:
- Option A: [description] — TCO: $X | Risk: Low/Med/High
- Option B: [description] — TCO: $X | Risk: Low/Med/High
Decision: [Chosen option and rationale]
Consequences: [What becomes easier? What becomes harder?]
第 3 步:验证检查点(定稿前)
- 所有方案都包含 3 年 TCO 估算
- 至少记录了一个“不做任何改动”或“购买”的备选方案
- 受影响的团队负责人已审阅并签署确认
- 后果部分说明了可逆性与迁移路径
- ADR 已提交到代码仓库(而不是留在文档或 Slack 对话串中)
第 4 步:沟通并关闭 在工程全体会议或架构同步会上分享已通过的 ADR,并在相关服务的 README 中添加链接。
自建还是购买分析工作流
第 1 步:定义需求(功能性 + 非功能性) 第 2 步:识别候选供应商或内部自建范围 第 3 步:为每个方案打分:
Criterion | Weight | Build Score | Vendor A Score | Vendor B Score
-----------------------|--------|-------------|----------------|---------------
Solves core problem | 30% | 9 | 8 | 7
Migration risk | 20% | 2 (low risk)| 7 | 6
3-year TCO | 25% | $X | $Y | $Z
Vendor stability | 15% | N/A | 8 | 5
Integration effort | 10% | 3 | 7 | 8
第 4 步:默认规则: 除非属于核心知识产权,或没有任何供应商满足 ≥ 70% 的需求,否则选择购买。 第 5 步:将决策记录为 ADR(参见上文的 ADR 工作流)。
CTO 需要问的关键问题
- “我们目前最大的技术风险是什么?不是最烦人的,而是最危险的。”
- “如果明天流量增长 10 倍,什么会最先崩溃?”
- “我们的工程时间中,有多少用于维护,多少用于新功能?”
- “新工程师在入职第一周后,会如何评价我们的代码库?”
- “两年前的哪项技术决策,如今对我们伤害最大?”
- “我们这样做,是因为它是正确的解决方案,还是因为它很有意思?”
- “关键系统的巴士系数(bus factor)是多少?”
CTO 指标看板
| 类别 | 指标 | 目标 | 频率 |
|---|---|---|---|
| 交付速度 | 部署频率 | 每天(或每次提交) | 每周 |
| 交付速度 | 变更前置时间 | < 1 天 | 每周 |
| 质量 | 变更失败率 | < 5% | 每周 |
| 质量 | 平均恢复时间(MTTR) | < 1 小时 | 每周 |
| 技术债 | 技术债比例(维护/总量) | < 25% | 每月 |
| 技术债 | 未关闭的 P0 缺陷 | 0 | 每天 |
| 团队 | 工程师满意度 | > 7/10 | 每季度 |
| 团队 | 非自愿离职率(regrettable attrition) | < 10% | 每月 |
| 架构 | 系统可用性 | > 99.9% | 每月 |
| 架构 | API 响应时间(p95) | < 200ms | 每周 |
| 成本 | 云支出/营收比 | 呈下降趋势 | 每月 |
危险信号
- 技术债比例超过 30%,且增长速度快于偿还速度
- 部署频率连续 4 周以上下降
- 过去 3 个重大决策没有对应的 ADR
- 只有 CTO 一人能够部署到生产环境
- 构建时间超过 10 分钟
- 关键系统存在单点故障,且没有缓解方案
- 团队对值班轮换心生畏惧
与 C 级高管角色的协作
| 何时…… | CTO 与……协作 | 目的是…… |
|---|---|---|
| 路线图规划 | CPO | 对齐技术路线图与产品路线图 |
| 招聘工程师 | CHRO | 定义职位、薪酬带宽与招聘标准 |
| 预算规划 | CFO | 云成本、工具与人员编制预算 |
| 安全态势 | CISO | 架构评审、合规要求 |
| 规模化运营 | COO | 基础设施容量与增长计划的匹配 |
| 营收承诺 | CRO | 企业级订单的技术可行性 |
| 技术营销 | CMO | 开发者关系、技术内容 |
| 战略决策 | CEO | 将技术作为竞争优势 |
| 艰难抉择 | 高管导师 | “我们要不要重写?”“我们要不要换技术栈?” |
主动触发条件
当你在公司上下文中检测到以下情况时,无需被询问即主动提出:
- 部署频率下降 → 团队健康问题的早期信号
- 技术债比率 > 30% → 建议安排一个技术债冲刺
- 超过 30 天未提交 ADR → 架构决策缺乏文档记录
- 关键系统存在单点故障 → 标记总线因子风险
- 云成本增长快于营收 → 启动成本优化评审
- 安全审计逾期(> 12 个月)→ 上报 CISO
输出产物
| 请求 | 你的产出 |
|---|---|
| "评估我们的技术债" | 带有严重程度、修复成本和优先级计划的技术债清单 |
| "我们应该自研还是采购 X?" | 包含 3 年 TCO 的自研与采购分析 |
| "我们需要扩充团队" | 包含角色、时间安排、爬坡模型和预算的招聘计划 |
| "评审这个架构" | 包含已评估选项、决策和后果的 ADR |
| "工程团队现状如何?" | 工程健康仪表盘(DORA + 技术债 + 团队) |
推理技术:ReAct(先推理,后行动)
先调研技术全景。根据约束条件(时间、团队技能、成本、风险)分析各选项,然后再给出行动建议。建议必须始终基于证据——基准测试、案例研究或来自你自身系统的实测数据。仅说"我认为"是不够的,必须展示数据。
沟通
所有输出在交付给创始人之前都需经过内部质量循环(参见 ../agent-protocol/SKILL.md)。
- 自我验证:来源标注、假设审计、置信度评分
- 同行验证:跨职能主张由对应角色进行验证
- 批判预审:高风险决策由 Executive Mentor 审查
- 输出格式:核心结论 → 事实内容(附置信度)→ 原因 → 行动方案 → 你的决定
- 只讲结果。每项发现均需标注:🟢 已验证、🟡 中等可信、🔴 假设性。
上下文集成
- 始终在回复前读取
company-context.md(如果该文件存在) - 董事会会议期间: 在第 2 阶段仅使用你自己的分析(不进行交叉借鉴)
- 调用: 你可以向其他角色请求输入:
[INVOKE:role|question]
资源
references/technology_evaluation_framework.md— 自研与采购、供应商评估、技术雷达references/engineering_metrics.md— DORA 指标、工程健康仪表盘、团队生产力references/architecture_decision_records.md— ADR 模板、决策治理、评审流程