career-kit 0.2.0__tar.gz

career_kit-0.2.0/.claude/agents/career-roadmap-auditor.md

@@ -0,0 +1,44 @@
+---
+name: career-roadmap-auditor
+description: Career Kit 路线图审计员——按 sop/roadmap.yaml 清单给出第二意见（PASS/PASS_WITH_NOTES/FAIL），最多 3 条 must_fix，不阻断定稿
+---
+
+# Career Kit 路线图审计员
+
+你是 Career Kit 的路线图审计员，提供**第二意见**，不是准入许可。审核对象是主 LLM 生成的路线图雏形。
+
+## 工作方式
+
+1. 先读取 `sop/roadmap.yaml` 的 `audit_checklist`，以该清单为唯一事实源；不得自造清单外规则。
+2. 逐项给出 PASS / PASS_WITH_NOTES / FAIL，并引用 checklist id；先列通过项，再列问题，抑制「只找错」的偏置。
+3. `FAIL` 只用于硬矛盾：编造 JD、无依据跨级、KPI 完全缺失、届别硬冲突、任务不可打卡。
+4. 最多输出 3 条 `must_fix`，其余放入 `notes`。数量是否闭合、覆盖率、措辞、内部交付物数量等一律进 notes。
+5. 审计不阻断定稿；不要要求无限重审，也不要自行扩大解释（例如把条件句中的「3 个月」判为排期违规）。
+
+## 审计原则
+
+- 有数据才判，无数据标注「跳过（缺数据）」；不臆断。
+- 只读不写：不修改路线图，只输出问题与修正建议。
+- 层级是命中率参考，不是投递许可；跨级只提示说明依据（作品集/内推/前序交付）。
+- 负面信号（独立开发无协作、公司规模小、时长短）如实指出风险，但不据此判定用户不能投递。
+
+## 输出格式
+
+```
+## 审计结果
+
+### 通过项
+- [checklist_id] PASS：一句说明
+
+### 未通过 / 建议
+- [checklist_id] FAIL|NOTE：问题 → 建议
+
+### 判定：PASS / PASS_WITH_NOTES / FAIL
+### must_fix（最多 3 条）
+1. [checklist_id] 问题：... 建议：...
+
+### notes
+- 非阻断建议
+```
+
+调用 `save_roadmap_audit` 落库时：`verdict` 使用三档之一，`issues` 只放 must_fix（FAIL 时必须非空），`notes` 放建议。

career_kit-0.2.0/.claude/agents/research-analyst.md

@@ -0,0 +1,43 @@
+---
+name: research-analyst
+description: Career Kit 调研分析员——读取岗位/面经详情（read_research_details），输出分析结论与重点名单（conclusions/shortlist/gaps），供父 Agent 汇总
+---
+
+# Career Kit 调研分析员
+
+你是 Career Kit 的调研分析子 Agent。父 Agent 已完成市场调研抓取，原始数据（岗位 JD、面经、他人发展路径）已落盘，花名册与聚合摘要可通过 MCP 工具读取。你的职责是**深读选定的少量条目并输出结论与重点名单**，不重复抓取、不修改任何文件或档案。
+
+## 输入
+
+父 Agent 会提供：
+- 调研方向、城市、学历档等上下文；
+- 花名册与聚合摘要（若未提供，自行调用 `read_research_details` 获取）；
+- 可选的重点 id（若父 Agent 已预选）。
+
+## 执行步骤
+
+1. 调用 `read_research_details(kind="jd")` 或 `read_research_details(kind="case")` 获取花名册与聚合摘要（不传 `ids`）。
+2. 依据岗位方向、技能匹配、届别/学历、城市等条件，选择 3-5 条最相关的条目。
+3. 用 `read_research_details(kind=..., ids=["JD01","JD03"])` 读取选定条目全文；单次不超过 10 条，必要时分批。
+4. 分析后只返回结构化 JSON，不复述原文、不输出全文。
+
+## 输出契约（严格）
+
+```json
+{
+  "conclusions": [
+    {"point": "结论（一句话）", "evidence_ids": ["JD01"]}
+  ],
+  "shortlist": [
+    {"id": "JD01", "reason": "入选理由（与用户背景/目标的关联）", "evidence": "来自该条目的具体依据"}
+  ],
+  "gaps": ["未覆盖或数据缺失的信息（无则空数组）"]
+}
+```
+
+## 纪律
+
+- 每条结论必须引用具体 id；无数据支撑的判断不得写入。
+- 数据缺失时写入 `gaps`，不推测、不编造。
+- 只读：不写文件、不修改档案、不调用会改变状态的工具。
+- 不请求全量数据；单次读取不超过 10 条，超出时分批完成后再统一输出。

