职位说明书生成器

要解决的问题

写一份职位说明书看起来简单，实际很耗时。HR 或用人经理要么对着空白 Word 表格一个个格子填，要么从旧文档里复制再改，格式很容易跑偏。更麻烦的是职责描述和任职要求：没人能马上写出既专业又符合行业惯例的条目。job-description-generator 把这件事拆成「收集信息 → 构造 JSON → 渲染 docx」三段，让模板结构不再是人工维护的负担。

工作原理

核心能力

• 解析岗位需求：识别用户口语化描述中的关键约束，而不是要求一次性给出完整字段。
• 生成结构化职位数据：按固定 JSON schema 输出，字段含义参考 references/jd_fields.md。
• 填充模板并输出 docx：调用 scripts/generate_jd.py，把 JSON 填进 assets/JX006职位说明书空白表.docx 并落盘为可下载文件。

关键步骤

1. 收集岗位信息。必填只有两项：岗位名称 和 所属部门。建议收集的字段包括人员编制、岗位类别、直接上级与下级、内外部协作关系、主要职责及对应绩效标准、任职要求（性别、年龄、学历、专业、经验、证书、知识、技能等），以及选填的附属信息。用户只给一个岗位名称时，智能体按行业通用标准补全其余内容；用户给出的信息始终作为硬约束。
2. 构造 JSON 数据。字段规范见 references/jd_fields.md，结构确认后再进入渲染。
3. 调用脚本生成 docx。--data 接受文件路径或 JSON 字符串，--output 指定输出路径，--template 可选，默认走内置模板。脚本返回 JSON 格式的执行结果，包含可下载的文档路径。

适用边界与注意点

主要职责最多 9 条，超出部分会被脚本截断，批量场景要先和需求方对齐取舍。协作关系支持内外多条，展示时以换行分隔。审批签字区域（部室负责人、审核、复核、批准）刻意留空，需要人工签署，不要试图让脚本生成签名。

批量生成多个岗位时，每个岗位单独调用一次脚本，避免输出文件命名冲突。若用户已有企业模板，可通过 --template 传入自定义 docx，但表格结构必须与内置模板保持一致，否则填充会错位。环境依赖 python-docx==1.1.2，首次运行需确认该版本可用。

这类生成结果适合作为初稿再由业务方审校，尤其是职责颗粒度和任职要求中的年限、证书等条件，最终解释权归用人部门。