match-guide-track-default/development/REQUIREMENTS.md

REQUIREMENTS —— 申报赛道推荐助手（match-guide-track-default）

需求来源：《核心建设内容：各部门"Skill"深度需求规格书》§4.1 科研处 Skill 001（申报指南"智能赛道推荐"）。 详细设计见工作区《科研处Skill001-申报赛道智能推荐-开发文档.md》。 定位原则：辅助非决策、审慎非激进 —— 推荐可解释、可追溯，申报决策权在教师本人。

0. 技能标识

• slug：match-guide-track-default（match ∈ 动词白名单；scope 型；4 段 24 字符）
• 中文 name：申报赛道推荐助手
• account-manager platform_key：不适用；网页 RPA 登录策略：not_needed
• 命名形态：标准型+scope

0.1 宿主入口定位

主能力（Action id / CLI）	对话	数据管理	定时	教程章节	不挂理由
match-teachers（match，sync）	挂	toolbar（bind teacher_profiles，表单）	不挂	入口一/入口二	匹配由人发起；批量走 input
match-batch-input（async）	挂	不挂	不挂	入口二	指南发布后集中跑；未接指南源
add-teacher	不挂	toolbar（teacher_profiles，表单）	不挂	入口一	结构化录入
add-track	不挂	toolbar（guide_tracks，表单）	不挂	入口一	结构化录入
import-teachers / import-tracks	挂	不挂	不挂	入口二	批量 JSON 走对话
list-teachers / list-tracks	挂	仅展示表	不挂	入口二	日常在数据管理看
list-reports / stats	挂	不挂	不挂	入口二	查询类
render-html	挂	toolbar（bind match_reports）+ skill-detail	不挂	入口一/入口二	建议书重建
health / version / config-path	不挂	不挂	不挂	N/A	运维诊断

整技能无 cron placement：指南每年发布、教师对象须人指定；TUTORIAL.md 入口三已写明。

0.2 AI + RPA 协作与授权边界

• 本技能无 RPA；不连接科研管理系统；画像/赛道数据由用户录入或导入。
• 指南 PDF → 结构化赛道由 Agent 阅读后录入；BERT 语义向量匹配列为扩展。
• 禁止路线（全技能适用）：破解/逆向/私有协议/验证码绕过等，本技能不涉及。

0.3 业务行生命周期

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

1~3. 目标与背景

教师选题平均 2 周、盲目申报淘汰率高；按画像与赛道做可解释匹配，输出 Top 3 与分层建议，决策时间 2 周 → 1 天。

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

• health / version / init-db / config-path（run 为模板演示占位）
• add-teacher / import-teachers / list-teachers；add-track / import-tracks / list-tracks
• match（主命令）/ match-batch-input（async）/ list-reports / show-report / render-html / stats
• 业务表 3 张 + 展示元数据；assets/actions.json 按上表声明

可后续扩展：语义向量匹配、科研系统直连、指南 PDF 自动拆解、PDF 建议书、历年申报结果反哺。

5~6. 非功能与输入输出

• 目录/版本/UTF-8/日志规范同系列；单文件 < 900 行；测试离线确定性
• 输入：画像（teacherName/title/researchTags/sciQ1Count…）、赛道（year/trackName/trackTags/minTitle/minSciQ1…）
• 输出：JSON（ok/batch_no/season/count/tier_counts/brief_file/reports_brief）；ERROR:TEACHER_NOT_FOUND|TRACK_EMPTY|PROFILE_INCOMPLETE|TEACHER_INVALID|TRACK_INVALID|REPORT_NOT_FOUND|QUERY_FAILED|ENTITLEMENT_DENIED
• 落库：match_reports；文件：html/report-{id}.html、html/brief-{batch}.html

7~8. 依赖与范围外

无兄弟技能/外部系统依赖；requirements.txt 为空。不做：代填申报书、语义大模型匹配（本期）、评审决定。

9. 验收标准

• slug/版本三处一致（1.0.1）；套件全绿；金标准覆盖 H1/H2/S1~S3/T1/T2/E1 正反例与 Top3 截断
• 三场景真实跑通：强推荐（≥80%）、可尝试（50~80%）、硬门槛剔除；批量汇总页生成
• actions.json 与定位表、TUTORIAL 一致；developer_ids=79017；发布链路 success；宿主多入口验收

10~11. 注意事项与变更记录

• 保留模板演示 cmd_run（POLICY-RPA-003）；业务命令不使用录屏；修改规范同步 POLICY_MATRIX

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