alert-contract-expiring-hr/SKILL.md

name, description, version, author, metadata, allowed-tools

name	description	version	author	metadata	allowed-tools
合同到期智能预警与续聘辅助	每日凌晨扫描全校教职工合同电子台账，对距离到期日 90/60/30 天的合同分级预警，并自动生成《续聘准备任务书》和《本月合同到期人员清单》。	1.0.1	深圳匠厂科技有限公司	openclaw slug platform_kit_min_version emoji category developer_ids alert-contract-expiring-hr 1.2.11 📋 人事 12345 12468	bash

合同到期智能预警与续聘辅助（alert-contract-expiring-hr）

这是基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。覆盖需求规格书第 4.2 节「🟡 人事处 Skill 002 —— 合同到期"智能预警与续聘辅助"」。

Agent / 宿主编排（复制为业务技能后必改）

AI + RPA 定位

• Agent 是入口与编排者：理解用户意图（"扫描本月即将到期的合同"、"给张三生成续聘任务书"）、补齐参数、判断风险、选择 Action，并用业务语言解释结果。
• 本技能不涉及浏览器 / 桌面 / 手机 RPA：合同台账读取走人事系统官方 API，考核数据走党委教师工作部 API。
• 开发者与 AI 编程工具先读 development/AI_RPA.md。

架构铁律（先读）

• 宿主产品入口平级：对话任务 / 数据管理 / 定时任务是同一技能能力的不同触发场景，同等重要；本技能重点挂定时任务入口（每日凌晨扫描）。
• 单业务内核、多入口：数据管理 / 定时任务 / Agent / 技能详情 / 直接 CLI 必须复用同一 domain service；禁止按入口复制业务逻辑。
• 业务行生命周期：本技能对合同台账表的每一份合同有"可预警 / 预警中 / 已续聘 / 已驳回"角色约束，遵守 references/WORK_ITEM_STATUS.md。
• HTML 整页报告：本技能输出个人版《续聘准备任务书》走 render-html；单位版清单走 PDF 导出。

如何触发（能力类型）

你要做什么	Agent 怎么做	进任务中心？
健康检查 / 短查询	OpenClaw bash/exec + 共享 Python 跑 CLI	否
已声明 sync 的 Action	run_skill_action 或等效短 CLI	否
长任务（每日凌晨扫描全校 1000+ 份合同）	必须 run_skill_action	是（仅因 async）

用户意图路由表（业务技能复制后必改）

用户意图（本技能自填）	Agent 怎么做	进任务中心？
检查运行环境	短 CLI：python {baseDir}/scripts/main.py health	否
查看版本	短 CLI：python {baseDir}/scripts/main.py version	否
查看配置位置	短 CLI：python {baseDir}/scripts/main.py config-path	否
每日凌晨定时扫描合同到期	run_skill_action → scan-expiring-contracts（cron / agent）	是（async）
给某位教师生成续聘任务书	run_skill_action → generate-renewal-task（输入：contract_id）	否（sync）
下发单位版续聘清单	run_skill_action → dispatch-task-notice（输入：unit_id 或 month）	否（sync）
标记合同为已续签	run_skill_action → mark-contract-renewed（输入：contract_id + 续签材料 ID）	否（sync）
在浏览器中打开续聘任务书	run_skill_action → render-html	否（sync）

共享 Python（必读）

宿主共享 runtime 在 {JIANGCHANG_DATA_ROOT}/python-runtime/.venv，并已前置到 PATH（同时设 VIRTUAL_ENV）。短 CLI 一条命令直接跑：

python {baseDir}/scripts/main.py health
python {baseDir}/scripts/main.py version
python {baseDir}/scripts/main.py config-path
python {baseDir}/scripts/main.py init-db

• 公共库来自共享 venv 的 jiangchang-platform-kit>=1.2.11（包名路径 jiangchang_skill_core）；不要 vendor scripts/jiangchang_skill_core/。
• 根目录 requirements.txt 只声明技能特有依赖；不要写 jiangchang-platform-kit / playwright。
• metadata.openclaw.platform_kit_min_version 是宿主兼容声明，不是 pip 依赖。
• health 用 collect_runtime_diagnostics 做只读诊断。

配置：仓库 .env.example 为模板；用户 .env 在 {JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/{slug}/.env。优先级：进程环境变量 > 用户 .env > .env.example。

面向用户问答（LLM 规则）

• 本文（SKILL.md）是 LLM / OpenClaw 平台读取的技能入口，不是用户市场说明。
• 根目录市场材料面向普通用户（见下方「文档分工」），不是 Agent 调用契约。

当用户询问以下问题时，必须优先读取根目录 README.md（能力说明）与 TUTORIAL.md（逐步用法）：

• 这个技能是做什么的
• 这个技能怎么用
• 适合什么场景
• 使用前要准备什么
• 执行后会得到什么
• 能不能帮我完成某个业务任务

回答「怎么用 / 能做什么」时的要求：

1. 「能做什么 / 场景 / 概念类 FAQ」以 README.md（说明 Tab）为主；「点哪里 / 说什么 / 排障」以 TUTORIAL.md（教程 Tab）为主。
2. 禁止在回答中粘贴 python …/scripts/main.py … 或其它命令行。
3. 禁止为答用法而去 dir / ls / 列技能目录。
4. 不要向普通用户暴露 Playwright、DOM、Python、RPA、库表名、error_code 等实现细节。
5. 用户问「怎么用」时：优先读 TUTORIAL.md。

文档分工

文档	读者	用途
根目录 README.md	普通用户	市场 说明 Tab
根目录 TUTORIAL.md	普通用户	市场 教程 Tab
根目录 DEMO.md	普通用户	市场 演示 Tab
根目录 CHANGELOG.md	普通用户	市场 更新日志 Tab
SKILL.md（本文）	LLM / OpenClaw 平台	技能入口、触发与运行契约摘要
references/	Agent 编排 / 调用	CLI、Action、schema 契约
development/	开发者 / AI 编程代理	需求、开发教程、测试、深度技术规范

目录约定

• assets/、development/、evals/、references/、scripts/、tests/
• CLI 入口固定为 scripts/main.py
• 业务逻辑按 cli / db / service / util 分层

技能命名与 slug

• slug：alert-contract-expiring-hr（alert 动词 + contract-expiring 名词 + hr 人事处缩写）
• name：用户可见的中文业务名称；description 是说明，不是名称。
• 目录名、默认 {slug}.db 使用 slug，不使用中文。

平台元数据

• metadata.openclaw.developer_ids：技能发布后的默认开发者可见用户 ID 列表。
• 开发期技能常为不公开：不加本人 ID，开发者自己也无法在市场安装自测。
• 当 access_scope = 0（不公开）时，平台会把 developer_ids 中的用户自动补写到 skill_user_access。

---

本技能开发状态： v1.0.1 骨架已就位，业务实现细节见 development/REQUIREMENTS.md；具体 Python 模块由开发者后续补全。