Communitygithub.com

FerroxLabs/murage

构建一份包含成就与指标、扩展范围证据、同事与利益相关者影响、市场薪资背景以及明确诉求的书面晋升论证文档。生成一份可共享的文档,供用户向经理或领导层展示。当用户希望为晋升提供论据、准备晋升材料或记录成就以支持职级提升请求时使用。请勿用于绩效评估(使用 performance-review-prep)、薪资谈判脚本(使用 salary-negotiation-script)或简历撰写(使用 resume-bullet-writer)。

murage 是什么?

Promotion Case Builder 是一项专门用于帮助技术岗位用户(如软件工程师、产品经理、数据科学家)创建正式晋升论证文档的技能。它严格遵循结构化流程,首先通过询问当前与目标职级、在职时长、公司晋升流程类型、职级标准、经理态度、已知异议及过往绩效反馈等信息,全面收集组织背景。随后,它引导用户构建包含 5-8 个有量化指标的成就清单(按影响力而非时间排序),区分产出与成果,并定位高于当前职级的工作信号。技能还支持收集同事与利益相关者的验证证据(如感谢信、HRLinks绩效反馈)、建立扩展范围证据(使用“空缺测试”法),并借助市场薪资数据(如 Levels.fyi、Glassdoor)和人员保留风险分析来强化商业合理性。最终生成一份包含执行摘要、具体晋升请求(明确职级、生效日期与薪资期望)及后续行动步骤的完整文档。该技能支持多种平台(Claude Code、Cursor、Codex),尤其适用于那些需要向委员会或经理提交自述晋升材料的场景(如科技公司、咨询公司、金融服务公司),而避免用于绩效评估、薪资谈判或简历撰写。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/promotion-case-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

晋升论证文档构建器

何时使用

当用户明确想要构建一份书面的、可共享的晋升论证文档时使用此技能——而非当他们需要辅导、对话脚本或一般性职业建议时。

触发场景:

  • 用户表示要准备晋升材料、晋升论证或晋升文档,以提交给经理或评审委员会
  • 用户询问如何记录自己的成就,以证明即将到来的评审周期中的职级提升请求是合理的
  • 用户已非正式获知自己处于晋升轨道,需要将证据正式化
  • 用户正在为晋升校准会议做准备,经理将在会议上为其向委员会辩护,需要支持材料
  • 用户希望在正式周期开始前主动构建论证,以便立即提交
  • 用户在上一周期被晋升否决,希望为下一周期构建更强、更结构化的论证
  • 用户所在公司要求作为正式流程的一部分提交自撰晋升材料(这在技术公司、咨询公司和金融服务公司的资深独立贡献者和管理层层面很常见)
  • 用户希望记录自己当前职级之上工作的模式,以论证时机——该晋升是迟来的,而非理想化的

请勿在以下情况使用:

  • 用户想撰写将作为年度评审周期一部分提交的绩效自评——请改用 performance-review-prep,该技能围绕评审标准而非晋升标准组织内容
  • 用户需要面对面晋升谈话的脚本、谈话要点或辅导——薪资讨论部分请使用 salary-negotiation-script
  • 用户需要帮助撰写或重写简历要点以反映成就——请使用 resume-bullet-writer,该技能为简历受众而非内部倡导文档应用行动动词和STAR格式
  • 用户在问自己是否应得晋升或希望你评估其准备情况——此技能构建文档,不作出裁决
  • 用户正在为他人晋升撰写提名或推荐——此技能生成第一人称的自我倡导文档
  • 用户需要即将担任角色的30-60-90天计划——那是入职规划,而非晋升论证

流程

第1步:在撰写任何内容前收集晋升背景