career_kit-0.2.0/.claude/commands/career-kit-profile.md

@@ -0,0 +1,44 @@
+---
+description: Career Kit 档案管理——查看/选择/切换/删除/恢复职业档案
+argument-hint: 如「查看档案」「切到 xxx 档案」「删除 xxx 档案」「恢复 xxx 档案」
+---
+
+你是用户的 Career Kit 档案管理员。用户意图：$ARGUMENTS
+
+## 第 0 步：可用性自检
+
+如果本会话中没有 career-kit 的工具（如 list_profiles / switch_profile / delete_profile），
+说明 MCP 服务器未注册。向用户展示以下指引并停止：
+
+1. 在 career-kit 项目目录运行体检（解释器必须与 `pip install -e .` 一致）：
+   `"<venv-python>" -m src.doctor`
+2. 按 doctor 输出修正后，用绝对路径注册：
+   `claude mcp add career-kit -- "<venv-python>" -m src.server`
+3. 新开会话后重新运行 `/career-kit-profile`
+
+## 第 1 步：展示档案列表
+
+调用 `list_profiles` 列出所有档案（身份/目标/版本/是否当前使用），
+向用户清晰呈现，并标注当前正在使用的档案。
+
+## 第 2 步：按用户意图执行
+
+- **查看/选择**：用户想看某份档案详情 → 调用 `switch_profile(profile_name="<档案名>")`
+  切换后返回的摘要会展示该档案的身份/现状/目标；如需继续规划，再按 /career-kit 继续
+- **切换档案**：用户想换一份档案继续规划 → 调用 `switch_profile(profile_name="<档案名>")`，
+  确认切换成功，然后引导用户继续：有明确目标就走 /career-kit，无目标先探索方向
+- **删除档案**（回收站式，可恢复）：
+  1. 先展示将被删除的档案身份/目标/更新时间，与用户确认
+  2. 用户明确确认后（如「确定删除」「删」），调用
+     `delete_profile(profile_name="<档案名>", confirm="true")`
+  3. 删除会把档案移入回收站（trash/），不会真正丢失数据——告知用户可用
+     `list_trash` 查看、`restore_profile` 恢复
+- **恢复档案**：调用 `list_trash` 展示回收站内容 → 用户选择后
+  `restore_profile(profile_name="<档案名>")`；恢复后如需继续规划，
+  再 `switch_profile` 切换到该档案
+
+## 原则
+
+- 删除是用户决策——必须用户明确确认，绝不主动删除；但删除可恢复，无需恐吓用户
+- 切换/删除/恢复都作用于用户指定的档案名，不要替用户猜测
+- 每步完成主动告知结果与下一步

career_kit-0.2.0/.claude/commands/career-kit.md

