@reconcrap/boss-recommend-mcp 2.1.21 → 2.1.23

package/skills/boss-recommend-pipeline/SKILL.md

@@ -1,254 +1,259 @@
----
-name: "boss-recommend-pipeline"
-description: "Use when users want Boss recommend-page filtering/screening via boss-recommend-mcp. Gather required params, show one consolidated review, then run or schedule through the recommend MCP tools."
----
-
-# Boss Recommend Pipeline Skill
-
-## Goal
-
-当用户要在 Boss 推荐页筛人时，必须走 MCP 工具 `run_recommend`（短别名）或 `start_recommend_pipeline_run`；若是稍后/cron 启动，必须走 `schedule_recommend_pipeline_run`。先补齐缺失值并读取岗位列表，然后展示一次包含岗位、筛选项、criteria、目标人数、后置动作、可选最大招呼数、休息强度和定时信息的总确认；用户确认后设置 `final_confirmed=true` 即可启动或创建定时任务。2.0 CDP-only 路径不再支持 legacy recommend -> chat 自动衔接；若用户要聊天页筛选或求简历，必须在推荐页任务完成后显式改用 `boss-chat` 工具。
-
-## Hard Rules (Must Follow)
-
-- **路由**
-  - 语义是推荐页（`recommend/推荐页/recommend page//web/chat/recommend`）时，只能走本 skill。
-  - 语义是“推荐页找人 + 结束后沟通/聊天”时，先完成 recommend run；不得配置 `follow_up.chat`，后续聊天任务必须显式交给 `boss-chat`。
-  - 只有用户**明确**说搜索页（`search/搜索页//web/chat/search`）时，才可转 `boss-recruit-pipeline`。
-  - recommend 失败时（如 `JOB_TRIGGER_NOT_FOUND/NO_RECOMMEND_IFRAME/BOSS_LOGIN_REQUIRED`）禁止降级到 recruit；先修 recommend 页面就绪/登录态。
-
-- **Trae-CN / 原生 MCP 启动强制规则**
-  - 用户完成总确认并要求“现在启动”时，优先直接调用 `boss-recommend/run_recommend` 或 `boss-recommend/start_recommend_pipeline_run`；不要为了即时启动先调用 prepare。
-  - 如果当前会话里已经成功调用过 `boss-recommend/prepare_recommend_pipeline_run`，说明 Trae-CN 已经具备原生 MCP tool call 能力；下一步必须继续调用 `boss-recommend/start_recommend_pipeline_run` 或 `boss-recommend/run_recommend`。
-  - `prepare_recommend_pipeline_run` 返回 `READY` 只代表参数校验通过，不代表已经启动；严禁再次调用 prepare 试图启动。
-  - 在 Trae-CN、Trae、Codex、Cursor、Claude Code 等普通 MCP 宿主中，严禁用 `run_command`、终端、PowerShell、`npx ... run --detached`、手写 `tools/call` JSON-RPC 或任何 CLI fallback 启动 recommend run。
-  - 用户要“现在启动”时，严禁用 `schedule_recommend_pipeline_run` 加短延迟冒充立即启动；schedule 只用于用户明确要求稍后/cron/定时。
-  - 不要说“prepare 覆盖了 MCP run 调用”。正确说法是：prepare 没有启动，下一步是原生 MCP tool call。
+---
+name: "boss-recommend-pipeline"
+description: "Use when users want Boss recommend-page filtering/screening via boss-recommend-mcp. Gather required params, show one consolidated review, then run or schedule through the recommend MCP tools."
+---
+
+# Boss Recommend Pipeline Skill
+
+## Goal
+
+当用户要在 Boss 推荐页筛人时，必须走 MCP 工具 `run_recommend`（短别名）或 `start_recommend_pipeline_run`；若是稍后/cron 启动，必须走 `schedule_recommend_pipeline_run`。先补齐缺失值并读取岗位列表，然后展示一次包含岗位、筛选项、criteria、目标人数、后置动作、可选最大招呼数、休息强度和定时信息的总确认；用户确认后设置 `final_confirmed=true` 即可启动或创建定时任务。2.0 CDP-only 路径不再支持 legacy recommend -> chat 自动衔接；若用户要聊天页筛选或求简历，必须在推荐页任务完成后显式改用 `boss-chat` 工具。
+
+## Hard Rules (Must Follow)
+
+- **路由**
+  - 语义是推荐页（`recommend/推荐页/recommend page//web/chat/recommend`）时，只能走本 skill。
+  - 语义是“推荐页找人 + 结束后沟通/聊天”时，先完成 recommend run；不得配置 `follow_up.chat`，后续聊天任务必须显式交给 `boss-chat`。
+  - 只有用户**明确**说搜索页（`search/搜索页//web/chat/search`）时，才可转 `boss-recruit-pipeline`。
+  - recommend 失败时（如 `JOB_TRIGGER_NOT_FOUND/NO_RECOMMEND_IFRAME/BOSS_LOGIN_REQUIRED`）禁止降级到 recruit；先修 recommend 页面就绪/登录态。
+
+- **Trae-CN / 原生 MCP 启动强制规则**
+  - 用户完成总确认并要求“现在启动”时，优先直接调用 `boss-recommend/run_recommend` 或 `boss-recommend/start_recommend_pipeline_run`；不要为了即时启动先调用 prepare。
+  - 如果当前会话里已经成功调用过 `boss-recommend/prepare_recommend_pipeline_run`，说明 Trae-CN 已经具备原生 MCP tool call 能力；下一步必须继续调用 `boss-recommend/start_recommend_pipeline_run` 或 `boss-recommend/run_recommend`。
+  - `prepare_recommend_pipeline_run` 返回 `READY` 只代表参数校验通过，不代表已经启动；严禁再次调用 prepare 试图启动。
+  - 在 Trae-CN、Trae、Codex、Cursor、Claude Code 等普通 MCP 宿主中，严禁用 `run_command`、终端、PowerShell、`npx ... run --detached`、手写 `tools/call` JSON-RPC 或任何 CLI fallback 启动 recommend run。
+  - 用户要“现在启动”时，严禁用 `schedule_recommend_pipeline_run` 加短延迟冒充立即启动；schedule 只用于用户明确要求稍后/cron/定时。
+  - 不要说“prepare 覆盖了 MCP run 调用”。正确说法是：prepare 没有启动，下一步是原生 MCP tool call。
 
 - **确认不可代填（强制）**
   - 禁止 agent 自行“设置合理参数”并代替用户确认。
   - 禁止在用户未明确回复前，把 `final_confirmed=true`。
   - 旧版 `*_confirmed` 字段仍兼容，但新流程不要逐项设置；把规范化后的值写入 `overrides`，总确认后只需要 `confirmation.final_confirmed=true`。
