verify-promotion-metric-default/development/REQUIREMENTS.md

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	开发组	初版