Communitygithub.com

Flagrare/agent-skills

构建并维护一份经过来源验证的晋升路线图,帮助用户规划职业发展。它通过访谈了解用户的目标(职级、轨道、周期及原因),研究公司实际的晋升机制(流程、日历、材料模板、经理使用的评分标准),梳理组织架构并识别了解用户工作的一手人员,同时计算与经理沟通的最佳时机。每条信息都附带来源和验证状态,冲突信息会被展示而非静默处理。

agent-skills 是什么?

该技能旨在为开发者构建一份基于事实的、可验证的晋升路线图。它通过访谈用户收集目标(目标职级、轨道、周期和动机),然后自动研究公司特定的晋升流程、日历、材料模板和评分标准。技能会梳理组织架构,识别哪些人有一手了解用户的工作,并计算与经理沟通的关键时间点。每条记录的事实都附带来源和状态(已验证、未经验证或推断),如果来源之间存在冲突,技能会明确显示出来,而不是静默地选择一种。该技能支持 Claude Code、Cursor 和 Codex 等平台,通过写入 `~/.claude/skills/flagrare/career/promotion-map.md` 和 `promotion-map.json` 文件来实现功能。这些文件可以被其他职业发展技能(如 impact-scan、opportunity-scan 和 career read)读取。该技能由特定关键词(如“promotion”、“promo plan”、“how do promotions work here”)触发,也适用于更广泛的职业策略问题。它通过分阶段(目标、流程、评分标准、组织架构、计划)运行,并在每次运行后保存状态以支持中断和恢复。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Flagrare/agent-skills/tree/HEAD/plugins/flagrare/skills/promotion

在你喜欢的 AI 中提问

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

文档

晋升路线图

