Skill: sirutong/admin-skills (version 1.0.0)

--- name: hr-admin-assistant description: | 人力行政总监智能助理。适用于科技公司后方（HR/行政/法务/财务支持）业务场景。 当用户提出以下类型需求时，应使用此 skill： - 提出后方业务需求、想法、流程改进诉求 - 起草或生成文件（规章制度、通知、合同、HR文书、审批表单、工作报告、OKR/KPI） - 分析和整理现有文档 - 梳理或设计业务流程（招聘、入职、离职、绩效、报销、采购、行政审批） - 制定人力资源政策或管理制度 - 整理会议纪要、周报、汇报材料 - 需要了解公司后方部门需求、业务逻辑和常见操作规范 触发词：人事规定、HR文件、入职、离职、绩效、薪酬、考勤、招聘、制度、行政管理、 公司规章、员工手册、审批流程、报销流程、采购申请、办公室管理、劳动合同、 生成通知、起草方案、需求分析、流程设计、文档模板、制度建设、OKR、KPI、 部门规划、人员编制、组织架构、后方业务、帮我写、帮我起草、写一个、做一个方案 --- # HR & 行政助理 Skill ## 定位与目标 本 skill 服务于科技公司人力行政总监（CHRO/行政总监）角色，覆盖以下六大职能域： 1. **人力资源管理** — 招聘、入职/离职、绩效、薪酬、员工关系 2. **行政管理** — 办公室、固定资产、供应商、差旅、采购 3. **制度建设** — 公司规章、政策制定、流程规范 4. **文档与报告** — 制度文件、通知、汇报材料、会议纪要 5. **组织发展** — 组织架构、人员编制、岗位设计 6. **合规与法务支持** — 劳动合同、用工合规、隐私数据保护 --- ## 核心工作流（SOP） ### Phase 0：需求理解（必须执行） 接收到任何后方业务请求时，首先执行需求解析： 1. **识别业务域** — 判断属于哪个职能域（见上方6大域） 2. **识别交付物类型** — 是「文档」「流程图」「制度」「表单」「方案」还是「分析」？ 3. **补全关键信息** — 若信息不足，优先询问： - 适用对象（全员/特定部门/管理层） - 公司规模与阶段（100人以下/100-500人/500+） - 是否已有现行版本需要优化 - 期望格式（Word文档/表格/流程说明） 4. **确认理解** — 用1-2句话复述需求，确认无误后再执行 > 原则：不在信息不足时盲目生成，宁可多问一步，也要确保交付物切实可用。 --- ### Phase 1：文档生成工作流 适用场景：生成制度文件、通知、合同模板、审批表单、HR文书等。 **执行步骤：** 1. 读取 `references/doc_templates.md` 了解各类文档的标准结构 2. 读取 `references/hr_policies.md` 了解常见制度条款与合规要点 3. 按照文档类型选择对应模板框架 4. 结合用户提供的具体信息填充内容 5. 输出正式文档，包含：标题、发布日期、适用范围、正文、附件（如需） **文档质量标准：** - 语言正式、准确，避免模糊表述 - 关键条款需有可操作的细则 - 涉及数字（工作日、金额、比例）须明确 - 对涉及员工权益的内容，标注「建议法律审查」 --- ### Phase 2：流程设计工作流 适用场景：梳理或设计业务流程（招聘、入职/离职、报销、审批等）。 **执行步骤：** 1. 读取 `references/process_library.md` 了解标准流程节点与最佳实践 2. 明确流程的：触发条件 → 参与角色 → 关键节点 → 审批层级 → 输出结果 3. 以文字形式描述完整流程（节点 + 负责人 + 预计时效 + 所需材料） 4. 可选：生成 Markdown 格式的流程表格，便于后续制作流程图 5. 指出流程中的潜在风险点和改进建议 **流程设计原则：** - 最少审批层级：非必要不超过3级 - 明确每个节点的完成标准和时间要求 - 考虑例外情况的处理路径 --- ### Phase 3：需求分析工作流 适用场景：用户提出模糊想法或改进诉求，需要结构化梳理成可执行方案。 **执行步骤：** 1. 用「5W1H」框架拆解需求：What / Why / Who / When / Where / How 2. 识别核心痛点和期望目标 3. 评估可行性（资源、时间、复杂度） 4. 输出结构化「需求分析报告」，包含： - 背景与现状 - 核心问题定义 - 解决方案选项（至少2个） - 推荐方案及理由 - 实施路径与里程碑 - 风险与应对策略 --- ### Phase 4：报告与汇报材料工作流 适用场景：周报、月报、述职报告、高管汇报材料。 **执行步骤：** 1. 确认汇报对象（CEO/董事会/平级部门）和汇报风格偏好 2. 选用 `references/report_templates.md` 中对应的报告框架 3. 按「结论先行」原则组织内容（金字塔结构） 4. 关键数据使用表格呈现 5. 每个模块控制在150字以内，便于高管快速阅读 --- ## 输出规范 | 交付物类型 | 格式要求 | 示例 | |-----------|---------|------| | 制度文件 | Markdown 正式格式，含版本号和生效日期 | 员工手册、考勤制度 | | 流程说明 | 步骤列表 + 角色分工表 | 入职流程、报销流程 | | 审批表单 | 表格格式，含填写说明 | 采购申请表、费用报销单 | | 分析报告 | 结构化报告，含摘要和建议 | 需求分析报告 | | 通知公告 | 简洁正文，明确主题/对象/时间 | 放假通知、政策变更通知 | | 会议纪要 | 标准纪要格式（时间/参会人/议题/决议/行动项） | 周会纪要 | --- ## 业务知识快速参考 详细制度条款和流程参见 `references/` 目录： - `references/hr_policies.md` — 常见HR制度要点与法律合规基线 - `references/process_library.md` — 标准流程库（20+ 核心流程） - `references/doc_templates.md` — 文档模板结构指南 - `references/report_templates.md` — 报告模板框架 --- ## 迭代与扩展说明 本 skill 设计为可持续迭代的架构： - **添加新场景**：在 `references/process_library.md` 中追加新流程模板 - **添加公司特定制度**：在 `references/hr_policies.md` 末尾追加公司个性化内容 - **添加文档模板**：在 `assets/` 目录中放置 Word/Excel 模板文件 - **添加脚本自动化**：在 `scripts/` 目录中添加 Python 脚本（如批量生成合同、自动填表） 每次使用后，如发现业务场景未被覆盖，应将新的触发词追加到 SKILL.md 的 description 触发词列表中。

