mcpField
C
cto-advisor

cto-advisor

github.com/borghei开发1.1k175 次安装2 周前更新
代码仓库

关于 cto-advisor

面向 CTO 和技术领导者的技能,提供技术战略、团队扩张、架构治理、供应商评估和工程效能框架。配套脚本可分析技术债并制定团队扩张计划,参考资料涵盖 ADR 和工程指标。

主要功能

  1. 01技术债分析与优先级排序
  2. 02工程团队扩张规划
  3. 03ADR 架构决策记录
  4. 04技术与供应商评估
  5. 05DORA 与团队指标框架

适用场景

  1. 01评估系统技术债并安排改进
  2. 02规划工程团队招聘与结构
  3. 03记录重要架构决策及依据
  4. 04建立工程绩效指标

安装

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

$npx skills add https://github.com/borghei/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 Advisor

面向技术领导力、团队扩张与工程卓越的战略框架和工具。

关键词

CTO、首席技术官、技术领导力、技术债、技术债务、工程团队、团队扩张、架构决策、技术评估、工程指标、DORA 指标、ADR、架构决策记录、技术战略、工程领导力、工程组织、团队结构、招聘计划、技术策略、供应商评估、技术选型

快速开始

用于技术债评估
python scripts/tech_debt_analyzer.py

分析系统架构,并提供按优先级排序的债务削减计划。

用于团队扩张规划
python scripts/team_scaling_calculator.py

计算最优招聘计划和团队结构,以支持增长。

用于架构决策

查看 references/architecture_decision_records.md,获取 ADR 模板和示例。

用于技术评估

使用 references/technology_evaluation_framework.md 中的框架进行供应商选择。

用于工程指标

实施 references/engineering_metrics.md 中的 KPI,用于团队绩效跟踪。

核心职责

1. 技术战略
愿景与路线图
  • 定义 3-5 年技术愿景
  • 制定季度路线图
  • 与业务战略保持一致
  • 向利益相关者沟通
创新管理
  • 分配 20% 时间用于创新
  • 每季度举办黑客松
  • 评估新兴技术
  • 构建概念验证
技术债战略
# Assess current debt
python scripts/tech_debt_analyzer.py

# Allocate capacity
- Critical debt: 40% capacity
- High debt: 25% capacity  
- Medium debt: 15% capacity
- Low debt: Ongoing maintenance
2. 团队领导力
扩张工程团队
# Calculate scaling needs
python scripts/team_scaling_calculator.py

# Key ratios to maintain:
- Manager:Engineer = 1:8
- Senior:Mid:Junior = 3:4:2
- Product:Engineering = 1:10
- QA:Engineering = 1.5:10
绩效管理
  • 每季度设定清晰的 OKR
  • 每周进行 1:1
  • 每季度审查绩效
  • 提供成长机会
文化建设
  • 定义工程价值观
  • 建立编码标准
  • 创建学习项目
  • 促进协作
3. 架构治理
决策制定

使用 references/architecture_decision_records.md 中的 ADR 模板:

  1. 记录背景和问题
  2. 列出考虑过的所有选项
  3. 记录决策和理由
  4. 跟踪后果
技术标准
  • 语言选择
  • 框架选择
  • 数据库标准
  • 安全要求
  • API 设计指南
系统设计评审
  • 每周架构评审
  • 设计文档标准
  • 原型要求
  • 性能标准
4. 供应商管理
评估流程

遵循 references/technology_evaluation_framework.md 中的框架:

  1. 收集需求(第 1 周)
  2. 市场调研(第 1-2 周)
  3. 深入评估(第 2-4 周)
  4. 决策和文档(第 4 周)
供应商关系
  • 季度业务审查
  • SLA 监控
  • 成本优化
  • 战略合作伙伴关系
5. 工程卓越
指标实施

来自 references/engineering_metrics.md:

DORA 指标(部署到生产环境的目标):

  • 部署频率:>1/天
  • 前置时间:<1 天
  • MTTR:<1 小时
  • 变更失败率:<15%

质量指标:

  • 测试覆盖率:>80%
  • 代码审查:100%
  • 技术债:<10%

团队健康度:

  • Sprint 速度:±10% 波动
  • 计划外工作:<20%
  • 值班事件:<5/周

每周节奏

周一
  • 领导团队同步
  • 审查指标仪表盘
  • 处理升级事项
周二
  • 架构评审
  • 技术面试
  • 与直接下属进行 1:1
周三
  • 跨职能会议
  • 供应商会议
  • 战略工作
周四
  • 团队全员会(每月)
  • Sprint 评审(每两周)
  • 技术深度探讨
周五
  • 战略规划
  • 创新时间
  • 每周回顾和规划

季度规划

Q1 重点:基础
  • 年度规划
  • 预算分配
  • 团队目标设定
  • 技术评估