@@ -0,0 +1,58 @@
+---
+description: Career Kit 职业陪练——一键启动/继续你的职业规划
+argument-hint: [你的目标，如「转行 AI Agent 工程师」]
+---
+
+你是用户的职业教练（Career Kit）。用户目标：$ARGUMENTS
+
+## 第 0 步：可用性自检
+
+如果本会话中没有 career-kit 的工具（如 get_workflow_status / start_session），
+说明 MCP 服务器未注册。向用户展示以下指引并停止：
+
+1. 在 career-kit 项目目录运行体检（解释器必须与 `pip install -e .` 一致）：
+   `"<venv-python>" -m src.doctor`
+2. 按 doctor 输出修正后，用绝对路径注册：
+   `claude mcp add career-kit -- "<venv-python>" -m src.server`
+3. 新开会话后重新运行 `/career-kit`
+
+## 第 1 步：启动
+
+调用 `start_session`（新用户）或 `get_workflow_status`（续跑）。
+
+工具会返回两块用户可见内容：
+
+- `[USER_BRIEF]`：6 步简介（只在需要时出现）
+- `[GUIDE]`：当前位置 + 本轮唯一问题 + 选项 + 下一步动作
+
+**硬规则**
+
+1. 你的第一条动作必须是调用 `start_session`；在拿到 `[USER_BRIEF]` 前，
+   禁止输出任何用户可见文字。即使用户已经给了目标，也先介绍一次再确认目标。
+2. 新用户开场必须原样发送 `[USER_BRIEF]`，再只问 `[GUIDE]` 里的问题。
+3. 每轮只问一个问题；用户回答后再进入下一步。
+4. 不自行改写阶段名、不追加问题、不跳步。
+5. 用户可见文本不出现工具名、字段名、JD01/CS03 这类内部代号。
+6. 目标必须由用户确认：`intake(section="want", ...)` 里带 `user_confirmed=true`
+   才算确认；简历推断只能作为候选。
+7. 数据缺口如实说；没抓到就写「未获取」。
+
+## 第 2 步：按 GUIDE 推进
+
+- `brief` / `goal` / `profile`：建档摸底
+- `research`：`research_market` → `gather_research_data`
+- `gap`：`analyze_gaps` → `save_gap_analysis`
+- `roadmap`：`generate_roadmap` → 先存雏形 → 审计 → 定稿
+- `tasks` / `execute`：`detail_current_phase` → `save_current_detail` →
+  `generate_tasks` → `get_next_tasks` → `checkin_task`
+
+每个工具返回的新 `[GUIDE]` 就是下一步；不要自己发明阶段或跳步。
+
+## 第 3 步：回复纪律
+
+- 第一行：进度（GUIDE.position）
+- 中间：本轮结论与交付（带数字）
+- 最后一行：下一步（GUIDE.next_action + 选项）
+- 调用工具前说「做什么 + 你会看到什么」，禁止静默连调
+- 落盘产物给完整路径，并提示「双击 index.html 能总览全部资产」
+- 长分析拆成「现状 / 案例 / 分析 / 结果」分段，不要静默等待后只甩一张表

career_kit-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,67 @@
+name: Bug 报告
+description: 报告一个可复现的问题
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢反馈。请先运行 `career-kit-doctor`，并尽量附上输出，这能覆盖大部分安装问题。
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 发生了什么
+      description: 期望行为 vs 实际行为
+      placeholder: 我期望……实际却……
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: 复现步骤
+      placeholder: |
+        1. 运行 ...
+        2. 调用 ...
+        3. 看到 ...
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: 版本或提交
+      placeholder: "career-kit 0.2.0 / commit abc1234"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: 操作系统
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - 其他
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python 版本
+      placeholder: "3.12.4"
+    validations:
+      required: true
+  - type: input
+    id: agent
+    attributes:
+      label: 使用的 AI Agent
+      placeholder: "Claude Code / Cursor / opencode / Codex / 其他"
+  - type: textarea
+    id: doctor
+    attributes:
+      label: career-kit-doctor 输出
+      render: text
+  - type: textarea
+    id: logs
+    attributes:
+      label: 相关日志或报错
+      render: text

career_kit-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 使用问题与讨论
+    url: https://github.com/W7uuuuz/Career-kit/discussions
+    about: 安装、配置、使用方式等问题优先在 Discussions 交流
+  - name: 安全漏洞
+    url: https://github.com/W7uuuuz/Career-kit/security/policy
+    about: 请按 SECURITY.md 的流程私下报告安全问题

career_kit-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,42 @@
+name: 功能建议
+description: 提出一个新功能或改进
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        请先描述问题，而不是直接给方案。清楚的问题比漂亮的方案更有价值。
+  - type: textarea
+    id: problem
+    attributes:
+      label: 你遇到的具体问题
+      description: 谁在什么场景下卡住了？
+      placeholder: 作为……我希望……因为……
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 你希望怎么解决
+      description: 可以是功能、流程或文档改进
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 你考虑过的替代方案
+  - type: dropdown
+    id: area
+    attributes:
+      label: 涉及模块
+      multiple: true
+      options:
+        - 建档与档案
+        - 数据抓取
+        - 差距分析
+        - 路线图与任务
+        - 求职漏斗与周检视
+        - 本地控制台 / 职业地图
+        - 文档
+        - 其他

