前言¶
人力资源同事和对接 HR 的工程师，经常要在「制度正文、劳动合同、配套签收表」和「入职、离职、审批流程图」之间来回切换。手写 Word 容易漏章节；流程图另起炉灶又和制度文字对不上。若只靠通用写作提示词，很难稳定产出符合中国劳动法语境的 DOCX，也缺少大纲确认、占位符检查和合规审查这类门禁。
下面介绍 SkillHub 上的社区 Skill HR文档官（@user_8965db71/hr-doc-officer，当前版本 1.0.2）。它把文档生成和泳道图生成拆成四条工作流，在关键步骤设置 STOP 检查点，并通过调度 docx、diagram-drawing 等技能完成交付；涉及法律条款时联动 HR 合规相关技能审查，而不是一次性「生成即定稿」。
这是什么¶
HR文档官是面向人力资源文档与流程可视化的调度型 Agent Skill，发布者为 SkillHub 用户 user_8965db71，分类为 business-ops，来源为 community。SkillHub 页面标注 requires_api_key=false，安装本 Skill 本身不需要 API Key。
一句话定位：根据用户需求路由到单文档、批量表单、泳道图或文档+泳道图联合四条工作流（WF1–WF4），输出 .docx 或流程图预览用的 .html，并在交付前做结构与合规相关的 STOP 确认。
与同发布者旗下的 HR组织官 等不同，本 Skill 聚焦「文档生成 + 流程泳道图」，明确不覆盖薪酬计算、绩效方案设计、候选人评估、培训 PPT 等场景（技能内写了否定触发与应路由到的其他 HR 官 Skill）。
核心功能¶
双引擎与依赖关系¶
本 Skill 不自带可执行脚本，属于调度层：内容由本 Skill 编排结构，格式与渲染交给外部 Skill。
| 能力 | 调度方式 | 典型输出 |
|---|---|---|
| HR 专业文档 | skill(name="docx") |
.docx |
| 流程泳道图 | skill(name="diagram-drawing") |
Draw.io XML，并生成 .html 预览 |
| 法律条款审查 | skill(name="hr-legal-compliance") |
与文档定稿联动，本 Skill 不自行定义法条 |
文档类型速配表覆盖员工手册（约 10 章）、劳动合同（约 12 章）、管理制度（约 6 章）、操作指南（约 7 章）等；批量场景另有 8 类配套表单清单（劳动合同、变更协议、续订/解除通知、证明与签收类等）。
四条工作流（WF1–WF4）¶
| 工作流 | 适用场景 | 主要检查点 | 核心输出 |
|---|---|---|---|
| WF1 单文档 | 手册、制度、合同、指南等单份文档 | CP1 需求 → CP2 大纲 → CP3 交付 | .docx |
| WF2 批量表单 | 两份及以上配套表单 | CP1 范围 → CP3 交付（可合并确认） | 多份 .docx |
| WF3 泳道图 | 仅需流程可视化 | CP1 流程定义 → CP3 效果 | .html |
| WF4 联合 | 文档与对应流程图一起交付 | CP1 需求 → CP2 匹配 → CP3 交付 | .docx + .html |
WF1 支持 Create（从零生成）与 Template-Apply（用户提供 .docx 模板填充）两条路径，由 docx 技能内部调度。WF4 默认先走 WF1 生成文档，再从文档中提取决策节点、操作步骤与产出物，再执行 WF3 生成泳道图；若图文不一致，以文档为准调整流程图。
三个 STOP 检查点¶
技能在需求、大纲/草稿、交付前设置 CP1 / CP2 / CP3，用于阻断结构不完整或未经审查的定稿：
- CP1（需求录入后）：确认文档类型、公司参数、时间范围等是否齐全。
- CP2（大纲或草稿后）：必需章节覆盖率不低于约 80%、关键条款方向无矛盾、结构层级不超过 3 级（部分单页表单可跳过 CP2）。
- CP3（交付前）：占位符清零、法律条款经合规审查、
audit验证通过。
质量红线还包括：涉及劳动者权益的条款必须联动合规 Skill；员工手册、管理制度、劳动合同的章节数量有下限；DOCX 生成后必须做 audit，不得跳过。
跨技能联动¶
除 hr-legal-compliance 外，技能内还列出与招聘、绩效、运营编排、内训等 HR 官 Skill 的协作关系——专业内容由对应 Skill 定义，本 Skill 负责文档结构与格式交付。三种及以上文档类型组合时，文档建议经 hr-operations-team 编排。
降级与边界¶
当 docx 或 diagram-drawing 不可用、dotnet 环境缺失、节点过多或预览失败时，技能定义了降级链（例如输出 Markdown、Mermaid 文本，或先交付文档再处理泳道图）。这些路径在正式环境中应视为兜底，生产使用仍建议预先安装依赖 Skill。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 官方安装说明执行完整安装或仅安装 CLI（见 SkillHub 安装与优先源配置）。
安装 HR文档官 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被 IDE 识别：
skillhub install @user_8965db71/hr-doc-officer --dir <你的 Agent skills 目录>
常见客户端 skills 目录（以 SkillHub 文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给支持 Skill 安装的 AI，让其按官方说明完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_8965db71/hr-doc-officer。
安装完成后，按你所用客户端要求刷新或重启 Agent，使新 Skill 进入可用列表。
运行前依赖¶
要稳定得到 DOCX 与泳道图，环境中还需能调度 docx、diagram-drawing，以及涉及法条时的 hr-legal-compliance 等 Skill。本仓库内的 test-prompts.json 与 SKILL 正文均假设这些技能已注册在 available_skills 中。
泳道图本地预览可使用：
python -m http.server 8765
浏览器访问 http://localhost:8765/{filename}.html（端口冲突时技能内建议尝试其他端口）。
典型用法¶
以下示例来自技能包附带的 test-prompts.json，可在安装本 Skill 及依赖后直接向 Agent 发起同类请求。
单份员工手册（WF1）
帮我生成一份员工手册，包含考勤、休假、行为规范
预期行为：生成覆盖考勤、休假、行为规范等章节的合规员工手册 DOCX，并在流程中联动 HR 合规官审查相关条款。
招聘流程泳道图（WF3）
画一个招聘流程泳道图，涉及HR/用人部门/总监三级审批
预期行为：输出 Draw.io 格式的招聘泳道图，体现 HR、用人部门、总监等角色与审批流转。
模板与法条冲突（合规边界）
用户要求修改已有的劳动合同模板，但模板内容与最新劳动法冲突
预期行为：触发合规审查相关检查点，标注冲突条款并提示法律风险，而不是直接按冲突内容定稿。
WF1 向 docx 技能传参时，技能内约定需包含文档类型、标题、公司参数、章节结构、各章大纲与输出路径等字段，例如输出文件名形态为 {文档类型}_{公司名}_{YYYYMMDD}.docx。
适用场景与注意¶
适合谁
- HR、法务协作岗位：需要员工手册、制度、劳动合同及配套表单的标准化初稿。
- 信息化 / 行政对接人：需要与制度配套的入职、招聘、审批类泳道图，或 WF4 式「文档 + 流程图」成套交付。
- 已在 Cursor、Claude Code、Codex 等环境使用 SkillHub 的团队：希望用固定工作流和 STOP 点约束生成质量。
使用上需要注意
- 本 Skill 是调度型能力，不替代
docx、diagram-drawing、合规类 Skill；缺依赖时会走降级输出，正式制度仍建议人工终审。 - SkillHub 抓取信息显示评分 100000、下载 861 次（页面数据会更新，以 SkillHub 为准）；社区来源意味着更新与维护节奏取决于发布者。
- 技能明确拒绝纯数值计算（如经济补偿金演算）、绩效方案设计、人才评估、PPT 课件等需求，应改用对应 HR 官 Skill。
- 法律条款定稿前必须完成合规联动；技能禁止跳过
audit或交付仍含{{xxx}}占位符的文档。
结尾¶
HR文档官把「写什么、按什么结构写、何时让人确认、何时交给合规与 audit」写进四条工作流和三个 STOP 检查点，把 DOCX 与泳道图生成收敛到可重复的 Agent 流程。若你正在 SkillHub 上查找人力资源文档类能力，可从官方页面与坐标入手：
- SkillHub 页面：https://www.skillhub.cn/skills/user_8965db71/hr-doc-officer
- 安装坐标：
@user_8965db71/hr-doc-officer - API 资源标识：https://api.skillhub.cn/user_8965db71/hr-doc-officer
经过上面的步骤完成安装并补齐 docx、diagram-drawing 等依赖后，即可用自然语言按 WF1–WF4 触发对应交付路径。