Q2 重点:执行
  • 主要项目启动
  • 年中招聘推进
  • 绩效审查
  • 架构演进
Q3 重点:创新
  • 黑客松
  • 技术探索
  • 团队发展
  • 流程优化
第 4 季度重点:规划
  • 明年战略
  • 预算规划
  • 晋升周期
  • 债务削减冲刺

危机管理

事件响应
  1. 立即(0-15 分钟):

    • 评估严重程度
    • 启动事件团队
    • 开始沟通
  2. 短期(15-60 分钟):

    • 实施修复
    • 向相关方更新情况
    • 监控系统
  3. 解决(1-24 小时):

    • 验证修复效果
    • 记录时间线
    • 与客户沟通
  4. 事后复盘(48-72 小时):

    • 根因分析
    • 行动事项
    • 流程改进
危机类型
安全漏洞
  • 隔离受影响的系统
  • 联系安全团队
  • 通知法律/合规团队
  • 制定客户沟通计划
重大服务中断
  • 全员响应
  • 更新状态页
  • 向高管简报
  • 联系客户
数据丢失
  • 立即停止写入
  • 评估恢复方案
  • 开始恢复
  • 分析影响

利益相关方管理

董事会/高管报告

每月:

  • KPI 仪表板
  • 风险登记表
  • 重大项目状态

每季度:

  • 技术战略更新
  • 团队成长与健康状况
  • 创新亮点
  • 预算审查
跨职能合作伙伴
产品团队
  • 每周同步路线图
  • 参与冲刺规划
  • 评审技术可行性
  • 估算功能工作量
销售/市场营销
  • 提供技术销售支持
  • 介绍产品能力
  • 客户推荐电话
  • 竞争分析
财务
  • 预算管理
  • 成本优化
  • 供应商谈判
  • 资本支出规划

战略举措

数字化转型
  1. 评估当前状态
  2. 定义目标架构
  3. 制定迁移计划
  4. 分阶段执行
  5. 衡量并调整
云迁移
  1. 评估应用
  2. 制定迁移策略(7R)
  3. 试点应用
  4. 全面迁移
  5. 优化
平台工程
  1. 明确平台愿景
  2. 构建核心服务
  3. 创建自助工具
  4. 推动团队采用
  5. 衡量效率
AI/ML 集成
  1. 确定用例
  2. 构建数据基础设施
  3. 开发模型
  4. 部署并监控
  5. 扩大应用

沟通模板

技术战略演示文稿
1. Executive Summary (1 slide)
2. Current State Assessment (2 slides)
3. Vision & Strategy (2 slides)
4. Roadmap & Milestones (3 slides)
5. Investment Required (1 slide)
6. Risks & Mitigation (1 slide)
7. Success Metrics (1 slide)
团队全员会议
1. Wins & Recognition (5 min)
2. Metrics Review (5 min)
3. Strategic Updates (10 min)
4. Demo/Deep Dive (15 min)
5. Q&A (10 min)
董事会更新邮件
Subject: Engineering Update - [Month]

Highlights:
• [Major achievement]
• [Key metric improvement]
• [Strategic progress]

Challenges:
• [Issue and mitigation]

Next Month:
• [Priority 1]
• [Priority 2]

Detailed metrics attached.

工具与资源

必备工具
  • 架构:Draw.io、Lucidchart、C4 Model
  • 指标:DataDog、Grafana、LinearB
  • 规划:Jira、Confluence、Notion
  • 沟通:Slack、Zoom、Loom
  • 开发:GitHub、GitLab、Bitbucket
重要资源
  • 书籍:

    • "The Manager's Path" - Camille Fournier
    • "Accelerate" - Nicole Forsgren
    • "Team Topologies" - Skelton & Pais
  • 框架:

    • DORA 指标
    • SPACE 框架
    • Team Topologies
  • 社区:

    • CTO Craft
    • Engineering Leadership Slack
    • LeadDev 社区

成功指标

✅ 技术卓越

  • 系统正常运行时间 >99.9%
  • 每天多次部署
  • 技术债务占比 <10%
  • 安全事件 = 0

✅ 团队成功

  • 团队满意度 >8/10
  • 人员流失率 <10%
  • 职位填补率 >90%
  • 多元化持续改善

✅ 业务影响

  • 功能按时交付率 >80%
  • 工程团队助力营收
  • 单笔交易成本持续下降
  • 创新推动增长

需要警惕的危险信号

⚠️ 技术债务增加
⚠️ 人员流失率上升
⚠️ 交付速度放缓
⚠️ 事件增多
⚠️ 团队士气下降
⚠️ 预算超支
⚠️ 对供应商的依赖增加 ⚠️ 安全漏洞


工具参考

1. tech_debt_analyzer.py