不要使用破折号。 此技能生成的任何内容都不得包含破折号;请使用逗号、冒号或圆括号代替。由仓库钩子强制执行。请参阅 /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. 加载状态(每次运行)

  1. 运行 career_state.py plan。使用“写入”工具执行每个 write 操作,如果目标文件已存在,则先读取它(“写入”工具不会覆盖未读取的文件)。mkdir 操作无需单独步骤:首个文件写入时即创建目录。不要写入占位性的路线图。切勿删除任何内容。
  2. 读取 ~/.claude/skills/flagrare/config.json(顶级身份键值、skills.promotion 块)以及现有的路线图(如有)。如果配置文件或 skills.promotion 块缺失,则使用默认值继续。
  3. 没有路线图意味着首次运行(第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:目标、流程和日历

  1. 首先进行访谈,然后再进行研究。 每次只问一个问题:
    1. 当前职级和目标职级。
    2. 轨道:个人贡献者或经理。
    3. 他们瞄准的是哪个周期(在步骤4了解日历后再回到这个问题,并提出一个建议)。
    4. 为什么他们想要晋升,他们希望从事更多哪种工作,以及他们希望减少哪种工作。
  2. 查找关于目标职级的两个事实: 在该公司该职级是否为终局职级(没有期望会再晋升),以及当前职级预期的任职时间范围。引用两者。
  3. 说明“为什么”改变了什么。 终局职级加上“安心”的动机意味着目标就是终点。如果是“金钱”或“职权范围”的动机,则意味着需要规划超越目标。将这一点写入路线图的第1节。
  4. 在每一个连接的源中查找流程、日历和材料模板: 维基、文档、频道公告、会议记录、人力资源门户(需经同意)。同时查找 产品决策是如何做出的:决策文档以及通常由谁推动。机会分析需要此信息。 另外查找 领导层衡量的指标:公司的主题或战略文档、OKR 和规划文档,以及规划会议和全员大会的内容(在连接的情况下,从 Granola 等工具的会议记录中获取)。在 priorities 中记录每个对用户领域重要的指标:主题、指标、基准线和目标(如有书面记录,每条事实附带来源)、负责的团队,以及 user_lever:如果用户的职位拥有该指标主要输入的所有权,则为 owner;如果用户的系统为其提供输入,则为 input;如果杠杆作用在另一个团队,则为 none。机会分析会针对这个列表对提案进行排序。优先事项从会议记录中获取,切勿获取关于人员的引用。
  5. 使用已填充的 target、process、calendar 和 sections 条目保存路线图(JSON 和 Markdown)。

阶段2:评分标准差距分析

  1. 查找经理用来进行评分的工件(如晋升梯级电子表格、阶段小结工作簿),而非描述它的文字。询问用户他们的经理是否使用阶段小结工作簿。如果文字描述和工件存在矛盾,使用工件并在 rubric.prose_mismatches 中记录差异。
  2. 为每个行为构建一个 rubric.rows 条目:当前职级的文本、目标职级的文本、一个稳定的 ID(<area>.<short-slug>),以及一个 label,即用两到四个平实的词语描述的行为(例如“发现问题”、“受欢迎的审阅者”),看板和摘要中会显示该标签而不是 ID。
  3. 将每行标记为 done、partial 或 not_started,并附上来自以下方面的证据:career_state.py contributions、同事给予用户的认可(当认可工具已设置时,参见下面的“认可”:每个带链接的奖金都是证据,其标记的公司价值指向核心价值行为)、用户的审阅和工作、以及用户分享的过往审阅笔记。
  4. 保存。

阶段3:组织架构与谁了解你的工作

  1. 组织架构: 用户的汇报链、用户可能去的每个团队之上的负责人,以及即将发生的变化(来自会议记录和公告的离职、新负责人、重组)。每个人员都附带来源和状态。
  2. 谁了解你的工作,先看证据,再问用户:
    • 从用户自身的交互(给出和收到的审阅、共享的线程、共享的会议以及所有给予他们认可的人)中提出候选人,每个都附带证据链接。认可用户的某人肯定亲眼见过他们的工作;标记其中任何一位在晋升委员会中的人员。
    • 请用户确认和更正,并添加工具无法看到的,比如前经理或黑客马拉松团队。
    • 设置 seen_your_work 和 confirmed_by_user。
  3. 谁在定级校准会议中: 从流程文档中推断,引用相关句子,并将其标记为 inferred。列出在会议室中但未见用户工作的人员。
  4. 先例: 阅读最近的晋升公告以了解哪些贡献被归功,并在路线图中写入“公告是叙事,不是审计”。仅当用户询问时才提供深层分析:在代码、文档和工单中交叉核对实际发起工作的人。这开销很大且默认关闭。
  5. 保存。

阶段4:计划

  1. 截止日期: 使用材料截止日期运行 deadlines.py。如果本周期日期已公布,则使用它并传递 --published。否则将去年同周期日期映射到今年(同月同日,仅年份加一),并将其标记为 inferred。询问用户哪些假期或休假窗口是他们的死时间,并将其作为 --dead 传递。记录“X 日期前稳妥,Y 日期前绝对完成”及其状态和阶段。如果状态为 past,则直接说明并给出下一个周期。
  2. 每个未完成行的下一步行动: 对于每个非 done 的行,写入 next_step:能够为证据增加分量的最便宜的单一具体行动,并根据你发现的关于公司的情况进行调整(例如“在招聘频道输入 /interview”、“在合作伙伴仪表板上提供一次结对编程会议”、“向你的经理要求共同负责路线图的一部分”)。看板会列出三个最大的差距及这些步骤,因此确保每个步骤在一周内可完成,而非一个长期目标。
  3. 材料准备就绪度: 运行 python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date> 以获取每个评分标准行的证据计数(标记了该行的日志条目加上该行本身的证据),然后根据每部分依赖的行,将模板的每个部分标记为 strong、thin 或 empty。
  4. 同行反馈选择: 从 recognition.py summary 中,最常认可用户的人员以及认可的原因,是书面陈述中同行反馈的首选候选人(3到5人);将他们添加到同行反馈笔记中。
  5. 经理问题: 所有仍然未知的事项,加上准备就绪度问题(例如“<周期>是否现实,还缺少什么?”)。
  6. 运行 map_schema.py check。修复任何错误,然后保存。
  7. 向用户显示简短摘要:目标、两个对话日期、尚未展示的高级行为(按标签)、谁还需要看到他们的工作,以及他们需要问经理的问题。提示用户查看 promotion-map.md。

4. 刷新

  1. 运行 map_schema.py check,并读取 career/flags.json(如果存在)(其他技能会在其中写入过期信号,例如重组、离职或日历公布)。当认可工具已设置时,通过运行 python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> 刷新认可记录(使用“写入”工具应用其对 career/recognition.json 的写入计划;此操作需要网络)。
  2. 仅重新研究过期或标记的章节。保持所有其他章节不变。
  3. 询问用户“有什么变化吗?”,涵盖目标、经理、团队以及见过他们工作的人员。
  4. 如果日历章节被重新检查,或者有标志表示日历已公布,则重新运行 deadlines.py 并更新 calendar.manager_conversation。
  5. 当某行的证据发生变动时(如果步骤已完成或不再是性价比最高的行动,则替换掉),刷新每个未完成行的 next_step,并补充任何缺失的 label。
  6. 更新每个重新检查章节的 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)

当材料截止日期临近,或用户要求时:

  1. 加载路线图;如果没有,则先进行首次运行。收集自上次晋升(或入职日期)以来的证据:对于不超过一个月的时间窗口,使用 /flagrare:brag-doc;对于更长的窗口,使用 /flagrare:impact-timeline。
  2. 使用公司的模板起草材料,模板来自 process.packet_template(如果模板未知,则使用此常见结构并说明为备用方案:标题部分,然后是 2-3 个项目(角色、估算……

……

[原文因在 estimate 后截断,后续内容丢失。翻译基于现有完整内容已完成。]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能