path: assets/example_asset.txt
content: 此目录用于存放 HR/行政业务相关的资产文件，例如：
- Word/Excel 文档模板（.docx/.xlsx）
- 公司 Logo（用于生成带抬头的文件）
- 标准报销单扫描件
- 其他复用性文件素材

当前暂无资产文件，按需添加。


path: scripts/generate_doc.py
content: #!/usr/bin/env python3
"""
generate_doc.py — HR 文档生成脚本

功能：根据文档类型和参数，生成标准格式的 HR/行政文档（Markdown格式）
用法：
  python3 generate_doc.py --type <doc_type> --output <filename> [--params key=value ...]

支持的文档类型（--type 参数）：
  notice          全员通知
  holiday         放假通知
  meeting         会议纪要
  weekly          部门周报
  pip             绩效改进计划（PIP）
  offboarding     离职确认函
  policy          制度文件框架
  requirement     需求分析报告
"""

import argparse
import json
import os
from datetime import datetime


def get_current_date():
    return datetime.now().strftime("%Y年%m月%d日")


TEMPLATES = {
    "notice": """# 关于{subject}的通知

各部门、全体员工：

{purpose}

## 一、主要内容

{main_content}

## 二、执行要求

{requirements}

## 三、联系方式

如有疑问，请联系{contact}。

特此通知。

{department}  
{date}
""",

    "holiday": """# {holiday}放假通知

全体员工：

根据国家法定节假日安排，结合公司实际情况，现将{holiday}放假安排通知如下：

## 一、放假时间

{start_date} 至 {end_date}，共 {days} 天。

## 二、调休安排

{makeup_work}

## 三、值班安排

放假期间，{duty_dept}安排专人值班，联系方式：{duty_contact}。

## 四、温馨提示

- 请各部门在放假前做好工作交接
- {tips}

祝大家节日快乐！

{company_name} 行政部  
{date}
""",

    "meeting": """# 会议纪要

| 项目 | 内容 |
|------|------|
| 会议名称 | {meeting_name} |
| 会议时间 | {meeting_time} |
| 会议地点 | {location} |
| 主持人 | {host} |
| 参会人员 | {attendees} |
| 记录人 | {recorder} |

---

## 一、会议议题

{agenda}

---

## 二、讨论记录

{discussion}

---

## 三、行动项（Action Items）

| 编号 | 行动事项 | 责任人 | 完成时间 | 状态 |
|-----|---------|--------|---------|------|
{action_items}

---

## 四、下次会议

时间：{next_meeting}

---
*本纪要由{recorder}整理，如有异议请在24小时内反馈。*
""",

    "pip": """# 绩效改进计划（PIP）

| 项目 | 内容 |
|------|------|
| 员工姓名 | {employee_name} |
| 岗位 | {position} |
| 直属上级 | {manager} |
| 启动日期 | {start_date} |
| 改进周期 | {duration}（{start_date} 至 {end_date}） |

---

## 一、改进背景

{background}

> 注：以上内容基于具体事实，请避免主观评价。

---

## 二、改进目标

| 改进维度 | 具体指标 | 衡量标准 | 完成时间 |
|---------|---------|---------|---------|
{improvement_goals}

---

## 三、公司支持措施

{support_measures}

---

## 四、检查节点

{check_points}

---

## 五、后果说明

若PIP期结束后仍未达到改进目标，公司将依据劳动合同及相关法律规定，对岗位安排作出调整。

---

## 六、签字确认

> 员工确认（签字代表收到并了解本计划，不代表同意全部内容）

| 角色 | 姓名 | 签字 | 日期 |
|------|------|------|------|
| 员工 | {employee_name} | ________ | ________ |
| 直属上级 | {manager} | ________ | ________ |
| HR 见证 | ________ | ________ | ________ |
""",

    "requirement": """# 需求分析报告

| 项目 | 内容 |
|------|------|
| 需求名称 | {requirement_name} |
| 提出人 | {requester} |
| 分析人 | {analyst} |
| 日期 | {date} |

---

## 一、需求背景与现状

{background}

---

## 二、核心问题定义

> {problem_statement}

---

## 三、目标与预期成果

- **短期目标**（1-3个月）：{short_term_goal}
- **中期目标**（3-6个月）：{mid_term_goal}
- **成功标准**：{success_criteria}

---

## 四、方案选项

### 方案A：{option_a_name}

- 核心思路：{option_a_idea}
- 优点：{option_a_pros}
- 缺点/风险：{option_a_cons}
- 所需资源：{option_a_resources}

### 方案B：{option_b_name}

- 核心思路：{option_b_idea}
- 优点：{option_b_pros}
- 缺点/风险：{option_b_cons}
- 所需资源：{option_b_resources}

---

## 五、推荐方案

**推荐：{recommended_option}**

理由：{recommendation_reason}

---

## 六、实施路径

| 阶段 | 关键任务 | 负责人 | 时间节点 |
|------|---------|--------|---------|
{implementation_plan}

---

## 七、风险与应对

| 风险 | 发生概率 | 影响程度 | 应对策略 |
|------|---------|---------|---------|
{risks}

---

## 八、资源需求

{resources}
""",
}


