mcpField
C
cto-advisor

cto-advisor

github.com/alirezarezvani开发28.9k900 次安装2 天前更新
代码仓库

关于 cto-advisor

面向 CTO 和技术领导者的决策技能,涵盖技术战略、架构治理、团队扩展、技术债与危机管理。通过评估框架、指标和工作流,支持形成决策记录与行动计划。

主要功能

  1. 01制定技术战略与路线图
  2. 02评估技术债并安排修复优先级
  3. 03创建架构决策记录
  4. 04分析团队规模与成本
  5. 05跟踪工程健康指标

适用场景

  1. 01评估并规划技术债偿还
  2. 02记录架构方案及其后果
  3. 03开展构建或采购分析
  4. 04规划工程团队扩张

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill cto-advisor

安装后在 Claude Code 中输入/cto-advisor确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
architecture_decision_records.md
engineering_metrics.md
technology_evaluation_framework.md
scripts/
team_scaling_calculator.py
tech_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 模板、决策治理、评审流程

评论

支持 Markdown