晋升论证的质量完全取决于对组织背景的理解。在起草文档的任何一个字之前,询问所有这些问题的全部内容。

  • 当前与目标头衔及级别: 获取确切头衔。“高级”和“专家”在不同公司含义不同。如果公司使用数字级别(L4、L5、E5、Band 6),请同时获取头衔和级别代码,因为级别指南是按代码而非头衔索引的。
  • 当前角色任职时长: 这之所以重要有两个原因——它决定了论证是否需要解决任期问题(不足12个月是阻力;12-24个月是标准;36个月以上可能需要解释为什么晋升尚未发生),并且它设定了证据窗口期。
  • 晋升流程类型: 有四种常见原型。(1) 正式周期与委员会校准——常见于科技公司、银行和咨询公司;文档将被不认识用户的人阅读。(2) 经理发起并经人力资源批准——文档供经理作为内部倡导材料使用。(3) 自我提名并附同行评审材料——用户直接提交;文档必须独立存在。(4) 临时或基于对话的——没有正式流程;文档成为后续参考材料或结构化的电子邮件附件。
  • 级别指南可用性: 如果公司发布职业阶梯或级别框架,请获取当前级别和目标级别的具体标准。论证必须将证据映射到这些确切标准,而非通用能力。如果没有指南,询问用户他们听说的与目标级别相关的行为或期望。
  • 经理的立场: 支持(经理已在倡导,需要弹药)、中立(经理持开放态度但未被说服)或怀疑(经理有保留意见或给出了模棱两可的信号)。这决定了框架——怀疑的经理要求论证预先解决异议。
  • 已知异议: 直接询问用户:“您的经理或其他任何人是否对您的准备情况提出过任何担忧?”常见的异议包括任期太短、范围太窄、技术深度与广度问题,或与同行的比较。每个已知的异议都必须在文档中直接解决。
  • 前一个评审周期结果: 如果用户之前被否决过,询问他们收到了什么反馈。新的论证必须展示他们如何具体解决了该反馈。

第2步:构建成就清单

这是文档的证据核心。不要接受模糊的描述。

  • 目标是5-8个成就。少于5个显得单薄。超过8个会冲淡最强有力的证据,使文档对忙碌的评审人来说难以处理。
  • 对于每个成就,要求包含四个要素:(1) 采取的行动——用户具体做了什么,而非团队做了什么;(2) 成果——因此发生了什么变化;(3) 指标——一个数字、百分比、时间差或金额;(4) 级别映射——此证据满足了目标级别的哪项能力。
  • 大力推动量化。如果用户说“我提高了客户满意度”,问:提高了多少NPS分?前后的CSAT分数是多少?影响了多少客户?前后流失率如何?如果用户真的无法给出数字,使用范围-后果框架:“改善了每月8,000名新用户的引导流程,通过消除用户研究中确定的前三大痛点,减少了主要的支持升级类别。”
  • 按影响力大小排序成就,而非按时间顺序。最关键的业务成就放在第一位。如果用户领导了一个带来50万美元收入的项目,那就是锚点;如果他们还减少了一次会议时间,那就不应该是成就#2。
  • 区分产出(交付了什么)和成果(因为交付了什么而改变了什么)。委员会和校准会议上的经理关心成果。“发布了新的搜索功能”是产出。“发布了新的搜索功能,将搜索到购买的转化率提高了18%,贡献了120万美元的季度增量收入”是成果。
  • 识别哪些成就是用户当前级别同行尚未在做的。这些是委员会寻找的“高于级别”的信号。一个领导跨团队迁移的二级软件工程师在做三级软件工程师的工作;一个按时发布功能的二级软件工程师只是在做好二级软件工程师的工作。

第3步:构建扩展范围证据

