@bolloon/bolloon-agent 0.4.5 → 0.4.6

package/dist/agents/skill-organizer.js

@@ -143,25 +143,25 @@ export async function scanLeftoverSkills(opts = {}) {
 // ───────────────────────── B. 经验进化 (LLM 完整总结) ─────────────────────────
 /** 把候选的工具调用记录扩写成完整经验 — LLM prompt (结构化 JSON 输出) */
 export function buildEvolvePrompt(c) {
-    return `你是经验总结专家。下面是 Bolloon 智能体在一轮运行中连续成功调用的工具记录 (已运行 ${c.runs || 1} 次)。
-
-工具记录:
-名称: ${c.name}
-描述: ${c.description}
-原始记录:
-${String(c.body || '').slice(0, 4000)}
-
-请把这份"工具调用记录"扩写成一份完整的、可复用的经验文档, 要求:
-1. name: 一个简短的小写英文名 (字母数字连字符, 概括这套操作)
-2. description: 一句话描述 (什么场景用)
-3. body: 完整经验正文, 按以下结构:
-   ## 背景 — 这套操作在什么场景下用, 解决什么问题
-   ## 触发条件 — 什么信号/需求出现时应该使用
-   ## 流程 — 具体步骤 (保留原始工具名), 每步说明目的
-   ## 注意事项 — 易错点 / 边界情况 / 已知坑
-   ## 验证 — 怎么确认结果正确
-
-只输出一个 JSON 对象, 不要任何其他文字:
+    return `你是经验总结专家。下面是 Bolloon 智能体在一轮运行中连续成功调用的工具记录 (已运行 ${c.runs || 1} 次)。
+
+工具记录:
+名称: ${c.name}
+描述: ${c.description}
+原始记录:
+${String(c.body || '').slice(0, 4000)}
+
+请把这份"工具调用记录"扩写成一份完整的、可复用的经验文档, 要求:
+1. name: 一个简短的小写英文名 (字母数字连字符, 概括这套操作)
+2. description: 一句话描述 (什么场景用)
+3. body: 完整经验正文, 按以下结构:
+   ## 背景 — 这套操作在什么场景下用, 解决什么问题
+   ## 触发条件 — 什么信号/需求出现时应该使用
+   ## 流程 — 具体步骤 (保留原始工具名), 每步说明目的
+   ## 注意事项 — 易错点 / 边界情况 / 已知坑
+   ## 验证 — 怎么确认结果正确
+
+只输出一个 JSON 对象, 不要任何其他文字:
 {"name": "...", "description": "...", "body": "..."}`;
 }
 /** 解析 LLM 返回的 JSON (容错: 剥 markdown 代码块, 取第一个 {...}) */

package/dist/agents/skill-writer.js

@@ -266,9 +266,21 @@ export async function writeRunEndSkillCandidates(steps, source, minOk = 2) {
         return { wrote: false, reason: `成功工具不足 (${okSteps.length} < ${minOk})` };
     }
     const toolNames = okSteps.map((s) => s.name).slice(0, 5).join(', ');
-    const body = `## 背景\n本轮对话连续成功调用了 ${okSteps.length} 个工具: ${toolNames}.\n\n` +
-        `## 流程\n${okSteps.map((s) => `1. 调用 ${s.name}${s.output ? ': ' + String(s.output).slice(0, 120) : ''}`).join('\n')}\n\n` +
-        `## 注意事项\n- 工具名以 list_skills / get_operation_logs 的实际注册名为准\n- 沉淀为正式 skill 前请人工确认流程可复用\n`;
+    // 2026-08-12 (Task5): 让 run-end 候选 body 更可复用 — 结构化呈现调用链 + 每步作用 + 适用场景.
+    const stepLines = okSteps.map((s, i) => {
+        const out = s.output ? String(s.output).replace(/\s+/g, ' ').slice(0, 140) : '';
+        return `${i + 1}. **${s.name}**${out ? ` — ${out}` : ''}`;
+    }).join('\n');
+    const body = `## 适用场景\n用户请求需要连续执行工具序列: ${toolNames}.\n\n` +
+        `## 调用链\n${stepLines}\n\n` +
+        `## 流程要点\n${okSteps.map((s, i) => {
+            // 2026-08-12 (Task5 优化): 用真实输出提炼每步作用, 避免千篇一律的"调用 X 获取下一步输入".
+            const out = s.output ? String(s.output).replace(/\s+/g, ' ').trim() : '';
+            const clue = out && out.length > 30 ? out.slice(0, 60) + '…' : (out || '完成');
+            return `- 第 ${i + 1} 步 ${s.name}: ${clue}`;
+        }).join('\n')}\n\n` +
+        `## 如何验证\n- 涉及改代码: 跑 tsc + vitest 确认无错; 涉及写文件: read_file 读回校验.\n` +
+        `- 沉淀为正式 skill 前请人工确认流程可复用, 再 list_skill_candidates / promote_skill 转正\n`;
     // 2026-08-08: 稳定签名 + 固定文件名 → 同一套工具反复跑时合并更新到同一个候选 (runs++)
     const signature = toolSignature(okSteps);
     const candName = `auto-${signature}`;

package/dist/agents/workflow-pivot-loop.js

@@ -193,6 +193,16 @@ export class WorkflowPivotLoop {
      *   传原生 tools + tool_choice auto → LLM 返回结构化 tool_calls.
      */
     buildOpenAITools() {
+        // 2026-08-12 (Task3 认知卸载): 核心编码工具加强 description, 提升模型触发率.
+        const USAGE_HINT = {
+            write_file: '写/创建文件用此工具 (改代码首选). ',
+            edit_file: '修改文件指定内容用此工具 (改代码首选). ',
+            read_file: '读取文件内容用此工具. ',
+            read_directory: '列目录用此工具. ',
+            list_files: '列出文件用此工具. ',
+            terminal: '跑 shell 命令/脚本/装依赖/查状态用此工具 (不要用它写文件). ',
+            delegate_to_engine: '任务过大或复杂时委派给外部编码引擎 (认知卸载). ',
+        };
         const out = [];
         for (const [name, tool] of this.tools) {
             const params = tool.parameters || {};
@@ -207,7 +217,7 @@ export class WorkflowPivotLoop {
                 type: 'function',
                 function: {
                     name,
-                    description: tool.description || name,
+                    description: (USAGE_HINT[name] || '') + (tool.description || name),
                     parameters: { type: 'object', properties, required },
                 },
             });
@@ -866,8 +876,8 @@ export class WorkflowPivotLoop {
         //   完整重装只在 iter=1 和 compact 之后两次
         const lines = fullSystemPrompt.split('\n');
         const identityLine = lines.find((l) => l.includes('你是') && !l.includes('(续)')) ?? '';
-        return `[continuation] 你的 persona + tools + judgments 已在首轮 messageHistory 中.
-${identityLine ? identityLine + '\n' : ''}当前 step 别再读 persona 全文, 继续推进任务即可.
+        return `[continuation] 你的 persona + tools + judgments 已在首轮 messageHistory 中.
+${identityLine ? identityLine + '\n' : ''}当前 step 别再读 persona 全文, 继续推进任务即可.
 > <final gen> 只在真完成时输出.`;
     }
     /**

package/dist/bollharness/src/scripts/deploy-guard.js

@@ -104,17 +104,17 @@ function checkRsync(cmd) {
 function block(reason, host = null) {
     let guidance;
     if (host === PROD_IP) {
-        guidance = `请使用标准部署流程：
-  后端: bash scripts/deploy.sh --yes
-  Demo 正式: bash scripts/deploy-demo.sh <name> --channel prod --yes
-  Demo 内测: bash scripts/deploy-demo.sh <name> --channel preview --yes
-  Edge/Nginx: bash scripts/deploy-edge.sh --yes
+        guidance = `请使用标准部署流程：
+  后端: bash scripts/deploy.sh --yes
+  Demo 正式: bash scripts/deploy-demo.sh <name> --channel prod --yes
+  Demo 内测: bash scripts/deploy-demo.sh <name> --channel preview --yes
+  Edge/Nginx: bash scripts/deploy-edge.sh --yes
 详见 Bolloon.md Development Commands。`;
     }
     else if (BRIDGE_VPS_HOSTS.includes(host ?? "")) {
-        guidance = `Bridge VPS 必须走 git pull 更新路径：
-  ssh root@${host} 'sudo -u boll git -C /opt/boll pull --ff-only'
-  scp/rsync 直传会重新制造 orphan worktree。
+        guidance = `Bridge VPS 必须走 git pull 更新路径：
+  ssh root@${host} 'sudo -u boll git -C /opt/boll pull --ff-only'
+  scp/rsync 直传会重新制造 orphan worktree。
   详见 docs/issues/guard-20260408-0445-bridge-vps-orphan-worktree.md。`;
     }
     else {

package/dist/bollharness-integration/context-router-judgment.js

@@ -253,9 +253,9 @@ export async function generateJudgmentInjection(filePath, gate, options = {}) {
     const header = gate === 3
         ? '# Plan Freeze - Decision Principles'
         : `# Gate ${gate} - Active Judgments`;
-    return `${header}
-# Path: ${filePath}
-# Confidence: ${(result.confidence * 100).toFixed(0)}%
-
+    return `${header}
+# Path: ${filePath}
+# Confidence: ${(result.confidence * 100).toFixed(0)}%
+
 ${result.contextYaml}`;
 }