-  - 禁止在用户未明确回复前，自行填充 `page_scope/school_tag/degree/gender/recent_not_view/criteria/target_count/post_action/max_greet_count/job/rest_level`。
+  - 禁止在用户未明确回复前，自行填充 `page_scope/school_tag/degree/gender/recent_not_view/criteria/target_count/post_action/max_greet_count/job/rest_level`。两个可选新筛选项使用公开默认值：`current_city_only=false`、`activity_level=不限`，并在总确认中展示。
   - 每次 run 必须明确询问用户本次休息强度 `rest_level`：`low`（旧策略）/ `medium`（约 5 小时或 700 人累计休息 30 分钟）/ `high`（约 5 小时或 700 人累计休息 1 小时）；不得默认使用配置文件里的值替用户决定。
   - 若工具返回 `pending_questions`，只追问这些缺口；若只返回 `final_review`，不要再拆成逐字段确认。
 
 - **岗位确认时机**
   - 页面未就绪前，禁止询问 `job`。
-  - 仅当工具返回 `job_options` 后，才允许问 `job`，且必须展示全部选项。
-
-- **参数确认**
-  - `criteria` 必须是用户开放式自然语言；禁止“严格/宽松执行”等预设替代。
-  - `max_greet_count` 仅是可选的 `post_action=greet` 上限；禁止未告知用户就自动默认为 `target_count`。
-  - 正式执行前必须 `final_confirmed=true`。
-  - 真实筛选禁止传 `detail_limit: 0`；recommend 默认必须打开候选人详情/CV。只有用户明确要求“卡片-only 调试”时，才允许同时传 `detail_limit: 0` 和 `allow_card_only_screening: true`。
-
-- **Instruction 原文锁定**
-  - 首次用户需求原文锁定为 `locked_instruction_raw`。
-  - 后续所有调用复用原文，禁止改写/翻译/摘要。
-  - 最终执行前逐字回显将提交的 `instruction`；若与锁定值不一致，先修正再执行。
-  - 禁止在中途把用户意图拆成“recommend 已默认确认 + chat 单独执行”两条链路。
-
-## Single Review Confirmation
+  - 仅当工具返回 `job_options` 后，才允许问 `job`，且必须展示全部选项。
+
+- **参数确认**
+  - `criteria` 必须是用户开放式自然语言；禁止“严格/宽松执行”等预设替代。
+  - `max_greet_count` 仅是可选的 `post_action=greet` 上限；禁止未告知用户就自动默认为 `target_count`。
+  - 正式执行前必须 `final_confirmed=true`。
+  - 真实筛选禁止传 `detail_limit: 0`；recommend 默认必须打开候选人详情/CV。只有用户明确要求“卡片-only 调试”时，才允许同时传 `detail_limit: 0` 和 `allow_card_only_screening: true`。
+
+- **Instruction 原文锁定**
+  - 首次用户需求原文锁定为 `locked_instruction_raw`。
+  - 后续所有调用复用原文，禁止改写/翻译/摘要。
+  - 最终执行前逐字回显将提交的 `instruction`；若与锁定值不一致，先修正再执行。
+  - 禁止在中途把用户意图拆成“recommend 已默认确认 + chat 单独执行”两条链路。
+
+## Single Review Confirmation
 
 先收集这些值：
 
 - `page_scope`：`recommend|latest|featured`
 - `school_tag`、`degree`、`gender`、`recent_not_view`
+- `current_city_only`：`true|false`，默认 `false`；只限定期望城市等于 Boss 当前城市，不改变城市选择
+- `activity_level`：接受用户原话，并归一化到 `不限|刚刚活跃|今日活跃|3日内活跃|本周活跃|本月活跃` 中最靠近用户意图的一项；同义词、相对时间、英文和轻微错别字均可。若输入冲突、歧义或完全无法理解，使用 `不限`。最终总确认只展示归一化后的标准值。
 - `criteria`（开放文本）
 - `target_count`（可空）
 - `post_action`：`greet|none`
 - `max_greet_count`（可选，仅当 `post_action=greet`）
 - `rest_level`：`low|medium|high`
