晋升路线图
不要使用破折号。 此技能生成的任何内容都不得包含破折号;请使用逗号、冒号或圆括号代替。由仓库钩子强制执行。请参阅
/flagrare:write-docs。
使用平实的语言。 在用户阅读的任何内容中,请使用
<plugin root>/lib/career/GLOSSARY.md中定义的平实名称(例如使用“高级行为”而不是“评分标准行”;使用“你的书面陈述”而不是“材料”;使用“你拥有的项目”而不是“举措”)。在术语首次出现时,用几句话说明其含义,并在括号内附上公司在工作中的惯用说法。
晋升的决定是在用户不在场的会议中,基于一份书面陈述,由大多数不认识用户的人做出的,且时间表提前数月就已确定。此技能旨在让这些事实尽早变得可见:用户想去哪里以及为什么,公司实际如何决策,评分标准要求什么,谁对用户的工作有一手了解,以及关键对话必须何时进行。
它会生成一份 晋升路线图:promotion-map.md 供用户阅读并带入一对一会议,以及具有相同事实的 promotion-map.json 供其他职业发展技能使用。该路线图是本地且私有的。此技能永远不会发布、发送或公开任何内容。
库文件
插件附带了位于 <plugin root>/lib/career/ 的辅助脚本。插件根目录在该技能基础目录的上两级。每个脚本通过 python3 <plugin root>/lib/career/<script>.py ... 运行。它们仅读取和打印 JSON;此技能使用“写入”工具写入每个文件,因为沙盒化的 shell 无法写入 ~/.claude/skills 下的文件。
career_state.py paths|contributions|plan --home "$HOME":文件位置、贡献日志(新旧位置的并集)以及迁移计划。map_schema.py check <map.json> --today YYYY-MM-DD:检查错误、缺失章节、过期章节(超过90天)、冲突。deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]:计算与经理交谈的时间。--dead为可选且可重复。
路线图的结构定义在 reference/map-schema.md 中,Markdown 布局定义在 reference/map-template.md 中。其他共享状态文件(贡献日志、标志、倡议)在 <plugin root>/lib/career/STATE.md 中描述;通过移除已处理标志的方式写回 flags.json 来清除标志。
1. 加载状态(每次运行)
- 运行
career_state.py plan。使用“写入”工具执行每个write操作,如果目标文件已存在,则先读取它(“写入”工具不会覆盖未读取的文件)。mkdir操作无需单独步骤:首个文件写入时即创建目录。不要写入占位性的路线图。切勿删除任何内容。 - 读取
~/.claude/skills/flagrare/config.json(顶级身份键值、skills.promotion块)以及现有的路线图(如有)。如果配置文件或skills.promotion块缺失,则使用默认值继续。 - 没有路线图意味着首次运行(第3节)。如果
map_schema.py check的输出显示存在missing章节,则表示首次运行被中断:从其章节缺失的最早阶段恢复。否则执行刷新(第4节),除非用户要求packet模式(第5节)。
由 /flagrare:career 调用。 参数指定模式(first_run、resume 或 refresh)以及要处理的章节:仅执行这些章节。当参数同时指定 scheduled 时,切勿访谈或询问用户:重新研究并保存仅需无需用户回答的章节(流程、日历、评分标准、组织架构、先例),并将每个需要用户输入的章节(目标、人员、经理问题)作为一行返回给协调器的“需要你完成”列表。无论哪种情况,都返回变更的简短摘要,而非完整的路线图。
2. 每条事实的规则
- 来源、日期、状态。 每条事实都附带链接或引用位置、检查日期以及状态:
verified(在原始来源中阅读并引用)、unverified(摘录、片段或二手信息)或inferred(你的推理)。 - 逐字引用原始来源。 抓取工具会进行总结。当引用的信息将被依赖时,请重新读取原始页面(例如页面的 JSON 或 HTML)并确认确切的措辞。
- 展示冲突,切勿静默选择。 当两个来源存在分歧时(例如组织架构图与团队目录不同,流程页面与晋升梯级文件不同),将两者都存储为
alternatives并告知用户。 - “未找到”也是有效结果。 如果某一步未找到任何内容,请向
manager_questions添加一个具体问题,而不是进行猜测。许多公司没有书面流程。 - 人员信息是敏感的。 仅读取用户自身的交互信息。记录谁对用户的工作有第一手背景信息,切勿对人员有用程度进行排名。
- 在使用浏览器访问人力资源门户或内部网站前,需获得用户同意。
3. 首次运行
预先告知用户:首次运行时间较长,通常需要一小时或更久,但会在每个阶段后保存,因此可以随时停止和恢复。
每次保存 都会写入 promotion-map.json 和 promotion-map.md,并为该阶段写入的每个章节设置 sections.<name>.checked_at(今日日期)和 sections.<name>.sources。缺少 checked_at 的章节将被视为过期。阶段1写入 target、process 和 calendar;阶段2写入 rubric;阶段3写入 org、people 和 precedent;阶段4写入 packet_readiness 和 manager_questions。即使未找到任何内容,也要写入每个章节(作为带有 checked_at 的空列表或对象),这样空章节不会被误认为是中断的运行。
阶段1:目标、流程和日历
- 首先进行访谈,然后再进行研究。 每次只问一个问题:
- 当前职级和目标职级。
- 轨道:个人贡献者或经理。
- 他们瞄准的是哪个周期(在步骤4了解日历后再回到这个问题,并提出一个建议)。
- 为什么他们想要晋升,他们希望从事更多哪种工作,以及他们希望减少哪种工作。
- 查找关于目标职级的两个事实: 在该公司该职级是否为终局职级(没有期望会再晋升),以及当前职级预期的任职时间范围。引用两者。
- 说明“为什么”改变了什么。 终局职级加上“安心”的动机意味着目标就是终点。如果是“金钱”或“职权范围”的动机,则意味着需要规划超越目标。将这一点写入路线图的第1节。
- 在每一个连接的源中查找流程、日历和材料模板: 维基、文档、频道公告、会议记录、人力资源门户(需经同意)。同时查找 产品决策是如何做出的:决策文档以及通常由谁推动。机会分析需要此信息。
另外查找 领导层衡量的指标:公司的主题或战略文档、OKR 和规划文档,以及规划会议和全员大会的内容(在连接的情况下,从 Granola 等工具的会议记录中获取)。在
priorities中记录每个对用户领域重要的指标:主题、指标、基准线和目标(如有书面记录,每条事实附带来源)、负责的团队,以及user_lever:如果用户的职位拥有该指标主要输入的所有权,则为owner;如果用户的系统为其提供输入,则为input;如果杠杆作用在另一个团队,则为none。机会分析会针对这个列表对提案进行排序。优先事项从会议记录中获取,切勿获取关于人员的引用。 - 使用已填充的
target、process、calendar和sections条目保存路线图(JSON 和 Markdown)。
阶段2:评分标准差距分析
- 查找经理用来进行评分的工件(如晋升梯级电子表格、阶段小结工作簿),而非描述它的文字。询问用户他们的经理是否使用阶段小结工作簿。如果文字描述和工件存在矛盾,使用工件并在
rubric.prose_mismatches中记录差异。 - 为每个行为构建一个
rubric.rows条目:当前职级的文本、目标职级的文本、一个稳定的 ID(<area>.<short-slug>),以及一个label,即用两到四个平实的词语描述的行为(例如“发现问题”、“受欢迎的审阅者”),看板和摘要中会显示该标签而不是 ID。 - 将每行标记为
done、partial或not_started,并附上来自以下方面的证据:career_state.py contributions、同事给予用户的认可(当认可工具已设置时,参见下面的“认可”:每个带链接的奖金都是证据,其标记的公司价值指向核心价值行为)、用户的审阅和工作、以及用户分享的过往审阅笔记。 - 保存。
阶段3:组织架构与谁了解你的工作
- 组织架构: 用户的汇报链、用户可能去的每个团队之上的负责人,以及即将发生的变化(来自会议记录和公告的离职、新负责人、重组)。每个人员都附带来源和状态。
- 谁了解你的工作,先看证据,再问用户:
- 从用户自身的交互(给出和收到的审阅、共享的线程、共享的会议以及所有给予他们认可的人)中提出候选人,每个都附带证据链接。认可用户的某人肯定亲眼见过他们的工作;标记其中任何一位在晋升委员会中的人员。
- 请用户确认和更正,并添加工具无法看到的,比如前经理或黑客马拉松团队。
- 设置
seen_your_work和confirmed_by_user。
- 谁在定级校准会议中: 从流程文档中推断,引用相关句子,并将其标记为
inferred。列出在会议室中但未见用户工作的人员。 - 先例: 阅读最近的晋升公告以了解哪些贡献被归功,并在路线图中写入“公告是叙事,不是审计”。仅当用户询问时才提供深层分析:在代码、文档和工单中交叉核对实际发起工作的人。这开销很大且默认关闭。
- 保存。
阶段4:计划
- 截止日期: 使用材料截止日期运行
deadlines.py。如果本周期日期已公布,则使用它并传递--published。否则将去年同周期日期映射到今年(同月同日,仅年份加一),并将其标记为inferred。询问用户哪些假期或休假窗口是他们的死时间,并将其作为--dead传递。记录“X 日期前稳妥,Y 日期前绝对完成”及其状态和阶段。如果状态为past,则直接说明并给出下一个周期。 - 每个未完成行的下一步行动: 对于每个非
done的行,写入next_step:能够为证据增加分量的最便宜的单一具体行动,并根据你发现的关于公司的情况进行调整(例如“在招聘频道输入 /interview”、“在合作伙伴仪表板上提供一次结对编程会议”、“向你的经理要求共同负责路线图的一部分”)。看板会列出三个最大的差距及这些步骤,因此确保每个步骤在一周内可完成,而非一个长期目标。 - 材料准备就绪度: 运行
python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date>以获取每个评分标准行的证据计数(标记了该行的日志条目加上该行本身的证据),然后根据每部分依赖的行,将模板的每个部分标记为strong、thin或empty。 - 同行反馈选择: 从
recognition.py summary中,最常认可用户的人员以及认可的原因,是书面陈述中同行反馈的首选候选人(3到5人);将他们添加到同行反馈笔记中。 - 经理问题: 所有仍然未知的事项,加上准备就绪度问题(例如“<周期>是否现实,还缺少什么?”)。
- 运行
map_schema.py check。修复任何错误,然后保存。 - 向用户显示简短摘要:目标、两个对话日期、尚未展示的高级行为(按标签)、谁还需要看到他们的工作,以及他们需要问经理的问题。提示用户查看
promotion-map.md。
4. 刷新
- 运行
map_schema.py check,并读取career/flags.json(如果存在)(其他技能会在其中写入过期信号,例如重组、离职或日历公布)。当认可工具已设置时,通过运行python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>刷新认可记录(使用“写入”工具应用其对career/recognition.json的写入计划;此操作需要网络)。 - 仅重新研究过期或标记的章节。保持所有其他章节不变。
- 询问用户“有什么变化吗?”,涵盖目标、经理、团队以及见过他们工作的人员。
- 如果日历章节被重新检查,或者有标志表示日历已公布,则重新运行
deadlines.py并更新calendar.manager_conversation。 - 当某行的证据发生变动时(如果步骤已完成或不再是性价比最高的行动,则替换掉),刷新每个未完成行的
next_step,并补充任何缺失的label。 - 更新每个重新检查章节的
checked_at,清除你处理的标志,然后保存。
认可
当用户公司使用同事认可工具(目前为 Bonusly)时,其中的感谢是用户无需自行申报的证据。设置步骤:用户在工具中创建个人 API 令牌,并将其保存到 ~/.config/flagrare/bonusly-token(或 config.json 中由 skills.career.recognition.token_file 指定的文件)。切勿将令牌存储在 config.json 或仓库中,也切勿粘贴到聊天中。然后运行 python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>(使用“写入”工具应用其对 career/recognition.json 的写入计划;此操作需要网络);recognition.py summary 会给出总数、公司价值以及最常认可用户的人;来自工具自动账户(生日、周年纪念、欢迎)的感谢将单独计数,并且绝不被视为人员或证据。仅引用与用户相关的信息。此技能绝不会通过该工具发送任何内容。
5. 材料模式 (/flagrare:promotion packet)
当材料截止日期临近,或用户要求时:
- 加载路线图;如果没有,则先进行首次运行。收集自上次晋升(或入职日期)以来的证据:对于不超过一个月的时间窗口,使用
/flagrare:brag-doc;对于更长的窗口,使用/flagrare:impact-timeline。 - 使用公司的模板起草材料,模板来自
process.packet_template(如果模板未知,则使用此常见结构并说明为备用方案:标题部分,然后是 2-3 个项目(角色、估算……
……
[原文因在 estimate 后截断,后续内容丢失。翻译基于现有完整内容已完成。]