hr-compensation-analysis

name	hr-compensation-analysis
description	从用户提供的脱敏薪酬表、薪酬带宽、岗位职级映射和有出处的市场数据中，生成可复核的薪酬结构分析包。用户提到薪酬结构分析、薪酬带宽、compa-ratio、薪酬区间位置、调薪分析、薪酬异常核查、市场对标或薪酬数据整理时使用。适用于本地文件、表格、邮件、消息和 HR 材料；飞书、HRIS 或薪酬数据服务属于可选只读输入源。保留数据最小化、来源时效、群体分析和人工定薪边界。

薪酬结构分析

把脱敏薪酬材料转成团队可复核的结构分析包：清楚展示薪酬带宽、区间位置、数据缺口与需要人工核查的事项。

价值与适用场景

适合这些工作：

• 年度调薪、晋升或预算讨论前，盘点人员与薪酬带宽的位置。
• 清理本地薪酬表，核对岗位、职级、地点与带宽是否映射完整。
• 用 compa-ratio 和 range penetration 识别带宽外、数据缺失或需要复核的记录。
• 汇总 HR 已提供且注明来源日期的市场对标数据，不把不同口径混成一个结论。
• 把管理者口述、本地消息、邮件、表格和 HR 材料整理为一致的薪酬讨论底稿。
• 对群体指标做初步描述，明确可比群、样本量和待解释因素。

本 Skill 交付分析与复核材料。定薪、调薪、晋升、预算、法律判断和向个人沟通薪酬，由有权限的人类负责人依组织规则完成。

标准工作流

1. 收窄目的和口径

明确分析目的、货币、周期、薪酬组成和可比范围。基础薪资、奖金、股权、津贴和福利不能在未说明口径时直接相加。没有完整带宽时，先输出数据缺口，不反推“合理薪资”。

2. 最小化整理材料

优先读取用户当前消息和本地材料。人员记录只保留匿名 person_ref、岗位族群、职级、地点、带宽、基础薪资和必要的已解释业务因素；姓名、联系方式、受保护属性、家庭、健康、薪酬历史、原始聊天和完整绩效材料不进入生成器。

每份材料记录来源标签、用途、日期和状态。无法确认的岗位映射、币种、周期或带宽，标记为待核，不用推测补齐。详细格式见 references/input-schema.md 与 references/material-intake.md。

3. 计算结构位置

对带宽完整的记录计算：

• compa-ratio = 基础薪资 ÷ 带宽中点
• range penetration = (基础薪资 − 带宽下限) ÷ (带宽上限 − 带宽下限)
• 带宽位置：低于、区间内或高于

这三项是定位信息，不等于个人表现、留任风险、市场竞争力或应调金额。

4. 建立待复核队列

把问题分开呈现：带宽映射缺失、币种或周期不一致、带宽外、市场来源过期、样本过小、同可比群差异需要业务解释。群体差异只进入人工调查清单，不能直接贴“公平”或“不公平”标签。

5. 保留人工决策点

报告要把数据事实、已知业务解释、尚未验证内容和可执行的复核动作分开。Agent 可整理、计算、汇总和提示；人类负责人确认规则、解释差异并承担最终薪酬决定。

材料来源与可选系统适配

本 Skill 可完全离线运行。常见输入是脱敏 JSON、CSV 或由 HR 整理的本地表格、文档、邮件与消息。不同 Agent 的文件读取能力不同；无法解析的文件先请用户提供可读文本或结构化导出。

飞书可选适配

只有用户明确要求读取飞书资料时，才检查身份并最小范围只读：

lark-cli auth status --json --verify
lark-cli sheets +cells-get --url "https://example.feishu.cn/sheets/shtXXXX" \
  --sheet-name "脱敏薪酬带宽" --range "A1:Z200" --include value,formula --as user --json

支持 auth status --json --verify 的环境必须确认 identity=user、verified=true。当前 CLI 构建若没有 auth 子命令，可退回 contact +get-user --as user 或 task +get-my-tasks --as user 做只读兼容探测。读取顺序和字段边界见 references/feishu-cli.md。不默认写回表格、不发送薪酬消息、不修改 HRIS 或审批记录；任何外部写入都需要用户单独确认并在写后读回验证。

输出要求

输出一份薪酬结构分析包：

1. 分析目的、统计口径、材料来源和时效。
2. 薪酬带宽与岗位职级映射检查。
3. 逐条匿名记录的 compa-ratio、range penetration 和位置标签。
4. 按带宽汇总的样本量、平均值、中位数与带宽外数量。
5. 市场数据的来源、日期、口径和可比性提示（仅限用户提供数据）。
6. 待复核队列、数据缺口和需由人确认的决定点。

使用 scripts/build_comp_analysis.py 生成本地 Markdown 或 JSON 报告；输入结构见 references/input-schema.md。

必须停止的情况

• 用户要求直接给某个人定薪、调薪金额、晋升结论或裁员建议。
• 输入包含姓名、联系方式、受保护属性、家庭、健康、薪酬历史或其他无关个人信息。
• 缺少货币、薪酬周期、带宽边界或岗位映射，且用户希望把结果当作确定结论。
• 需要读取或写入外部系统，但身份、租户或授权范围无法确认。
• 用户要求把未经解释的群体差异直接作为歧视、违法或个人问题的结论。

停止时说明具体缺口，并给出继续所需的最小材料。

参考文件

• AGENT-GUIDE.md：适用于所有 Agent 的输入、权限、输出和停止规则。
• references/material-intake.md：本地材料与脱敏台账的整理方法。
• references/input-schema.md：薪酬带宽、匿名人员记录和市场基准的输入结构。
• references/metrics-and-review.md：指标定义、可比性和人工复核规则。
• references/feishu-cli.md：飞书作为可选输入源时的最小读取流程。
• references/safety-boundaries.md：隐私、群体分析、市场数据和人类决定边界。
• scripts/build_comp_analysis.py：本地结构分析生成与校验脚本。
• UPSTREAM.md：上游来源、公开先例、差异与许可证说明。