-- `job`（来自 `list_recommend_jobs` / `job_options` 的精确岗位名）
-- cron/定时任务的启动时间（如适用）
-
-然后只做一次总确认。用户回复“确认 / 全部确认 / 无需调整”后，下一次工具调用写入：
-
-```json
-{
-  "confirmation": { "final_confirmed": true }
-}
-```
-
-已确认值放在 `overrides` 和 `human_behavior.restLevel`。不要因为工具返回 `final_review` 就再问页面、学历、学校、性别、14天、criteria、目标人数、动作、最大招呼数等逐项确认。
-
-## Chat Handoff
-
-当用户要求“推荐页跑完后继续聊天页任务”时：
-
-- 本次 recommend run 只提交 recommend 参数，不要写 `follow_up.chat`。
-- recommend 完成并由用户确认要继续后，切换到 `boss-chat` skill。
-- `boss-chat` 会重新调用 `prepare_boss_chat_run` 获取聊天页岗位列表，并显式确认 `job/start_from/target_count/criteria`。
-- 不得在 recommend run 尚未完成时并行启动 `start_boss_chat_run`。
-
-## Closed vs Open Questions
-
-- 封闭式字段（除 `criteria/target_count/max_greet_count/job`）必须提供完整可选项，不让用户盲填。
-- 若工具已返回 `pending_questions[].options`，优先原样使用。
-- 若未返回，则按下列枚举展示：
+- `job`（来自 `list_recommend_jobs` / `job_options` 的精确岗位名）
+- cron/定时任务的启动时间（如适用）
+
+然后只做一次总确认。用户回复“确认 / 全部确认 / 无需调整”后，下一次工具调用写入：
+
+```json
+{
+  "confirmation": { "final_confirmed": true }
+}
+```
+
+已确认值放在 `overrides` 和 `human_behavior.restLevel`。不要因为工具返回 `final_review` 就再问页面、学历、学校、性别、14天、criteria、目标人数、动作、最大招呼数等逐项确认。
+
+## Chat Handoff
+
+当用户要求“推荐页跑完后继续聊天页任务”时：
+
+- 本次 recommend run 只提交 recommend 参数，不要写 `follow_up.chat`。
+- recommend 完成并由用户确认要继续后，切换到 `boss-chat` skill。
+- `boss-chat` 会重新调用 `prepare_boss_chat_run` 获取聊天页岗位列表，并显式确认 `job/start_from/target_count/criteria`。
+- 不得在 recommend run 尚未完成时并行启动 `start_boss_chat_run`。
+
+## Closed vs Open Questions
+
+- 封闭式字段（除 `criteria/target_count/max_greet_count/job`）必须提供完整可选项，不让用户盲填。
+- 若工具已返回 `pending_questions[].options`，优先原样使用。
+- 若未返回，则按下列枚举展示：
   - `page_scope`: `recommend/latest/featured`
   - `school_tag`: `不限/985/211/双一流院校/留学/国内外名校/公办本科`
   - `degree`: `不限/初中及以下/中专/中技/高中/大专/本科/硕士/博士`
   - `gender`: `不限/男/女`
   - `recent_not_view`: `不限/近14天没有`
+  - `current_city_only`: `false/true`
+  - `activity_level`: `不限/刚刚活跃/今日活跃/3日内活跃/本周活跃/本月活跃`
+    - 非精确输入必须选择最靠近用户意图的标准值；冲突、歧义或无法理解时使用 `不限`，不得新增选项。
   - `post_action`: `greet/none`
   - `rest_level`: `low/medium/high`
 
 ## Tool Usage
 
-Trae/Trae-CN split-server config exposes these under the `boss-recommend` MCP server. 推荐页任务应调用 `boss-recommend/<tool>`；不要切到 `boss-chat` 或 `boss-recruit`。
-
-- 岗位发现工具：`list_recommend_jobs`
-  - 用途：当用户需要为 cron / 一次性自动任务提前填写完整参数时，先用它读取推荐页岗位下拉框的全部可用岗位名；默认会复用/自动打开本机 9222 Chrome 并导航到推荐页。
-  - 输出：优先把 `job_names` 里的值作为后续 `overrides.job` / `confirmation.job_value`。
-  - 限制：只读岗位列表，不启动筛选任务；若返回 `BOSS_LOGIN_REQUIRED`，必须让用户在自动打开的 Chrome 完成登录后重试，本次 cron 不得创建。
+Trae/Trae-CN split-server config exposes these under the `boss-recommend` MCP server. 推荐页任务应调用 `boss-recommend/<tool>`；不要切到 `boss-chat` 或 `boss-recruit`。
+
+- 岗位发现工具：`list_recommend_jobs`
+  - 用途：当用户需要为 cron / 一次性自动任务提前填写完整参数时，先用它读取推荐页岗位下拉框的全部可用岗位名；默认会复用/自动打开本机 9222 Chrome 并导航到推荐页。
+  - 输出：优先把 `job_names` 里的值作为后续 `overrides.job` / `confirmation.job_value`。
+  - 限制：只读岗位列表，不启动筛选任务；若返回 `BOSS_LOGIN_REQUIRED`，必须让用户在自动打开的 Chrome 完成登录后重试，本次 cron 不得创建。
 - 主工具：`run_recommend` / `start_recommend_pipeline_run`
   - 用途：用户完成最终总确认并要“现在启动”时调用；这是即时运行的首选入口，不需要先 prepare。
   - 必填：`instruction`
   - 关键输入：
     - `confirmation`：新流程只需要 `{ "final_confirmed": true }`；旧版 `page_confirmed/page_value/.../job_confirmed/job_value` 仍兼容但不要主动制造逐项确认。
