vpe-advisor

vpe-advisor skill 概览

vpe-advisor 适合解决什么问题

vpe-advisor 是一个面向工程副总裁（VP of Engineering）运营建议的 skill，适合创业公司工程负责人、创始人和临时高管使用，帮助他们围绕交付吞吐、招聘漏斗健康度、团队设计和生产稳定性建立更有结构的判断。它最适合的问题不是“我们该选什么架构？”，而是“工程组织应该如何交付、招聘、拆分团队，并可靠地运行生产系统？”

最适合的用户与决策场景

vpe-advisor skill 适合正在面对实际运营决策的团队：sprint velocity 正在下降、PR 等待时间过长、事故反复出现、招聘计划没有达标，或者管理者不确定什么时候该拆分团队、增加工程管理层。它也适合用于 Strategic Planning，因为它能把模糊的组织担忧转化为明确的决策领域：DORA metrics、招聘漏斗转化、squad/tribe/chapter 结构、manager triggers、on-call 可持续性、发布节奏，以及 postmortem 文化。

它和通用 prompt 有什么不同

vpe-advisor 不会只给宽泛的领导力建议，而是把建议锚定在四个聚焦的参考文件和三个确定性的 Python 工具上。参考文件解释决策逻辑；脚本则基于 JSON 输入计算交付吞吐、招聘漏斗缺口和团队结构建议。相比普通的“act as a VP Engineering” prompt，这能为 agent 提供更强的运营支架。

安装前需要了解的重要边界

vpe-advisor 不是 CTO、架构、产品战略或 HR 合规类 skill。它可以讨论 Conway’s Law 及其运营影响，但架构归属应由其他机制负责。它也依赖相对准确的输入：部署次数、lead time、事故、漏斗各阶段人数、headcount、manager 数量，以及工作流复杂度。如果你只提供主观看法，得到的也更可能是方向性建议，而不是可执行的运营计划。

如何使用 vpe-advisor skill

vpe-advisor 的安装方式与优先查看的文件

使用你的 skill manager 从仓库路径安装，例如：

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

安装后，先阅读 SKILL.md，了解它的激活范围和适用的问题模式。然后在真实规划会议中使用该 skill 前，检查以下文件：

• references/delivery_throughput.md
• references/engineering_hiring_funnel.md
• references/eng_team_structure.md
• references/production_discipline.md
• scripts/delivery_throughput_analyzer.py
• scripts/eng_hiring_funnel_calculator.py
• scripts/eng_team_structure_designer.py

参考文件说明管理判断；脚本展示输入 schema 和确定性的阈值。

哪些输入能让 vpe-advisor 更好用

要让 vpe-advisor 输出高质量建议，最好提供真实的运营数据，而不是泛泛抱怨。有效输入包括：

• 团队规模、IC 数量、EM 数量、director 数量、squad 数量，以及活跃 work stream
• 部署频率、median lead time、MTTR、change failure count，以及 cycle-time 各阶段数据
• 招聘目标、ATS 漏斗人数、offer acceptance rate，以及 median time-to-fill
• 当前 on-call 轮值规模、事故频率、部署模式，以及 postmortem 习惯
• 规划周期、约束条件，以及当前必须做出的决策

较弱的 prompt 是：“我们的工程团队感觉很慢。”更强的 prompt 是：“We have 22 ICs, 3 EMs, 3 squads, 4 work streams, weekly deploys, 8-day median lead time, PR review wait of 30 hours, and 4 hires needed this quarter. Use vpe-advisor to identify the highest-leverage operating fix.”

在实践中使用内置脚本

当你能够提供结构化 JSON 时，这些脚本会很有用。可以在 skill 文件夹中本地运行，也可以复制到工作目录中运行：

python scripts/delivery_throughput_analyzer.py metrics.json

python scripts/eng_hiring_funnel_calculator.py funnel.json

python scripts/eng_team_structure_designer.py team.json

如果没有提供文件，每个脚本也会使用内置示例运行，这有助于学习 schema。把脚本输出作为 prompt 中的证据：将结果粘贴到聊天里，并要求 vpe-advisor 将其转化为运营建议、风险判断和 30-60-90 天计划。

用于 Strategic Planning 的 prompt 模式

如果要将 vpe-advisor 用于 Strategic Planning，请把请求写成决策备忘录，而不是头脑风暴：

“Use vpe-advisor. Context: [company stage, headcount, product pressure]. Data: [delivery, hiring, team structure, production metrics]. Decision needed: [what to change this quarter]. Constraints: [budget, hiring freeze, reliability risk, roadmap deadlines]. Output: diagnose bottlenecks, rank interventions, explain tradeoffs, and propose a 30-60-90 day operating plan.”

这个 prompt 有效，是因为它给了 skill 足够的上下文，让它能在相互竞争的 VPE 杠杆之间做选择，而不是罗列所有可能的工程管理实践。

vpe-advisor skill 常见问题

vpe-advisor 适合早期创业公司吗？

适合，尤其是当团队规模已经大到交付、招聘或 on-call 纪律不能再靠非正式方式维持时。对于五人的工程团队，这个 skill 仍然可以帮助诊断吞吐或生产习惯，但有些结构性建议可能会明确指出“暂时不要增加流程”。

什么时候不该使用 vpe-advisor？

不要把 vpe-advisor 作为系统架构、技术选型、薪酬政策、HR 法务流程或绩效管理决策的主要工具。它可以识别运营症状，但不应替代领域专家、劳动用工法律顾问或架构评审。

这和直接问 AI 要 VPE 建议有什么区别？

普通 prompt 很大程度上依赖模型的通用知识。vpe-advisor skill 会为 agent 提供具体的决策框架、健康区间、反模式和脚本支持的计算。当你需要可重复的诊断，而不是泛泛的领导力话术时，这一点很重要。

vpe-advisor 需要完美的指标吗？

不需要，但它需要诚实的近似值。如果 DORA、ATS 或事故数据不完整，请清楚标注。skill 仍然可以基于部分数据进行推理，但当估算值和实测事实被分开呈现时，输出质量会最好。

如何改进 vpe-advisor skill

在寻求建议前先改进 vpe-advisor 输入

最常见的失败模式，是在缺少足够运营数据的情况下直接要求建议。调用 vpe-advisor 之前，先整理一页快照：当前团队拓扑、交付指标、招聘漏斗、事故/on-call 状态，以及驱动本次决策的业务约束。这样可以避免输出变成通用的工程领导力 checklist。

要求权衡，而不只是要建议

VPE 工作经常是在选择接受哪一种痛点。可以要求 skill 比较不同选项，例如 “add EM”、“split squads”、“reduce WIP”、“tighten incident review” 或 “increase sourcing volume”。有效的追问包括：“What is the hidden cost of this recommendation?” 以及 “What metric should improve first if this is working?”

首轮回答后用证据继续迭代

拿到第一版输出后，把不可行、政治上困难或与数据矛盾的部分反馈回去。例如：“We cannot hire an EM this quarter, and the platform team owns three critical services. Revise the plan using only role clarification, WIP limits, and deployment-process changes.” 这能帮助 vpe-advisor 产出可落地的计划，而不是理想状态下的组织设计。

按你的运营模型扩展这个 skill

要在本地改进 vpe-advisor，可以加入公司特定的 benchmark、事故严重程度定义、招聘阶段名称、团队拓扑约束和部署政策。新增内容应保持决策导向：用你的组织实际使用的阈值、示例和反模式更新参考文件。如果添加脚本，请保留当前清晰 JSON schema 和确定性输出的模式，确保 agent 可以可靠调用。