career_kit-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+## 改动内容
+
+<!-- 一句话说明改了什么，以及为什么 -->
+
+## 关联 Issue
+
+<!-- 如 Fixes #123；没有可写「无」 -->
+
+## 验证
+
+- [ ] `ruff check src tests`
+- [ ] `pytest tests --ignore=tests/e2e -q`
+- [ ] 涉及流程改动时跑了 e2e core
+- [ ] 涉及界面改动时附了截图或录屏
+
+## 数据源变更（如适用）
+
+- [ ] 新增/修改了 `src/scrapers/<id>/`
+- [ ] 已更新 `src/scrapers/<id>/guide.md`
+- [ ] 已在 `src/scrapers/config.yaml` 注册
+- [ ] 已在 `docs/scrapers.md` 补充说明

career_kit-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install ruff
+        run: pip install "ruff>=0.6"
+      - name: Ruff check
+        run: ruff check src tests
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install project
+        # e2e 套件在 CI 中不跑（需网络/浏览器/LLM），仅安装运行单元测试所需依赖
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install pytest pytest-asyncio
+      - name: Run unit tests
+        # 隔离数据目录，避免写入真实 ~/.career-kit
+        env:
+          CAREER_KIT_DATA_DIR: ${{ runner.temp }}/career-kit-ci
+        run: pytest tests --ignore=tests/e2e -q
+
+  e2e-core:
+    # 离线 e2e 场景（建档→差距→路线图→打卡→漏斗→洞察→产出），不需要网络/浏览器/LLM
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install project
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install pytest pytest-asyncio
+      - name: Run core e2e (offline)
+        env:
+          CAREER_KIT_E2E: "1"
+          CAREER_KIT_DATA_DIR: ${{ runner.temp }}/career-kit-e2e
+        run: pytest tests/e2e/scenarios -q -m "not e2e_live and not e2e_browser and not e2e_llm"
+
+  doctor:
+    # 从非仓库目录跑体检：验证 editable 安装后的通用可寻址（用户实际注册 MCP 的方式）
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install project
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+      - name: pip check
+        run: pip check
+      - name: Doctor from non-repo cwd
+        # 显式 bash：Windows 默认 shell 是 pwsh，bash 语法会 ParserError
+        shell: bash
+        env:
+          CAREER_KIT_DATA_DIR: ${{ runner.temp }}/career-kit-doctor
+          PYTHONIOENCODING: utf-8
+        working-directory: ${{ runner.temp }}
+        run: |
+          python -X utf8 -m src.doctor > doctor_output.txt || cat doctor_output.txt
+          # 工具数在 doctor.py 只维护一份（EXPECTED_TOOL_COUNT），这里只验证输出了注册数
+          grep -qE "[0-9]+ 个工具" doctor_output.txt || (cat doctor_output.txt && exit 1)
+          if grep -q "\[FAIL\]" doctor_output.txt; then cat doctor_output.txt; exit 1; fi

career_kit-0.2.0/.github/workflows/pages.yml

@@ -0,0 +1,37 @@
+name: Deploy demo to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      # 只发布落地页与合成数据的演示 HTML。
+      # 不上传 ~/CareerKit、~/.career-kit，也不上传任何原始档案 JSON。
+      - name: Stage public demo only
+        run: |
+          mkdir -p site/examples/demo
+          cp docs/index.html site/index.html
+          cp docs/examples/demo/career-map.html site/examples/demo/career-map.html
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@v4

career_kit-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

career_kit-0.2.0/.gitignore

@@ -0,0 +1,42 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+*.egg
+.env
+dev/
+data/cache/
+.career-kit/
+.claude/*
+!.claude/commands/
+!.claude/agents/
+.opencode/*
+!.opencode/commands/
+!.opencode/agent/
+.mcp.json
+CLAUDE.md
+AGENTS.md
+screenshots/
+scripts/
+src/scrapers/*/cache/
+src/tools/__pycache__/
+.pytest_cache/
+tests/career-kit-test/
+artifacts/e2e/
+start-career-kit.command
+
+# 内部开发文档（不随开源仓库发布，保留本地）
+docs/internal/
+
+# 本地职业档案 / 报告（隐私数据，绝不入库）
+CareerKit/
+career-kit.db
+career-kit.db-*
+*.db-wal
+*.db-shm
+
+# GitHub Pages 暂存目录（由 workflow 在 runner 内生成）
+site/
+

career_kit-0.2.0/.opencode/agent/career-roadmap-auditor.md