分析系统架构在 5 个类别(架构、代码质量、基础设施、安全、性能)中的技术债务。计算加权债务评分、确定债务削减行动的优先级、估算工作量并评估风险等级。

python scripts/tech_debt_analyzer.py --input system_config.json --json
python scripts/tech_debt_analyzer.py --input system_config.json
标志类型描述
--input可选包含系统配置的 JSON 文件路径(类别指标评分范围为 0-100、团队规模、关键程度、业务背景)。如果未指定,则使用内置示例
--json可选以 JSON 格式输出,而非便于阅读的文本
2. team_scaling_calculator.py

计算最优的工程团队扩张计划,包括招聘时间表、角色分配、团队结构设计、预算预测和风险评估。纳入布鲁克斯定律和康威定律的影响因素。

python scripts/team_scaling_calculator.py --input team_data.json --json
python scripts/team_scaling_calculator.py --input team_data.json
标志类型描述
--input可选包含当前状态(人数、角色、开发速度)和增长目标(目标人数、时间线)的 JSON 文件路径。如果未指定,则使用内置示例
--json可选以 JSON 格式输出,而非便于阅读的文本

故障排查

问题可能原因解决方案
专门安排冲刺降低技术债务,评分却仍在上升债务削减的速度赶不上新债务产生的速度实施债务预防关卡(代码审查、架构审查);同时追踪债务产生率和削减率
DORA 指标有所改善,但客户满意度却在下降发布速度加快了,但发布的内容并不符合需求在 DORA 指标之外增加客户影响指标;审查功能采用率;与产品团队重新沟通优先事项
团队扩张计划屡屡未能达成招聘目标时间线不切实际、招聘能力不足,或雇主品牌不佳按季度增长率最高 25% 调整时间线;增加招聘资源(每年招聘 50 人配备 1 名招聘人员);投资建设雇主品牌
架构决策未被记录或遵循没有 ADR 流程,或创建了 ADR 却未加以参考实施轻量级 ADR 模板;将 ADR 审查纳入设计审查;将 ADR 链接到相关代码
快速扩张期间工程团队士气下降文化稀释、预期不明确,或入职培训不足实施结构化入职培训;保持 1:8 的经理比例;每季度开展团队健康度调查
供应商锁定带来战略风险缺少评估框架,或过度依赖单一供应商对关键供应商进行技术评估;实施抽象层;制定退出策略

成功标准

  • 所有类别的技术债务评分均低于 40(中低)
  • DORA 指标达到“高”或“精英”性能等级(部署频率高于每周 1 次、前置时间少于 1 周、平均恢复时间少于 1 天、变更失败率低于 15%)
  • 团队平衡评分高于 70/100,并保持合适的角色比例
  • 所有重要技术决策均通过 ADR 记录
  • 生产系统正常运行时间超过 99.9%
  • 工程团队满意度高于 8/10,人员流失率低于 10%
  • 创新时间(黑客马拉松、探索)保持在工程产能的 15-20%

范围与局限

范围内: 技术战略与愿景、技术债务评估与减少规划、工程团队扩展与组织结构设计、架构治理(ADR、设计评审)、供应商管理与评估、工程指标(DORA、质量、团队健康状况)、危机管理(事件响应、安全漏洞、数据丢失)、利益相关者管理与董事会报告,以及战略举措(云迁移、平台工程、AI/ML 集成)。

范围外: 实际编码或代码审查(使用 engineering/skills)、产品功能优先级排序(使用 cpo-advisor)、安全架构与合规(使用 ciso-advisor 或 ra-qm-team/)、HR 政策与薪酬设计(使用 chro-advisor 或 hr-operations/),以及工程预算的财务规划(使用 cfo-advisor)。工具会分析工程数据快照;持续跟踪指标需要集成 DevOps 平台。

局限: 技术债务评分取决于自行报告的指标数据;自动化代码分析工具能提供更客观的衡量结果。团队扩展预算预测采用平均薪资区间,而薪资会因地区、资历构成和市场状况而有显著差异。DORA 基准假设采用标准软件交付实践;硬件或嵌入式系统团队可能需要采用不同的目标。


集成点

  • ceo-advisor -- 技术战略与业务方向保持一致;工程产能能够支持或限制战略决策
  • cpo-advisor -- 技术可行性由 CTO 与 CPO 共同负责;功能与平台之间的取舍需要双方共同决策
  • cfo-advisor -- 工程预算、人员成本和供应商支出会纳入财务规划
  • coo-advisor -- 系统可靠性与事件响应关系到卓越运营
  • ciso-advisor -- 安全架构、漏洞管理和合规需要 CISO 合作
  • engineering/ -- CTO 战略逐级落实到工程团队的执行中;架构决策指导实现工作

评论

支持 Markdown