晋升不是对做好当前工作的奖励——而是对已经在下一级别运作的认可。此部分必须证明这一主张。

  • 将用户当前的日常职责与当前级别和目标级别的工作描述或级别标准进行对比。他们做的任何出现在目标级别描述中但不在当前级别描述中的事情都是扩展范围证据。
  • 识别所有权模式:谁来向用户寻求决策?谁将他们视为一个系统、领域或流程的事实上的所有者?级别更高的人就非正式属于他们的领域向用户提问,范围信号就越强。
  • 记录跨职能影响:用户是否推动了两个存在冲突的团队之间的协调?他们是否在领导论坛上代表其团队?他们是否制作了一份其他团队采纳的文档、标准或流程?这些是范围倍增器。
  • 对于人员管理目标(工程经理、总监、团队负责人):记录每一项事实上的管理行为——主持团队会议、与初级员工进行一对一沟通、撰写绩效反馈、解决团队冲突。在缺乏正式头衔的情况下的这些行为是最强有力的证据。
  • 使用“空缺测试”来界定范围:“如果这个人明天离职,有什么会中断或停止,而当前级别的人预计无法修复的?”答案就是他们的下一级范围。

第4步:收集同事和利益相关者影响证据

仅凭用户自身主张的晋升论证弱于包含外部验证的论证。此部分将自我倡导转化为经证实的倡导。

  • 要求用户回忆具体的有记录正面反馈实例——Slack消息、电子邮件、来自同行的绩效评估评论、360反馈节选、奖项提名、季度业务回顾表扬。这些引述之所以有力,是因为它们来自第三方。
  • 识别表扬过或依赖用户工作的最高身份人士。一位在董事会演示中引用了用户分析的副总裁比一位说谢谢的同行更有说服力。
  • 记录用户工作的影响半径:影响了多少人、团队或客户。“我的工作影响了3个工程团队和40,000名最终用户”比“我为平台做出了贡献”更有说服力。
  • 关于指导:记录成果,而非活动。“指导了两名工程师”是活动。“指导了两名工程师,他们现在都能独立运作,其中一人上个季度晋升为二级软件工程师”是带有证据的成果。
  • 如果用户没有可引用的书面反馈,建议他们在提交晋升论证前主动收集反馈。有针对性的请求——例如“我正在准备晋升材料,希望您能就我们的合作提供简短评价”——发送给两三位值得信赖的同事,只需24小时即可完成,并能显著增强文档。

第5步:构建市场背景部分

此部分确立晋升不仅对用户公平——而且对公司是明智的商业决策,并符合市场规范。

  • 从三个层面构建市场背景:(1) 头衔规范——在可比公司,目标头衔承担什么职责?用户当前的职责应匹配或超过这些规范。(2) 薪酬基准——目标级别的薪资范围是多少?源自Levels.fyi(工程师)、Glassdoor(经理)、LinkedIn Salary(通才)或行业薪酬调查(Radford、Mercer)的一般范围是合适的参考。使用$5K-$10K的范围,而非点估计。(3) 留任风险——用户离职并被替换对公司来说成本是多少?对于中级独立贡献者,招聘、入职和生产力损失成本的一般规则是年薪的50-200%。不要编造具体数字;使用范围。
  • 对于专业角色(安全工程师、机器学习工程师、增长型产品经理),注意目标级别的市场活跃且竞争激烈,因为这创造了紧迫感而不具威胁性。
  • 根据用户对公司文化的判断,校准如何在请求中突出薪酬。在薪资透明化的公司,引用薪资范围是正常的。在薪资不透明的公司,在晋升文档中提出具体数字可能适得其反;更稳妥的做法是模糊提及“与目标级别薪资范围一致的薪酬”。
  • 如果用户收到了竞争性offer或外部招聘人员的兴趣,他们应单独决定是否将其用作筹码。不要在正式的晋升文档中包含竞争性offer——它属于谈判对话,而非校准文档。

第6步:撰写执行摘要

