# REQUIREMENTS —— 职称评审核验助手（verify-promotion-metric-default）

> 需求来源：《核心建设内容：各部门"Skill"深度需求规格书》§4.2 人事处 Skill 001。
> 详细设计见工作区《人事处Skill001-职称评审硬指标核验-开发文档.md》。
> 定位原则：辅助非决策、审慎非激进 —— 只输出硬指标达标矩阵，不构成评审结论。

## 0. 技能标识

- slug：`verify-promotion-metric-default`（verify ∈ 动词白名单；4 段 31 字符）
- 中文 name：职称评审核验助手
- account-manager platform_key：不适用；网页 RPA 登录策略：`not_needed`

## 0.1 宿主入口定位

| 主能力（Action id / CLI） | 对话 | 数据管理 | 定时 | 教程章节 | 不挂理由 |
|---------------------------|------|----------|------|----------|----------|
| `verify-metric`（sync） | 挂 | toolbar（bind verify_cases，表单） | 不挂 | 入口一/入口二 | 核验由人发起；批量走 input |
| `verify-batch-input`（async） | 挂 | 不挂 | 不挂 | 入口二 | 评审季集中跑；无无人值守场景 |
| `set-threshold` | 不挂 | row（threshold_rules，预填 rank+metric_key） | 不挂 | 入口一 | 人事处在表上改值更直接 |
| `import-thresholds` | 挂 | 不挂 | 不挂 | 入口二 | 批量 JSON 走对话 |
| `view-thresholds` | 挂 | 仅展示表 | 不挂 | 入口二 | 门槛日常只读 |
| `list-cases` / `stats` | 挂 | 不挂 | 不挂 | 入口二 | 查询类 |
| `render-html` | 挂 | toolbar（bind verify_cases）+ skill-detail | 不挂 | 入口一/入口二 | 报告重建 |
| `health` / `version` / `config-path` | 不挂 | 不挂 | 不挂 | N/A | 运维诊断 |

整技能无 cron placement：核验对象逐次由人指定；`TUTORIAL.md` 入口三已写明。

## 0.2 AI + RPA 协作与授权边界

- 本技能**无 RPA**；不连接人事系统；指标由用户确认后录入。
- 申报材料 → 结构化指标由 Agent 多模态阅读（LayoutLMv3 等模型解析属扩展）。

## 0.3 业务行生命周期

不适用：核验为同步计算 + 本地记录写入，无处理队列。

## 4. 功能范围（必须实现）

- 基座命令（`run` 为模板演示占位）
- `set-threshold` / `import-thresholds` / `view-thresholds`
- `verify-metric`（主命令）/ `verify-batch-input`（async）/ `list-cases` / `show-case` / `render-html` / `stats`
- 业务表 2 张 + 展示元数据 + 门槛种子（8 条）；`assets/actions.json` 按上表声明

## 6. 输入输出

- 输入：申报案例（teacherName/applyRank/presidingProvincial/corePapers/teachingHours/currentTitleYears/monographs/awards/degree）
- 输出：JSON（`ok/batch_no/case_id/verdict/summary/matrix/report_file`）；`ERROR:METRIC_INVALID|RANK_INVALID|THRESHOLD_INVALID|CASE_NOT_FOUND|QUERY_FAILED|ENTITLEMENT_DENIED`
- 落库：`verify_cases`；文件：`html/report-{id}.html`、`html/brief-{batch}.html`

## 9. 验收标准

- slug/版本三处一致（1.0.1）；套件全绿；金标准覆盖 R1~R6/V1 正反例与 10% 边界
- 三场景真实跑通：全绿安全、边缘+待核、硬伤；批量汇总页生成
- `actions.json` 与定位表、TUTORIAL 一致；`developer_ids`=79017；发布链路 success；宿主多入口验收

## 11. 变更记录

| 日期 | 版本 | 变更人 | 内容 |
|------|------|--------|------|
| 2026-09-13 | v1.0 | 开发组 | 初版 |