-    - `overrides`：`page_scope/school_tag/degree/gender/recent_not_view/criteria/job/target_count/post_action/max_greet_count`
+    - `overrides`：`page_scope/school_tag/degree/gender/recent_not_view/current_city_only/activity_level/criteria/job/target_count/post_action/max_greet_count`
     - `human_behavior`：必须包含本次用户确认的 `restLevel`（例如 `{ "restLevel": "medium" }`）
     - 不要传 `follow_up.chat`；该路径属于 legacy-only 行为
   - 若返回 `ACCEPTED + run_id`：记录 `run_id` 并停止本轮，不自动轮询。
   - 若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`：只追问 `pending_questions`。
 - 准备/门禁工具：`prepare_recommend_pipeline_run`
-  - 用途：只校验参数是否完整，不启动筛选任务；主要用于用户明确要求预检，或 cron/稍后/定时启动前校验。
-  - 要求：若用户要“现在启动”，返回 `status=READY` 且 `cron_ready=true` 后，下一步必须调用 MCP 工具 `run_recommend` 或 `start_recommend_pipeline_run`，禁止改用 terminal/shell/run_command/CLI/manual JSON-RPC。只有用户要“稍后/cron/定时启动”时，才继续创建定时任务。
-  - READY 响应会带 `prepared_only=true`、`run_started=false`、`recommended_next_tool=start_recommend_pipeline_run`、`alternate_next_tool=run_recommend`、`next_action.do_not_call_prepare_again=true`、`agent_guidance.native_mcp_required_after_prepare=true`；必须照这些字段继续，不得再次调用 prepare。
-  - 若返回 `NEED_INPUT` / `NEED_CONFIRMATION` / `FAILED`：继续补齐 `pending_questions` 或修复登录/页面/config；不得先创建 cron。
-- Cron 创建工具：`schedule_recommend_pipeline_run`
-  - 用途：只在用户明确要求“稍后/cron/定时启动”时保存已经 READY 的完整 payload，并启动 package-owned detached scheduler；到点后由包内 worker 直接调用 `start_recommend_pipeline_run`。
-  - 禁止：用户要“现在启动”时，不得用短延迟 schedule 作为 `run_recommend` / `start_recommend_pipeline_run` 的替代。
-  - 必填：同 `start_recommend_pipeline_run` 的完整 payload，另加 `schedule_delay_minutes` / `schedule_delay_seconds` / `schedule_run_at` 之一。
-  - 成功标准：必须返回 `status=SCHEDULED`、`schedule_created=true`、`schedule_id`、`run_at`。只有这个返回后，才可以告诉用户定时任务已创建。
-- Cron 查询工具：`get_recommend_scheduled_run`
-  - 用途：用户问“任务是否启动/进度”时，先查 `schedule_id`。若到点后已启动，会返回内层 `run_id` 和 run 快照。
-- 状态恢复工具：`list_recommend_pipeline_runs`
-  - 用途：忘记 `run_id` 或用户问“刚才那个任务怎么样”但上下文里没有 run_id 时调用；读取最近 run 摘要并返回 `latest_run`。
-  - 限制：只返回紧凑摘要，不包含大体积候选人 `results`；拿到 `latest_run.run_id` 后再用 `get_recommend_pipeline_run` / `cancel_recommend_pipeline_run`。
-  - 在 Trae-CN 中禁止用 `run_command`、PowerShell、`Get-Content`、CLI 或直接读取 `~/.boss-recommend-mcp/runs/*.json` 来恢复 run_id 或状态。
-
-最小策略：
-
-- 若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`：只追问 `pending_questions`。
-- 已确认值不重复问；仅补缺口。
-- 拿到 `ACCEPTED + run_id` 后默认停止本轮，不自动轮询。
-- 在拿到 `ACCEPTED + run_id` 之前，禁止以“我已帮你确认参数”为由越过必填确认阶段。
-
-## Cron / Scheduled Run Policy
-
-创建 cron 时必须在设置 cron 的当下完成全部交互：
-
-1. 锁定用户原始 instruction，不改写、不摘要，criteria 放入 `overrides.criteria` 时必须逐字保留。
-2. 收集全部筛选项、`target_count`、`post_action`、可选 `max_greet_count` 和本次 `rest_level`。
-3. 调用 `list_recommend_jobs`；若 Chrome 未打开，工具会尝试自动打开本机 9222 Chrome 并进入推荐页。若返回 `BOSS_LOGIN_REQUIRED` 或页面不可用，停止 cron 创建，让用户登录/修复后重试。
-4. 用 `job_names` 中的精确岗位名填入 `overrides.job`，展示包含启动时间的最终总确认；用户确认后写入 `final_confirmed=true`。
-5. 调用 `prepare_recommend_pipeline_run` 传入将来要执行的完整 payload；只有 `READY + cron_ready=true` 才能继续。
-6. 立即调用 `schedule_recommend_pipeline_run`，传入同一份完整 payload 和 `schedule_delay_minutes` / `schedule_run_at`。禁止让 OpenClaw 自己写 `/tmp/*.log` shell cron、自然语言提醒、或未来对话回调来代替此工具。
-7. 只有拿到 `SCHEDULED + schedule_id` 后才告诉用户定时任务已创建。回复必须包含 `schedule_id`，而不是只说“10 分钟后会启动”。
-8. 到点后由 package-owned detached scheduler 启动；若 Chrome/登录异常，应作为 schedule/run 失败处理，不得再向用户追问参数。
-
-Shell-only OpenClaw/QClaw cron 设置同样先运行 prepare，并显式带上用户已确认的休息强度：
-
-```powershell
-npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
-```
-
-仅当上述命令输出 `READY` 且 `cron_ready=true` 后，才允许继续创建定时任务。
-
-然后必须用 package-owned scheduler 创建定时任务，不要手写系统 cron：
-
-```powershell
-npx -y @reconcrap/boss-recommend-mcp@latest schedule-run --schedule-delay-minutes 10 --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
-```
-
-用户查询时：
-
-```powershell
-npx -y @reconcrap/boss-recommend-mcp@latest schedule-status --schedule-id <schedule_id>
-```
-
-## Async Run Policy
-
-- 用户未明确要求“持续跟进”时，不自动 `sleep + get_recommend_pipeline_run`。
-- 用户要求查进度时，再用 `get_recommend_pipeline_run`。
-- 如果当前对话已经丢失 `run_id`，先调用 `list_recommend_pipeline_runs`，再用 `latest_run.run_id` 调用 `get_recommend_pipeline_run`；不要改用终端读 JSON。
-- **长任务轮询节奏（强制）**：
-  - 推荐任务可能运行数小时，禁止高频轮询。
-  - 默认最小轮询间隔为 **30 分钟**（除非用户明确要求更频繁）。
-  - 若刚启动 run（拿到 `ACCEPTED + run_id`），不得立即进入连续轮询。
-- `pause/resume/cancel` 必须复用同一 `run_id`，不要重复 `start`。
-- **完成后衔接（强制）**：若用户手动触发 `get_recommend_pipeline_run` 且发现 recommend 已完成、而当前会话目标是“继续聊天沟通”且尚未启动 chat：切换到 `boss-chat` 并重新走 chat-only 参数确认。
-
-## Preflight and Recovery
-
-- 执行前必须通过：
-  - `screening-config.json` 可用且非占位值（`baseUrl/apiKey/model`）
-  - 工具可连接或自动启动本机 Chrome DevTools 端口（默认 `127.0.0.1:9222`）
-  - Boss 已登录；若当前没有 9222 Chrome，工具会自动打开 Chrome 并导航到 `https://www.zhipin.com/web/chat/recommend`
-  - 只有工具返回 `BOSS_LOGIN_REQUIRED` / `requires_login=true` 时，才要求用户人工登录 Boss 后重试
-
-- 不要在运行前要求用户手动打开 9222 Chrome。只有这些情况需要人工介入：
-  - 工具明确报告 `BOSS_LOGIN_REQUIRED`
-  - 本机找不到 Chrome 可执行文件，并提示设置 `BOSS_MCP_CHROME_PATH` 或 `BOSS_RECOMMEND_CHROME_PATH`
-  - 用户配置的是非本机 debug host，工具无法安全自动启动
-
-- `PIPELINE_PREFLIGHT_FAILED` 处理顺序：
-  1. 若 `screen_config` 失败：让用户提供真实 `baseUrl/apiKey/model`，并在 `guidance.config_path` 修改后明确回复“已修改完成”。
-  2. 若有 `diagnostics.auto_repair`：优先按其结果继续。
-  3. 否则使用 `diagnostics.recovery.agent_prompt`。
-  4. 若无 `agent_prompt`：按顺序修复 `node_cli -> npm_dep_*`，每步后重跑 doctor。
-
-## Featured / Latest Notes
-
-- `featured`：必须 `search -> 切换精选 tab(data-status=3) -> screen`。
-- `featured` 且缺少校准文件：先 `boss-recommend-mcp calibrate`。
-- `latest`：流程同 `recommend`，但使用最新 tab 结构（`data-status=1`）。
-
-## True Shell-Only Fallback (Never Trae-CN)
-
-本节只适用于宿主**完全没有**原生 MCP tool list、也无法调用 `boss-recommend/prepare_recommend_pipeline_run` 的 QClaw/OpenClaw 变体。
-
-只要当前会话里出现过 `boss-recommend/prepare_recommend_pipeline_run`、`boss-recommend/run_recommend`、`boss-recommend/start_recommend_pipeline_run` 这类原生 MCP 调用，本节立即失效。Trae-CN 永远不使用本节。
-
-当 QClaw/OpenClaw 变体只暴露 shell、没有原生 MCP tool list 时，才可以用 shell 继续启动。
-
-推荐做法：
-
-1. 将锁定的用户原文写入 instruction 文件，将已确认参数写入 `overrides` JSON；`confirmation` JSON 只需要 `{ "final_confirmed": true }`。
-2. 先用 `prepare-run` 校验完整 payload 已 cron-ready，并显式传 `--rest-level <low|medium|high>`；未返回 `READY + cron_ready=true` 不得创建定时任务或启动 run。
-3. 若用户要“现在启动”，用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
-
-```powershell
-npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
-```
-
-4. 若用户要“稍后/cron/定时启动”，用 `schedule-run`，不是 `run --detached`。若 `schedule-run` 未返回 `SCHEDULED + schedule_id`，不得告诉用户定时任务已创建。
-5. 若即时 `run --detached` 返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，说明设置阶段漏掉了准备门禁，应回到 `prepare-run` 补齐，不能在到点后继续问用户确认。
-
-兼容路径：
-
-- 若 `--detached` 不可用，或返回 `RECOMMEND_CLI_RUN_UNSUPPORTED_CDP_ONLY`，说明 npm/QClaw 仍在使用旧包；先运行 `npx -y @reconcrap/boss-recommend-mcp@latest install --agent qclaw` 并重启 QClaw。
-- 禁止使用 `npx @reconcrap/boss-recommend-mcp --stdio` 或 PowerShell 手写 `tools/call` JSON-RPC；该包的 MCP server 入口是 `start`，普通 MCP 宿主必须使用原生 tool call。
-
-普通 MCP 可用时：
-
-`run_recommend` / `start_recommend_pipeline_run` 仍是首选。`prepare_recommend_pipeline_run` 返回 READY 后，若用户要现在启动，必须继续调用这两个 MCP 工具之一；不要声称“prepare 覆盖了 MCP run 调用”，也不要切到 CLI detached fallback。
-
-禁止错误回退：
-
-- 不得切到 `boss-recruit-mcp` 或 `run_recruit_pipeline`。
-- 不得用 `boss-recruit-mcp doctor` 检查 recommend 流程。
-
-## Response Style
-
-- 用结构化中文。
-- 未读取岗位列表前不要要求用户最终确认。
-- 仅在 `job_options` 出现后选择精确岗位；最终确认卡片必须包含岗位和全部参数。
-- 封闭式问题必须带完整标签选项；开放式问题（如 `criteria`）保持自由输入。
-- 页面就绪失败提示必须包含 `debug_port`、recommend URL、以及登录 URL（若未登录）：
-  - `https://www.zhipin.com/web/chat/recommend`
-  - `https://www.zhipin.com/web/user/?ka=bticket`
-- 若错误是 `BOSS_LOGIN_REQUIRED`，提示用户在自动打开的 Chrome 窗口完成登录，然后原参数重试；不要改用 search/recruit 路径。
+  - 用途：只校验参数是否完整，不启动筛选任务；主要用于用户明确要求预检，或 cron/稍后/定时启动前校验。
+  - 要求：若用户要“现在启动”，返回 `status=READY` 且 `cron_ready=true` 后，下一步必须调用 MCP 工具 `run_recommend` 或 `start_recommend_pipeline_run`，禁止改用 terminal/shell/run_command/CLI/manual JSON-RPC。只有用户要“稍后/cron/定时启动”时，才继续创建定时任务。
+  - READY 响应会带 `prepared_only=true`、`run_started=false`、`recommended_next_tool=start_recommend_pipeline_run`、`alternate_next_tool=run_recommend`、`next_action.do_not_call_prepare_again=true`、`agent_guidance.native_mcp_required_after_prepare=true`；必须照这些字段继续，不得再次调用 prepare。
+  - 若返回 `NEED_INPUT` / `NEED_CONFIRMATION` / `FAILED`：继续补齐 `pending_questions` 或修复登录/页面/config；不得先创建 cron。
+- Cron 创建工具：`schedule_recommend_pipeline_run`
+  - 用途：只在用户明确要求“稍后/cron/定时启动”时保存已经 READY 的完整 payload，并启动 package-owned detached scheduler；到点后由包内 worker 直接调用 `start_recommend_pipeline_run`。
+  - 禁止：用户要“现在启动”时，不得用短延迟 schedule 作为 `run_recommend` / `start_recommend_pipeline_run` 的替代。
+  - 必填：同 `start_recommend_pipeline_run` 的完整 payload，另加 `schedule_delay_minutes` / `schedule_delay_seconds` / `schedule_run_at` 之一。
+  - 成功标准：必须返回 `status=SCHEDULED`、`schedule_created=true`、`schedule_id`、`run_at`。只有这个返回后，才可以告诉用户定时任务已创建。
+- Cron 查询工具：`get_recommend_scheduled_run`
+  - 用途：用户问“任务是否启动/进度”时，先查 `schedule_id`。若到点后已启动，会返回内层 `run_id` 和 run 快照。
+- 状态恢复工具：`list_recommend_pipeline_runs`
+  - 用途：忘记 `run_id` 或用户问“刚才那个任务怎么样”但上下文里没有 run_id 时调用；读取最近 run 摘要并返回 `latest_run`。
+  - 限制：只返回紧凑摘要，不包含大体积候选人 `results`；拿到 `latest_run.run_id` 后再用 `get_recommend_pipeline_run` / `cancel_recommend_pipeline_run`。
+  - 在 Trae-CN 中禁止用 `run_command`、PowerShell、`Get-Content`、CLI 或直接读取 `~/.boss-recommend-mcp/runs/*.json` 来恢复 run_id 或状态。
+
+最小策略：
+
+- 若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`：只追问 `pending_questions`。
+- 已确认值不重复问；仅补缺口。
+- 拿到 `ACCEPTED + run_id` 后默认停止本轮，不自动轮询。
+- 在拿到 `ACCEPTED + run_id` 之前，禁止以“我已帮你确认参数”为由越过必填确认阶段。
+
+## Cron / Scheduled Run Policy
+
+创建 cron 时必须在设置 cron 的当下完成全部交互：
+
+1. 锁定用户原始 instruction，不改写、不摘要，criteria 放入 `overrides.criteria` 时必须逐字保留。
+2. 收集全部筛选项、`target_count`、`post_action`、可选 `max_greet_count` 和本次 `rest_level`。
+3. 调用 `list_recommend_jobs`；若 Chrome 未打开，工具会尝试自动打开本机 9222 Chrome 并进入推荐页。若返回 `BOSS_LOGIN_REQUIRED` 或页面不可用，停止 cron 创建，让用户登录/修复后重试。
+4. 用 `job_names` 中的精确岗位名填入 `overrides.job`，展示包含启动时间的最终总确认；用户确认后写入 `final_confirmed=true`。
+5. 调用 `prepare_recommend_pipeline_run` 传入将来要执行的完整 payload；只有 `READY + cron_ready=true` 才能继续。
+6. 立即调用 `schedule_recommend_pipeline_run`，传入同一份完整 payload 和 `schedule_delay_minutes` / `schedule_run_at`。禁止让 OpenClaw 自己写 `/tmp/*.log` shell cron、自然语言提醒、或未来对话回调来代替此工具。
+7. 只有拿到 `SCHEDULED + schedule_id` 后才告诉用户定时任务已创建。回复必须包含 `schedule_id`，而不是只说“10 分钟后会启动”。
+8. 到点后由 package-owned detached scheduler 启动；若 Chrome/登录异常，应作为 schedule/run 失败处理，不得再向用户追问参数。
+
+Shell-only OpenClaw/QClaw cron 设置同样先运行 prepare，并显式带上用户已确认的休息强度：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
+```
+
+仅当上述命令输出 `READY` 且 `cron_ready=true` 后，才允许继续创建定时任务。
+
+然后必须用 package-owned scheduler 创建定时任务，不要手写系统 cron：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-run --schedule-delay-minutes 10 --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
+```
+
+用户查询时：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-status --schedule-id <schedule_id>
+```
+
+## Async Run Policy
+
+- 用户未明确要求“持续跟进”时，不自动 `sleep + get_recommend_pipeline_run`。
+- 用户要求查进度时，再用 `get_recommend_pipeline_run`。
+- 如果当前对话已经丢失 `run_id`，先调用 `list_recommend_pipeline_runs`，再用 `latest_run.run_id` 调用 `get_recommend_pipeline_run`；不要改用终端读 JSON。
+- **长任务轮询节奏（强制）**：
+  - 推荐任务可能运行数小时，禁止高频轮询。
+  - 默认最小轮询间隔为 **30 分钟**（除非用户明确要求更频繁）。
+  - 若刚启动 run（拿到 `ACCEPTED + run_id`），不得立即进入连续轮询。
+- `pause/resume/cancel` 必须复用同一 `run_id`，不要重复 `start`。
+- **完成后衔接（强制）**：若用户手动触发 `get_recommend_pipeline_run` 且发现 recommend 已完成、而当前会话目标是“继续聊天沟通”且尚未启动 chat：切换到 `boss-chat` 并重新走 chat-only 参数确认。
+
+## Preflight and Recovery
+
+- 执行前必须通过：
+  - `screening-config.json` 可用且非占位值（`baseUrl/apiKey/model`）
+  - 工具可连接或自动启动本机 Chrome DevTools 端口（默认 `127.0.0.1:9222`）
+  - Boss 已登录；若当前没有 9222 Chrome，工具会自动打开 Chrome 并导航到 `https://www.zhipin.com/web/chat/recommend`
+  - 只有工具返回 `BOSS_LOGIN_REQUIRED` / `requires_login=true` 时，才要求用户人工登录 Boss 后重试
+
+- 不要在运行前要求用户手动打开 9222 Chrome。只有这些情况需要人工介入：
+  - 工具明确报告 `BOSS_LOGIN_REQUIRED`
+  - 本机找不到 Chrome 可执行文件，并提示设置 `BOSS_MCP_CHROME_PATH` 或 `BOSS_RECOMMEND_CHROME_PATH`
+  - 用户配置的是非本机 debug host，工具无法安全自动启动
+
+- `PIPELINE_PREFLIGHT_FAILED` 处理顺序：
+  1. 若 `screen_config` 失败：让用户提供真实 `baseUrl/apiKey/model`，并在 `guidance.config_path` 修改后明确回复“已修改完成”。
+  2. 若有 `diagnostics.auto_repair`：优先按其结果继续。
+  3. 否则使用 `diagnostics.recovery.agent_prompt`。
+  4. 若无 `agent_prompt`：按顺序修复 `node_cli -> npm_dep_*`，每步后重跑 doctor。
+
+## Featured / Latest Notes
+
+- `featured`：必须 `search -> 切换精选 tab(data-status=3) -> screen`。
+- `featured` 且缺少校准文件：先 `boss-recommend-mcp calibrate`。
+- `latest`：流程同 `recommend`，但使用最新 tab 结构（`data-status=1`）。
+
+## True Shell-Only Fallback (Never Trae-CN)
+
+本节只适用于宿主**完全没有**原生 MCP tool list、也无法调用 `boss-recommend/prepare_recommend_pipeline_run` 的 QClaw/OpenClaw 变体。
+
+只要当前会话里出现过 `boss-recommend/prepare_recommend_pipeline_run`、`boss-recommend/run_recommend`、`boss-recommend/start_recommend_pipeline_run` 这类原生 MCP 调用，本节立即失效。Trae-CN 永远不使用本节。
+
+当 QClaw/OpenClaw 变体只暴露 shell、没有原生 MCP tool list 时，才可以用 shell 继续启动。
+
+推荐做法：
+
+1. 将锁定的用户原文写入 instruction 文件，将已确认参数写入 `overrides` JSON；`confirmation` JSON 只需要 `{ "final_confirmed": true }`。
+2. 先用 `prepare-run` 校验完整 payload 已 cron-ready，并显式传 `--rest-level <low|medium|high>`；未返回 `READY + cron_ready=true` 不得创建定时任务或启动 run。
+3. 若用户要“现在启动”，用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --rest-level <low|medium|high> --slow-live --port 9222
+```
+
+4. 若用户要“稍后/cron/定时启动”，用 `schedule-run`，不是 `run --detached`。若 `schedule-run` 未返回 `SCHEDULED + schedule_id`，不得告诉用户定时任务已创建。
+5. 若即时 `run --detached` 返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，说明设置阶段漏掉了准备门禁，应回到 `prepare-run` 补齐，不能在到点后继续问用户确认。
+
+兼容路径：
+
+- 若 `--detached` 不可用，或返回 `RECOMMEND_CLI_RUN_UNSUPPORTED_CDP_ONLY`，说明 npm/QClaw 仍在使用旧包；先运行 `npx -y @reconcrap/boss-recommend-mcp@latest install --agent qclaw` 并重启 QClaw。
+- 禁止使用 `npx @reconcrap/boss-recommend-mcp --stdio` 或 PowerShell 手写 `tools/call` JSON-RPC；该包的 MCP server 入口是 `start`，普通 MCP 宿主必须使用原生 tool call。
+
+普通 MCP 可用时：
+
+`run_recommend` / `start_recommend_pipeline_run` 仍是首选。`prepare_recommend_pipeline_run` 返回 READY 后，若用户要现在启动，必须继续调用这两个 MCP 工具之一；不要声称“prepare 覆盖了 MCP run 调用”，也不要切到 CLI detached fallback。
+
+禁止错误回退：
+
+- 不得切到 `boss-recruit-mcp` 或 `run_recruit_pipeline`。
+- 不得用 `boss-recruit-mcp doctor` 检查 recommend 流程。
+
+## Response Style
+
+- 用结构化中文。
+- 未读取岗位列表前不要要求用户最终确认。
+- 仅在 `job_options` 出现后选择精确岗位；最终确认卡片必须包含岗位和全部参数。
+- 封闭式问题必须带完整标签选项；开放式问题（如 `criteria`）保持自由输入。
+- 页面就绪失败提示必须包含 `debug_port`、recommend URL、以及登录 URL（若未登录）：
+  - `https://www.zhipin.com/web/chat/recommend`
+  - `https://www.zhipin.com/web/user/?ka=bticket`
+- 若错误是 `BOSS_LOGIN_REQUIRED`，提示用户在自动打开的 Chrome 窗口完成登录，然后原参数重试；不要改用 search/recruit 路径。

package/skills/boss-recruit-pipeline/README.md

@@ -1,19 +1,19 @@
-# boss-recruit-pipeline
-
-Bundled search/recruit-page automation skill shipped with `boss-recommend-mcp` 2.x.
-
-Package: `@reconcrap/boss-recommend-mcp` (npm)
-Source: `https://github.com/reconcrap-cpu/boss-recommend-mcp`
-
-This skill intentionally replaces legacy `boss-recruit-mcp` skill installs. It routes Boss search/recruit tasks to the unified CDP-only MCP tools:
-
-- `run_recruit_pipeline`
-- `start_recruit_pipeline_run`
-- `get_recruit_pipeline_run`
-- `pause_recruit_pipeline_run`
-- `resume_recruit_pipeline_run`
-- `cancel_recruit_pipeline_run`
-
-Do not call the old `@reconcrap/boss-recruit-mcp` package from this skill.
-
-Each run must ask the user to choose `rest_level` (`low` / `medium` / `high`) and pass the answer as `human_behavior.restLevel`; do not pick a default for the user.
+# boss-recruit-pipeline
+
+Bundled search/recruit-page automation skill shipped with `boss-recommend-mcp` 2.x.
+
+Package: `@reconcrap/boss-recommend-mcp` (npm)
+Source: `https://github.com/reconcrap-cpu/boss-recommend-mcp`
+
+This skill intentionally replaces legacy `boss-recruit-mcp` skill installs. It routes Boss search/recruit tasks to the unified CDP-only MCP tools:
+
+- `run_recruit_pipeline`
+- `start_recruit_pipeline_run`
+- `get_recruit_pipeline_run`
+- `pause_recruit_pipeline_run`
+- `resume_recruit_pipeline_run`
+- `cancel_recruit_pipeline_run`
+
+Do not call the old `@reconcrap/boss-recruit-mcp` package from this skill.
+
+Each run must ask the user to choose `rest_level` (`low` / `medium` / `high`) and pass the answer as `human_behavior.restLevel`; do not pick a default for the user.