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