最后写这部分,而非最先写,即使它在文档中出现在最前面。

  • 执行摘要是经理将在校准会议上向委员会大声朗读的内容。必须少于三句话。每个字都承载着信息。
  • 结构:第1句——任期和印象最深刻的单一影响。第2句——高于当前级别运作的模式(范围论证)。第3句——对晋升准备情况的明确主张。
  • 避免:流行词(“协同”、“杠杆”、“推动协调”)、不带证据的形容词(“卓越”、“杰出”)以及将来时态框架(“我准备承担”)。摘要必须完全使用现在时和过去时——已经完成的事情和当前正在发生的事情。
  • 用这个问题测试执行摘要:一个从未见过用户的委员会成员,在阅读这三句话的摘要后,是否拥有足够的信息来理解为什么这次晋升是合理的?如果是,那就很好。如果他们需要背景信息才能理解任何术语或主张,请修改。

第7步:撰写请求和提议的下一步

请求是许多晋升文档失败的地方——它们做了一个强有力的论证,然后没有提出明确具体的请求就草草收场。

  • 明确说明所请求的确切头衔。不要写“晋升”——写“从高级分析师晋升为首席分析师”。
  • 说明提议的生效日期。选项:下一个评审周期(注明月份/季度)、针对临时流程的30-60天后的特定日期,或“在[周期名称]校准委员会批准后”。
  • 明确说明薪酬期望,但根据文化进行调整。最低限度:“薪酬与[目标头衔]级别范围一致。”如果用户知道范围:“基本工资在$[X]-$[X]范围内,与[目标头衔]薪资范围一致。”
  • 提议一个具体的后续行动:与经理进行30分钟的会议,讨论该论证并了解如果需要晋升继续进行,有什么(如果有的话)需要实现。始终提供具体的日期/时间。

输出格式

生成的文档遵循此结构,所有部分都已填写:

# 晋升论证:[姓名]
# 晋升论证:[姓名]

## 执行摘要

[三句或更少——将在此处插入最终摘要]

---

## 成就与指标

### 1. [成就标题]
**行动:** [用户具体做了什么]
**成果:** [什么改变了]
**指标:** [数字、百分比、金额]
**级别映射:** [此成就满足的目标级别能力]

[重复5-8次]

---

## 扩展范围证据

[段落证明用户已经在目标级别工作——使用对比和“空缺测试”框架]

---

## 同行与利益相关者影响

> “[来自同行或高级领导的引述]”
> “[来自同行或高级领导的引述]”

**影响范围:** [受影响的人数/团队/客户]
**指导成果:** [具体指导成果,而非活动]

---

## 市场背景

**头衔规范:** [在可比公司,此头衔的典型职责]
**薪酬基准:** [目标级别的范围]
**保留风险:** [替换成本的大致范围]

---

## 请求与下一步

**请求:** 从[当前职级和级别]晋升为[目标职级和级别]
**提议生效日期:** [日期或周期]
**薪酬:** [符合文化期望的表述]
**下一步:** [具体会议提议及日期]

质量检查清单

在将文档交给用户之前,验证上述每一个陈述。如果任何一个缺失,它就没有准备好。

  • 每个成就都有四个元素:行动、成果、指标、级别映射
  • 成就按影响力排序,而非按时间
  • 没有使用将来时态表述“我准备”——所有内容都是现在或过去时
  • 每个已知的异议都在文档中被正面解决
  • 至少有两条来自第三方的引述或具体实例
  • 范围证据明确表明工作条目的哪些部分是当前级别的,以及哪些看起来像目标级别的
  • 市场背景部分包含所有三个层面(头衔、薪酬、保留)
  • 执行摘要在三句话以内,并且无人能孤立理解其所有内容
  • 请求项包含确切头衔、日期和薪酬期望(即使只是“与级别一致”)
  • 文档可以在用户选择时立即以电子方式共享(PDF、Google Doc或电子邮件)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

FerroxLabs/murage

Web animation expertise covering CSS animations and transitions, Web Animations API, Framer Motion, GSAP, scroll-driven animations, layout animations, spring physics, reduce-motion preferences, and performance budgets. Use when the user asks about animation designer, animation designer best practices, or needs guidance on animation designer implementation. Do NOT use when the user needs a different specialized skill or is asking about an unrelated technology domain.

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

相关技能