def generate_document(doc_type: str, params: dict, output_file: str = None):
    """生成文档并输出"""
    if doc_type not in TEMPLATES:
        print(f"❌ 不支持的文档类型: {doc_type}")
        print(f"   支持的类型: {', '.join(TEMPLATES.keys())}")
        return False

    # 自动填充日期
    if "date" not in params:
        params["date"] = get_current_date()

    template = TEMPLATES[doc_type]
    
    try:
        # 替换模板中的占位符
        doc_content = template.format_map(params)
    except KeyError as e:
        # 若参数不足，标记缺失字段
        missing_key = str(e).strip("'")
        print(f"⚠️  缺少参数: {missing_key}，使用占位符替代")
        params[missing_key] = f"[请填写：{missing_key}]"
        doc_content = template.format_map(params)

    if output_file:
        with open(output_file, "w", encoding="utf-8") as f:
            f.write(doc_content)
        print(f"✅ 文档已生成：{output_file}")
    else:
        print(doc_content)

    return True


def main():
    parser = argparse.ArgumentParser(
        description="HR 文档生成工具",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog=__doc__
    )
    parser.add_argument("--type", required=True, help="文档类型")
    parser.add_argument("--output", help="输出文件路径（不填则打印到控制台）")
    parser.add_argument("--params", nargs="*", help="文档参数，格式：key=value")
    parser.add_argument("--list", action="store_true", help="列出所有支持的文档类型")

    args = parser.parse_args()

    if args.list:
        print("支持的文档类型：")
        for t in TEMPLATES.keys():
            print(f"  - {t}")
        return

    # 解析参数
    params = {}
    if args.params:
        for param in args.params:
            if "=" in param:
                key, value = param.split("=", 1)
                params[key.strip()] = value.strip()

    generate_document(args.type, params, args.output)


if __name__ == "__main__":
    main()


path: scripts/example.py
content: #!/usr/bin/env python3
"""
batch_contract.py — 批量合同/文件生成辅助脚本（占位，待按需实现）

未来可扩展为：
  - 批量生成劳动合同（从 Excel 员工名单读取）
  - 批量生成薪资确认函
  - 批量生成绩效通知书

使用方式（待实现）：
  python3 batch_contract.py --template contract --input employees.xlsx --output ./output/
"""

print("batch_contract.py: 此脚本为预留占位，待按需开发批量文档生成功能")
print("当前可用脚本：")
print("  - generate_doc.py    单文档生成")
print("  - analyze_requirement.py  需求解析")


path: references/api_reference.md
content: # HR Admin Assistant — API Reference

本文件保留作备用参考。当前 skill 不依赖外部 API，所有业务逻辑基于本地参考文档实现。

## 未来扩展参考

若后续需要对接外部系统（如钉钉、飞书、HRIS 系统），可在此文件记录 API 接口规范：

```
接口名称：
接口地址：
认证方式：
请求参数：
返回字段说明：
```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)