@reconcrap/boss-recommend-mcp 1.3.6 → 1.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/skills/boss-chat/README.md

@@ -28,4 +28,6 @@ target_count mapping:
 - Positive integer means explicit cap (for example 20).
 - `all` / `unlimited` / `全部` / `不限` / `扫到底` / `全量` means unlimited.
 - `全部候选人` / `所有候选人` must also be treated as unlimited.
+- Always write the argument key as `target_count`.
+- For unlimited mode, send `"target_count": "all"` in the tool call.
 ```

package/skills/boss-chat/SKILL.md

@@ -53,6 +53,8 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 - `job` / `start_from` / `criteria` 缺一不可；缺参时只补缺口。
 - `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
 - 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
+- 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
+- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数统一写：`"target_count": "all"`。
 - 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
 - chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
 - 允许先用空参调用 `start_boss_chat_run` 触发 `NEED_INPUT`；若返回了 `job_options`，必须完整展示所有岗位选项给用户确认。

package/src/boss-chat.js

@@ -261,6 +261,42 @@ function getMissingBossChatStartFields(input = {}) {
   return missing;
 }
 
+function buildTargetCountQuestionHint(item = {}) {
+  const next = { ...item };
+  next.question = "请输入 target_count：正整数，或 all（扫到底）。";
+  next.options = [
+    { label: "扫到底（推荐）", value: "all" },
+    { label: "不限", value: "unlimited" },
+    { label: "全部候选人", value: "全部候选人" },
+    { label: "所有候选人", value: "所有候选人" }
+  ];
+  next.examples = ["all", 20];
+  next.argument_name = "target_count";
+  return next;
+}
+
+function normalizePendingQuestions(pendingQuestions = []) {
+  return pendingQuestions.map((item) => {
+    if (String(item?.field || "") !== "target_count") return item;
+    return buildTargetCountQuestionHint(item);
+  });
+}
+
+function buildNextCallExample(input = {}, missingFields = []) {
+  if (!Array.isArray(missingFields) || missingFields.length === 0) return null;
+  const normalized = normalizeBossChatStartInput(input);
+  const sample = {};
+  if (normalized.job) sample.job = normalized.job;
+  if (normalized.startFrom) sample.start_from = normalized.startFrom;
+  if (normalized.criteria) sample.criteria = normalized.criteria;
+  if (normalized.targetCountProvided) {
+    sample.target_count = normalized.targetCountArg === "-1" ? "all" : normalized.targetCount;
+  } else if (missingFields.includes("target_count")) {
+    sample.target_count = "all";
+  }
+  return Object.keys(sample).length > 0 ? sample : null;
+}
+
 function buildBossChatCliArgs(command, input, resolvedConfig) {
   const args = [command, "--json"];
   if (command === "prepare-run") {
@@ -455,12 +491,15 @@ export async function startBossChatRun({ workspaceRoot, input = {} }) {
     const pendingQuestions = Array.isArray(prepared?.pending_questions)
       ? prepared.pending_questions.filter((item) => missingFields.includes(String(item?.field || "")))
       : [];
+    const normalizedPendingQuestions = normalizePendingQuestions(pendingQuestions);
+    const nextCallExample = buildNextCallExample(input, missingFields);
     return {
       ...prepared,
       status: "NEED_INPUT",
       required_fields: CHAT_REQUIRED_FIELDS.slice(),
       missing_fields: missingFields,
-      pending_questions: pendingQuestions,
+      pending_questions: normalizedPendingQuestions,
+      ...(nextCallExample ? { next_call_example: nextCallExample } : {}),
       message: prepared?.message
         || "已获取 Boss 聊天页岗位列表，请先补齐 job / start_from / target_count / criteria。"
     };

package/src/test-boss-chat.js

@@ -210,6 +210,11 @@ async function testBossChatAdapterShouldResolveSharedConfigAndInvokeLocalCli() {
     assert.deepEqual(preflight.required_fields, ["job", "start_from", "target_count", "criteria"]);
     assert.equal(Array.isArray(preflight.job_options), true);
     assert.equal(preflight.job_options.length, 2);
+    assert.equal(Array.isArray(preflight.pending_questions), true);
+    const preflightTargetQuestion = preflight.pending_questions.find((item) => item.field === "target_count");
+    assert.equal(Boolean(preflightTargetQuestion), true);
+    assert.equal(preflightTargetQuestion.argument_name, "target_count");
+    assert.equal(Array.isArray(preflightTargetQuestion.options), true);
 
     const stateAfterPrepare = readStubState(workspaceRoot);
     assert.equal(stateAfterPrepare.last_prepare_args.profile, "default");
@@ -301,6 +306,19 @@ async function testBossChatMcpToolsShouldValidateAndRoute() {
     assert.deepEqual(needInput.required_fields, ["job", "start_from", "target_count", "criteria"]);
     assert.equal(Array.isArray(needInput.job_options), true);
     assert.equal(needInput.job_options.length, 2);
+    const targetQuestion = needInput.pending_questions.find((item) => item.field === "target_count");
+    assert.equal(Boolean(targetQuestion), true);
+    assert.equal(targetQuestion.argument_name, "target_count");
+    assert.equal(targetQuestion.options.some((item) => item.value === "all"), true);
+
+    const missingTargetOnly = await callTool(workspaceRoot, TOOL_BOSS_CHAT_START_RUN, {
+      job: "算法工程师",
+      start_from: "all",
+      criteria: "全部候选人都过一遍"
+    }, 111);
+    assert.equal(missingTargetOnly.status, "NEED_INPUT");
+    assert.deepEqual(missingTargetOnly.missing_fields, ["target_count"]);
+    assert.equal(missingTargetOnly.next_call_example.target_count, "all");
 
     const invalidStartResponse = await handleRequest(
       makeToolCall(11, TOOL_BOSS_CHAT_START_RUN, {