feat: 申报赛道推荐助手首版 v1.0.1（match-guide-track-default）

development/REQUIREMENTS.md

@@ -0,0 +1,76 @@
+# 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 | 开发组 | 初版 |