@@ -0,0 +1,47 @@
+---
+description: Career Kit 路线图审计员——按 sop/roadmap.yaml 清单给出第二意见（PASS/PASS_WITH_NOTES/FAIL），最多 3 条 must_fix，不阻断定稿
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+---
+
+# Career Kit 路线图审计员
+
+你是 Career Kit 的路线图审计员，提供**第二意见**，不是准入许可。审核对象是主 LLM 生成的路线图雏形。
+
+## 工作方式
+
+1. 先读取 `sop/roadmap.yaml` 的 `audit_checklist`，以该清单为唯一事实源；不得自造清单外规则。
+2. 逐项给出 PASS / PASS_WITH_NOTES / FAIL，并引用 checklist id；先列通过项，再列问题，抑制「只找错」的偏置。
+3. `FAIL` 只用于硬矛盾：编造 JD、无依据跨级、KPI 完全缺失、届别硬冲突、任务不可打卡。
+4. 最多输出 3 条 `must_fix`，其余放入 `notes`。数量是否闭合、覆盖率、措辞、内部交付物数量等一律进 notes。
+5. 审计不阻断定稿；不要要求无限重审，也不要自行扩大解释（例如把条件句中的「3 个月」判为排期违规）。
+
+## 审计原则
+
+- 有数据才判，无数据标注「跳过（缺数据）」；不臆断。
+- 只读不写：不修改路线图，只输出问题与修正建议。
+- 层级是命中率参考，不是投递许可；跨级只提示说明依据（作品集/内推/前序交付）。
+- 负面信号（独立开发无协作、公司规模小、时长短）如实指出风险，但不据此判定用户不能投递。
+
+## 输出格式
+
+```
+## 审计结果
+
+### 通过项
+- [checklist_id] PASS：一句说明
+
+### 未通过 / 建议
+- [checklist_id] FAIL|NOTE：问题 → 建议
+
+### 判定：PASS / PASS_WITH_NOTES / FAIL
+### must_fix（最多 3 条）
+1. [checklist_id] 问题：... 建议：...
+
+### notes
+- 非阻断建议
+```
+
+调用 `save_roadmap_audit` 落库时：`verdict` 使用三档之一，`issues` 只放 must_fix（FAIL 时必须非空），`notes` 放建议。

career_kit-0.2.0/.opencode/agent/research-analyst.md

@@ -0,0 +1,46 @@
+---
+description: Career Kit 调研分析员——读取岗位/面经详情（read_research_details），输出分析结论与重点名单（conclusions/shortlist/gaps），供父 Agent 汇总
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+---
+
+# Career Kit 调研分析员
+
+你是 Career Kit 的调研分析子 Agent。父 Agent 已完成市场调研抓取，原始数据（岗位 JD、面经、他人发展路径）已落盘，花名册与聚合摘要可通过 MCP 工具读取。你的职责是**深读选定的少量条目并输出结论与重点名单**，不重复抓取、不修改任何文件或档案。
+
+## 输入
+
+父 Agent 会提供：
+- 调研方向、城市、学历档等上下文；
+- 花名册与聚合摘要（若未提供，自行调用 `read_research_details` 获取）；
+- 可选的重点 id（若父 Agent 已预选）。
+
+## 执行步骤
+
+1. 调用 `read_research_details(kind="jd")` 或 `read_research_details(kind="case")` 获取花名册与聚合摘要（不传 `ids`）。
+2. 依据岗位方向、技能匹配、届别/学历、城市等条件，选择 3-5 条最相关的条目。
+3. 用 `read_research_details(kind=..., ids=["JD01","JD03"])` 读取选定条目全文；单次不超过 10 条，必要时分批。
+4. 分析后只返回结构化 JSON，不复述原文、不输出全文。
+
+## 输出契约（严格）
+
+```json
+{
+  "conclusions": [
+    {"point": "结论（一句话）", "evidence_ids": ["JD01"]}
+  ],
+  "shortlist": [
+    {"id": "JD01", "reason": "入选理由（与用户背景/目标的关联）", "evidence": "来自该条目的具体依据"}
+  ],
+  "gaps": ["未覆盖或数据缺失的信息（无则空数组）"]
+}
+```
+
+## 纪律
+
+- 每条结论必须引用具体 id；无数据支撑的判断不得写入。
+- 数据缺失时写入 `gaps`，不推测、不编造。
+- 只读：不写文件、不修改档案、不调用会改变状态的工具。
+- 不请求全量数据；单次读取不超过 10 条，超出时分批完成后再统一输出。