mcp-probe-kit 3.0.3 → 3.0.6

package/build/schemas/git-tools.js

@@ -23,22 +23,22 @@ export const gitToolSchemas = [
     },
     {
         name: "git_work_report",
-        description: `基于 Git diff 分析生成工作报告（日报/周期报）
-
-核心功能：
-- 支持日报模式（单个日期）和周期报模式（日期范围）
-- 自动读取指定日期的所有 Git 提交
-- 对每个提交执行 git show 获取完整 diff
-- 使用 AI 分析 diff 内容提取实际工作内容
-
-输出格式：
-- 只输出「工作内容」部分
-- 每条以 - 开头，中文，简洁专业
-- 格式：做了什么 + 改了哪里/达到什么效果
-- 不输出：提交哈希、文件列表、统计数据、风险总结
-
-使用示例：
-- 日报：git_work_report --date 2026-1-27
+        description: `基于 Git diff 分析生成工作报告（日报/周期报）
+
+核心功能：
+- 支持日报模式（单个日期）和周期报模式（日期范围）
+- 自动读取指定日期的所有 Git 提交
+- 对每个提交执行 git show 获取完整 diff
+- 使用 AI 分析 diff 内容提取实际工作内容
+
+输出格式：
+- 只输出「工作内容」部分
+- 每条以 - 开头，中文，简洁专业
+- 格式：做了什么 + 改了哪里/达到什么效果
+- 不输出：提交哈希、文件列表、统计数据、风险总结
+
+使用示例：
+- 日报：git_work_report --date 2026-1-27
 - 周期报：git_work_report --start_date 2026-2-1 --end_date 2026-2-6`,
         inputSchema: {
             type: "object",

package/build/tools/__tests__/start_bugfix.unit.test.js

@@ -47,20 +47,20 @@ describe('start_bugfix 单元测试', () => {
     });
     test('template_profile 自动选择 strict（结构化输入）', async () => {
         const result = await startBugfix({
-            error_message: `## 复现步骤
-1. 打开登录页
-2. 输入错误账号
-3. 点击登录
-
-## 期望
-提示错误信息并保持页面可交互
-
-## 实际
-页面白屏，控制台报错
-
-## 环境
-- 浏览器: Chrome 120
-- 系统: Windows 11
+            error_message: `## 复现步骤
+1. 打开登录页
+2. 输入错误账号
+3. 点击登录
+
+## 期望
+提示错误信息并保持页面可交互
+
+## 实际
+页面白屏，控制台报错
+
+## 环境
+- 浏览器: Chrome 120
+- 系统: Windows 11
 - 版本: v2.3.0`,
             stack_trace: 'TypeError: Cannot read property',
             template_profile: 'auto',

package/build/tools/__tests__/start_ui.unit.test.js

@@ -62,17 +62,17 @@ describe('start_ui 单元测试', () => {
     describe('模板档位', () => {
         test('auto 模式可自动选择 strict', async () => {
             const result = await startUi({
-                description: `# 页面目标
-需要一个带筛选和批量操作的管理后台，用于管理订单与用户数据，包含导出与权限控制。
-
-## 关键交互
-1. 支持筛选、排序、分页、导出
-2. 批量启用/禁用、批量标签、批量删除
-
-## 数据来源
-来自订单服务与用户服务接口，刷新频率 30s
-
-## 状态
+                description: `# 页面目标
+需要一个带筛选和批量操作的管理后台，用于管理订单与用户数据，包含导出与权限控制。
+
+## 关键交互
+1. 支持筛选、排序、分页、导出
+2. 批量启用/禁用、批量标签、批量删除
+
+## 数据来源
+来自订单服务与用户服务接口，刷新频率 30s
+
+## 状态
 空态、加载态、错误态、无权限提示、空筛选结果`,
                 template_profile: 'auto',
             });

package/build/tools/add_feature.js

@@ -206,85 +206,85 @@ export async function addFeature(args) {
         };
         const fenceOpen = "````markdown";
         const fenceClose = "````";
-        const guide = `# 添加新功能指南（模板驱动）
-
-## 🎯 任务目标
-
-为项目添加新功能：**${featureName}**
-
-**功能描述**: ${description}
-
-**模板档位**: ${templateProfile}${profileDecision.requested === 'auto' ? '（自动）' : ''}
-${profileDecision.requested === 'auto' && profileDecision.reason ? `**选择理由**: ${profileDecision.reason}` : ''}
-
----
-
-## 📋 前置检查
-
-1. 检查文件 \`${docsDir}/project-context.md\` 是否存在
-2. 如果存在，读取并参考其中的技术栈、架构模式、编码规范
-3. 如果不存在，建议先运行 \`init_project_context\` 工具
-
----
-
-## ✅ 模板校验结果
-
-${formatValidation('requirements.md', requirementsTemplate.validation)}
-${formatValidation('design.md', designTemplate.validation)}
-${formatValidation('tasks.md', tasksTemplate.validation)}
-${combinedValidation.warnings.length > 0 ? `- 其他警告: ${combinedValidation.warnings.join('；')}` : ''}
-
----
-
-## 📝 创建文档
-
-请在 \`${docsDir}/specs/${featureName}/\` 目录下创建以下三个文件：
-
-### 文件 1: requirements.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/requirements.md\`
-**模板来源**: ${requirementsTemplate.source}
-
-${fenceOpen}
-${requirementsTemplate.content}
-${fenceClose}
-
----
-
-### 文件 2: design.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/design.md\`
-**模板来源**: ${designTemplate.source}
-
-${fenceOpen}
-${designTemplate.content}
-${fenceClose}
-
----
-
-### 文件 3: tasks.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/tasks.md\`
-**模板来源**: ${tasksTemplate.source}
-
-${fenceOpen}
-${tasksTemplate.content}
-${fenceClose}
-
----
-
-## ✅ 完成后检查
-
-- [ ] \`${docsDir}/specs/${featureName}/requirements.md\` 已创建
-- [ ] \`${docsDir}/specs/${featureName}/design.md\` 已创建
-- [ ] \`${docsDir}/specs/${featureName}/tasks.md\` 已创建
-- [ ] 所有占位符已替换
-- [ ] 内容与项目上下文一致（如有）
-
----
-
-*指南版本: 1.1.0*
-*工具: MCP Probe Kit - add_feature*
+        const guide = `# 添加新功能指南（模板驱动）
+
+## 🎯 任务目标
+
+为项目添加新功能：**${featureName}**
+
+**功能描述**: ${description}
+
+**模板档位**: ${templateProfile}${profileDecision.requested === 'auto' ? '（自动）' : ''}
+${profileDecision.requested === 'auto' && profileDecision.reason ? `**选择理由**: ${profileDecision.reason}` : ''}
+
+---
+
+## 📋 前置检查
+
+1. 检查文件 \`${docsDir}/project-context.md\` 是否存在
+2. 如果存在，读取并参考其中的技术栈、架构模式、编码规范
+3. 如果不存在，建议先运行 \`init_project_context\` 工具
+
+---
+
+## ✅ 模板校验结果
+
+${formatValidation('requirements.md', requirementsTemplate.validation)}
+${formatValidation('design.md', designTemplate.validation)}
+${formatValidation('tasks.md', tasksTemplate.validation)}
+${combinedValidation.warnings.length > 0 ? `- 其他警告: ${combinedValidation.warnings.join('；')}` : ''}
+
+---
+
+## 📝 创建文档
+
+请在 \`${docsDir}/specs/${featureName}/\` 目录下创建以下三个文件：
+
+### 文件 1: requirements.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/requirements.md\`
+**模板来源**: ${requirementsTemplate.source}
+
+${fenceOpen}
+${requirementsTemplate.content}
+${fenceClose}
+
+---
+
+### 文件 2: design.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/design.md\`
+**模板来源**: ${designTemplate.source}
+
+${fenceOpen}
+${designTemplate.content}
+${fenceClose}
+
+---
+
+### 文件 3: tasks.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/tasks.md\`
+**模板来源**: ${tasksTemplate.source}
+
+${fenceOpen}
+${tasksTemplate.content}
+${fenceClose}
+
+---
+
+## ✅ 完成后检查
+
+- [ ] \`${docsDir}/specs/${featureName}/requirements.md\` 已创建
+- [ ] \`${docsDir}/specs/${featureName}/design.md\` 已创建
+- [ ] \`${docsDir}/specs/${featureName}/tasks.md\` 已创建
+- [ ] 所有占位符已替换
+- [ ] 内容与项目上下文一致（如有）
+
+---
+
+*指南版本: 1.1.0*
+*工具: MCP Probe Kit - add_feature*
 `;
         return okText(guide, {
             schema: (await import("../schemas/output/project-tools.js")).FeatureSpecSchema,

package/build/tools/ask_user.js

@@ -28,11 +28,11 @@ export async function askUser(args) {
                 content: [
                     {
                         type: "text",
-                        text: `${header}# ❓ 向用户提问工具
-
-## 使用方法
-
-### 单个问题
+                        text: `${header}# ❓ 向用户提问工具
+
+## 使用方法
+
+### 单个问题
 \`\`\`
 ask_user "你希望支持哪些支付方式？"
 \`\`\`

package/build/tools/interview.js

@@ -302,11 +302,11 @@ export async function interview(args) {
                 ],
                 outputs: ["访谈问题列表或访谈记录文件"],
             });
-            const text = `${header}# 📋 需求访谈工具
-
-## 功能说明
-
-在开发新功能前，通过结构化访谈澄清需求，避免理解偏差和返工。
+            const text = `${header}# 📋 需求访谈工具
+
+## 功能说明
+
+在开发新功能前，通过结构化访谈澄清需求，避免理解偏差和返工。
 
 **核心理念**: 先慢下来，把问题想清楚，反而能更快地交付正确的解决方案。
 
@@ -354,10 +354,10 @@ interview --feature-name user-login --answers {...}
 ## 为什么需要访谈？
 
 - ✅ 澄清需求，避免理解偏差
-- ✅ 发现隐藏的约束和依赖
-- ✅ 减少返工，提高交付质量
-- ✅ 形成清晰的需求文档
-
+- ✅ 发现隐藏的约束和依赖
+- ✅ 减少返工，提高交付质量
+- ✅ 形成清晰的需求文档
+
 **先慢下来，反而能更快。**`;
             const structuredData = {
                 summary: "需求访谈工具使用说明",

package/build/tools/start_bugfix.d.ts

@@ -1,4 +1,5 @@
-export declare function startBugfix(args: any): Promise<import("../lib/response.js").ToolResponse | {
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
+export declare function startBugfix(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_bugfix.js

@@ -2,6 +2,7 @@ import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { BugFixReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 function decideTemplateProfile(description) {
     const text = description || '';
     const lengthScore = text.length >= 200 ? 2 : text.length >= 120 ? 1 : 0;
@@ -40,11 +41,11 @@ function resolveTemplateProfile(rawProfile, description) {
         warning: `模板档位 "${rawProfile}" 不支持，已回退为 ${fallback}`,
     };
 }
-const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
-
-## 🎯 目标
-
-修复以下 Bug：
+const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
+
+## 🎯 目标
+
+修复以下 Bug：
 
 **错误信息**:
 \`\`\`
@@ -133,125 +134,125 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
 
 ---
 
-*编排工具: MCP Probe Kit - start_bugfix*
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格）
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-{stack_trace_section}
-
----
-
-## ✅ 执行计划（按顺序）
-
-1) 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
-2) 调用 \`fix_bug\`
-\`\`\`json
-{
-  "error_message": "{error_message}",
-  "stack_trace": "{stack_trace}"
-}
-\`\`\`
-3) 调用 \`gentest\`
-\`\`\`json
-{
-  "code": "[修复后的代码]",
-  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
-}
-\`\`\`
-
----
-
-## ✅ 输出汇总
-1. Bug 原因
-2. 修复方案
-3. 修改文件
-4. 测试覆盖
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix*
+const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格）
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+{stack_trace_section}
+
+---
+
+## ✅ 执行计划（按顺序）
+
+1) 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
+2) 调用 \`fix_bug\`
+\`\`\`json
+{
+  "error_message": "{error_message}",
+  "stack_trace": "{stack_trace}"
+}
+\`\`\`
+3) 调用 \`gentest\`
+\`\`\`json
+{
+  "code": "[修复后的代码]",
+  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
+}
+\`\`\`
+
+---
+
+## ✅ 输出汇总
+1. Bug 原因
+2. 修复方案
+3. 修改文件
+4. 测试覆盖
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（Requirements Loop）
-
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 Bug 修复所需关键信息。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. **不覆盖用户原始描述**
-2. **补全内容必须标注来源**（User / Derived / Assumption）
-3. **假设必须进入待确认列表**
-4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
-
----
-
-## 🔁 执行步骤（每轮）
-
-### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于 Bug 修复补全清单（复现/环境/期望/影响/验证）。
-
-**调用示例**:
-\`\`\`json
-{
-  "questions": [
-    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
-    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
-  ]
-}
-\`\`\`
-
-### 2) 更新结构化输出
-将回答补入 \`requirements\`，并标注来源：
-- User：用户明确回答
-- Derived：合理推导
-- Assumption：无法确认但补全（需确认）
-
-### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入修复流程。
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，执行：
-1. 调用 \`fix_bug\` 进行定位与修复
-2. 调用 \`gentest\` 生成回归测试
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（Requirements Loop）
+
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 Bug 修复所需关键信息。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. **不覆盖用户原始描述**
+2. **补全内容必须标注来源**（User / Derived / Assumption）
+3. **假设必须进入待确认列表**
+4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
+
+---
+
+## 🔁 执行步骤（每轮）
+
+### 1) 生成待确认问题
+使用 \`ask_user\` 提问，问题来源于 Bug 修复补全清单（复现/环境/期望/影响/验证）。
+
+**调用示例**:
+\`\`\`json
+{
+  "questions": [
+    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
+    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
+  ]
+}
+\`\`\`
+
+### 2) 更新结构化输出
+将回答补入 \`requirements\`，并标注来源：
+- User：用户明确回答
+- Derived：合理推导
+- Assumption：无法确认但补全（需确认）
+
+### 3) 自检与结束
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入修复流程。
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，执行：
+1. 调用 \`fix_bug\` 进行定位与修复
+2. 调用 \`gentest\` 生成回归测试
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
-const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（Requirements Loop | 严格）
-
-本模式用于稳健补全关键信息，不改变用户意图。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. 不覆盖用户原始描述
-2. 补全内容标注来源（User / Derived / Assumption）
-3. 假设进入待确认列表
-4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
-
----
-
-## 🔁 执行步骤（每轮）
-1) 使用 \`ask_user\` 提问补全关键信息
-2) 更新结构化输出并标注来源
-3) 若 \`openQuestions\` 为空且无高风险假设则结束
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，调用 \`fix_bug\` 与 \`gentest\`
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（Requirements Loop | 严格）
+
+本模式用于稳健补全关键信息，不改变用户意图。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. 不覆盖用户原始描述
+2. 补全内容标注来源（User / Derived / Assumption）
+3. 假设进入待确认列表
+4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
+
+---
+
+## 🔁 执行步骤（每轮）
+1) 使用 \`ask_user\` 提问补全关键信息
+2) 更新结构化输出并标注来源
+3) 若 \`openQuestions\` 为空且无高风险假设则结束
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，调用 \`fix_bug\` 与 \`gentest\`
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
 function buildBugfixQuestions(questionBudget) {
     const base = [
@@ -264,8 +265,10 @@ function buildBugfixQuestions(questionBudget) {
     ];
     return base.slice(0, Math.max(0, questionBudget));
 }
-export async function startBugfix(args) {
+export async function startBugfix(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_bugfix 已取消");
+        await reportToolProgress(context, 10, "start_bugfix: 解析参数");
         // 智能参数解析，支持自然语言输入
         const parsedArgs = parseArgs(args, {
             defaultValues: {
@@ -295,6 +298,8 @@ export async function startBugfix(args) {
         const maxRounds = getNumber(parsedArgs.loop_max_rounds, 2);
         const questionBudget = getNumber(parsedArgs.loop_question_budget, 5);
         const assumptionCap = getNumber(parsedArgs.loop_assumption_cap, 3);
+        throwIfAborted(context?.signal, "start_bugfix 已取消");
+        await reportToolProgress(context, 35, "start_bugfix: 参数解析完成");
         if (!errorMessage) {
             throw new Error("缺少必填参数: error_message（错误信息）");
         }
@@ -320,6 +325,8 @@ export async function startBugfix(args) {
             headerNotes.push(profileDecision.warning);
         }
         if (requirementsMode === "loop") {
+            throwIfAborted(context?.signal, "start_bugfix(loop) 已取消");
+            await reportToolProgress(context, 70, "start_bugfix: 生成 loop 计划");
             const openQuestions = buildBugfixQuestions(questionBudget).map((q, index) => ({
                 id: `Q-${index + 1}`,
                 ...q,
@@ -432,6 +439,7 @@ export async function startBugfix(args) {
                     template: templateMeta,
                 },
             };
+            await reportToolProgress(context, 95, "start_bugfix: loop 输出已生成");
             return okStructured(guide, loopReport, {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清 Bug 需求并更新结构化输出，满足结束条件后再进入 fix_bug / gentest',
@@ -523,6 +531,7 @@ export async function startBugfix(args) {
                 template: templateMeta,
             },
         };
+        await reportToolProgress(context, 95, "start_bugfix: 执行计划输出已生成");
         return okStructured(guide, bugfixReport, {
             schema: BugFixReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态',

package/build/tools/start_feature.d.ts

@@ -1,4 +1,5 @@
-export declare function startFeature(args: any): Promise<import("../lib/response.js").ToolResponse | {
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
+export declare function startFeature(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;