mcp-probe-kit 1.11.0 → 1.13.0

package/README.md

@@ -7,7 +7,9 @@
 
 > 🚀 AI 开发增强工具集 - 让 AI 更懂你的开发流程
 
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **40 个实用工具**（32 个基础工具 + 8 个智能编排），覆盖代码质量、开发效率、项目管理全流程。
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **43 个实用工具**（34 个基础工具 + 9 个智能编排），覆盖代码质量、开发效率、项目管理全流程。
+
+**✨ v1.12.0 新增**: Interview 模式 - 先慢下来，通过访谈把需求想清楚，反而能更快！
 
 **支持所有 MCP 客户端**：Cursor、Claude Desktop、Cline、Continue 等
 
@@ -17,10 +19,14 @@
 
 ## ✨ 功能特性
 
+### 🎯 访谈工具（2 个工具）🆕
+- **`interview`** - 需求访谈模式：在开发前通过结构化提问澄清需求，避免理解偏差和返工
+- **`ask_user`** - 通用提问工具：AI 可随时向用户提问，澄清不确定的信息
+
 ### 🔍 代码质量（8 个工具）
 - **`detect_shell`** - AI 模型套壳检测
 - **`code_review`** - 代码审查助手
-- **`security_scan`** - 安全漏洞扫描 🆕
+- **`security_scan`** - 安全漏洞扫描
 - **`debug`** - 智能调试助手
 - **`gentest`** - 测试用例生成器
 - **`refactor`** - 重构建议
@@ -35,17 +41,16 @@
 - **`genchangelog`** - Changelog 生成
 - **`gensql`** - SQL 查询生成器
 - **`genui`** - UI 组件生成器（React + Vue）
-- **`gen_mock`** - Mock 数据生成器 🆕
-- **`gen_skill`** - Agent Skills 文档生成器 🆕
-- **`design2code`** - 设计稿转代码（图片/描述/HTML → Vue/React）🆕
+- **`gen_mock`** - Mock 数据生成器
+- **`gen_skill`** - Agent Skills 文档生成器
+- **`design2code`** - 设计稿转代码（图片/描述/HTML → Vue/React）
 - **`explain`** - 代码解释器
 - **`convert`** - 代码转换器
 - **`css_order`** - CSS 属性顺序规范
 - **`genreadme`** - README 生成器
 - **`split`** - 文件拆分工具
-- **`fix_bug`** - Bug 修复流程指南 🆕
-- **`estimate`** - 工作量估算 🆕
-- **`gen_skill`** - Agent Skills 文档生成器 🆕
+- **`fix_bug`** - Bug 修复流程指南
+- **`estimate`** - 工作量估算
 
 ### 📦 项目管理（8 个工具）
 - **`init_setting`** - Cursor AI 配置初始化
@@ -53,22 +58,23 @@
 - **`check_deps`** - 依赖健康度检查
 - **`resolve_conflict`** - Git 冲突解决助手
 - **`analyze_project`** - 项目分析工具，帮助AI快速理解老项目
-- **`init_project_context`** - 初始化项目上下文，生成技术栈和架构文档 🆕
-- **`add_feature`** - 添加新功能，生成需求/设计/任务文档 🆕
-- **`start_onboard`** - 快速上手项目（智能编排）🆕
+- **`init_project_context`** - 初始化项目上下文，生成技术栈和架构文档
+- **`add_feature`** - 添加新功能，生成需求/设计/任务文档
+- **`start_onboard`** - 快速上手项目（智能编排）
 
-### 🚀 智能编排（8 个工具）
+### 🚀 智能编排（9 个工具）
 
 智能编排工具自动组合多个基础工具，一键完成复杂工作流：
 
-- **`start_feature`** - 新功能开发：上下文 → 功能规格 → 工作量估算 🆕
-- **`start_bugfix`** - Bug 修复：上下文 → 分析修复 → 测试 → 提交 🆕
-- **`start_review`** - 代码体检：上下文 → 质量审查 → 安全扫描 → 性能分析 🆕
-- **`start_release`** - 发布准备：上下文 → Changelog → PR 描述 🆕
-- **`start_refactor`** - 代码重构：上下文 → 审查 → 重构 → 测试 🆕
-- **`start_onboard`** - 快速上手：项目分析 → 生成上下文文档 🆕
-- **`start_api`** - API 开发：上下文 → API 文档 → Mock 数据 → 测试 🆕
-- **`start_doc`** - 文档生成：上下文 → 代码注释 → README → API 文档 🆕
+- **`start_feature`** - 新功能开发：上下文 → 功能规格 → 工作量估算
+- **`start_bugfix`** - Bug 修复：上下文 → 分析修复 → 测试 → 提交
+- **`start_review`** - 代码体检：上下文 → 质量审查 → 安全扫描 → 性能分析
+- **`start_release`** - 发布准备：上下文 → Changelog → PR 描述
+- **`start_refactor`** - 代码重构：上下文 → 审查 → 重构 → 测试
+- **`start_onboard`** - 快速上手：项目分析 → 生成上下文文档
+- **`start_api`** - API 开发：上下文 → API 文档 → Mock 数据 → 测试
+- **`start_doc`** - 文档生成：上下文 → 代码注释 → README → API 文档
+- **`start_ralph`** - Ralph Loop 循环开发：生成安全模式脚本 → 多轮迭代 → 自动保护 🆕
 
 ---
 
@@ -307,6 +313,85 @@ npm install mcp-probe-kit
 
 ## 📖 工具使用指南
 
+### 🎯 访谈工具 🆕
+
+#### `interview` - 需求访谈模式
+
+在开发前通过结构化访谈澄清需求，避免理解偏差和返工。
+
+**核心理念**: 先慢下来，把问题想清楚，反而能更快地交付正确的解决方案。
+
+**用法**：
+```
+interview "实现用户登录功能"
+```
+
+**访谈内容**：
+- **阶段 1**: 背景理解（3个问题）- 痛点、用户、业务驱动
+- **阶段 2**: 功能边界（4个问题）- 核心价值、范围、输入输出
+- **阶段 3**: 技术约束（4个问题）- 技术栈、性能、兼容性、安全
+- **阶段 4**: 验收标准（3个问题）- 成功标准、测试场景、效果衡量
+
+**工作流程**：
+```
+1. AI: interview "登录功能"
+   ↓
+2. 生成 12-15 个结构化问题
+   ↓
+3. 用户回答所有问题
+   ↓
+4. AI 生成 docs/interviews/user-login-interview.md
+   ↓
+5. 用户选择:
+   - 立即开发: start_feature --from-interview user-login
+   - 生成规格: add_feature --from-interview user-login
+   - 稍后开发: 访谈记录已保存，随时可用
+```
+
+**适用场景**：
+- ✅ 需求不明确的新功能
+- ✅ 复杂的业务功能
+- ✅ 涉及多方协作的功能
+- ❌ 简单的 Bug 修复
+- ❌ 需求非常明确的功能
+
+**详细文档**: 查看 [Interview 使用指南](docs/INTERVIEW_GUIDE.md)
+
+---
+
+#### `ask_user` - 通用提问工具
+
+AI 可在任何时候主动向用户提问，澄清不确定的信息。
+
+**用法**：
+```
+ask_user "你希望支持哪些支付方式？"
+ask_user --questions ["问题1", "问题2"] --context "背景信息"
+```
+
+**功能特点**：
+- 支持单个或多个问题
+- 可提供选项供用户选择
+- 可标注必答/可选
+- 可在任何工具中使用
+
+**使用场景**：
+```
+场景1: 代码审查时
+AI: "发现了性能问题，但不确定优先级"
+调用: ask_user "这个性能问题的优先级如何？是否需要立即优化？"
+
+场景2: 技术方案选择
+AI: "可以用两种方案，不确定你的偏好"
+调用: ask_user --options ["方案A: 性能优先", "方案B: 可读性优先"]
+
+场景3: Bug 修复时
+AI: "需要确认是否向后兼容"
+调用: ask_user "修复这个 Bug 是否需要保持向后兼容？"
+```
+
+---
+
 ### 🔍 代码质量工具
 
 #### `detect_shell` - 套壳检测
@@ -1154,6 +1239,52 @@ design2code <div class="container">...</div>
 
 ## 🎯 使用场景示例
 
+### 🎤 Interview 模式（推荐）🆕
+
+#### 场景 1: 需求不明确时
+```
+用户: "我想做登录功能"
+  ↓
+AI: interview "登录功能"
+  ↓
+生成 12-15 个结构化问题
+  ↓
+用户: 回答所有问题
+  ↓
+AI: 生成 docs/interviews/user-login-interview.md
+  ↓
+用户: "开始开发"
+  ↓
+AI: start_feature --from-interview user-login
+  ↓
+生成完整的功能规格文档 + 工作量估算
+```
+
+#### 场景 2: 分步进行
+```
+第1天:
+用户: "我想做登录功能"
+AI: interview "登录功能"
+用户: [回答问题]
+AI: 生成访谈记录
+
+第3天:
+用户: "开始做登录功能"
+AI: start_feature --from-interview user-login
+AI: 读取之前的访谈，生成规格文档
+```
+
+#### 场景 3: AI 主动提问
+```
+用户: "优化这段代码"
+AI: 发现不确定因素
+AI: ask_user "优化目标是性能还是可读性？"
+用户: "性能"
+AI: 继续优化
+```
+
+---
+
 ### 📝 日常开发流程
 ```
 1. code_review @feature.ts     # 代码提交前审查
@@ -1187,7 +1318,19 @@ design2code <div class="container">...</div>
 5. 开始维护和开发...
 ```
 
-### 🎯 添加新功能（Spec-Driven）
+### 🎯 添加新功能（两种方式）
+
+#### 方式 1: Interview 模式（需求不明确时）🆕
+```
+1. interview "用户登录认证功能"  # 访谈澄清需求
+2. 回答 12-15 个问题
+3. start_feature --from-interview user-auth  # 基于访谈生成规格
+4. 根据 tasks.md 逐步实现
+5. gentest @feature.ts            # 生成测试
+6. gencommit                      # 提交代码
+```
+
+#### 方式 2: 直接开发（需求明确时）
 ```
 1. init_project_context           # 确保项目上下文存在
 2. add_feature user-auth "用户登录认证功能"  # 生成功能规格

package/build/index.js

@@ -2,7 +2,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { detectShell, initSetting, initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, fix, gensql, resolveConflict, genui, explain, convert, cssOrder, genreadme, split, analyzeProject, initProjectContext, addFeature, securityScan, fixBug, estimate, genMock, design2code, startFeature, startBugfix, startReview, startRelease, startRefactor, startOnboard, startApi, startDoc, genSkill } from "./tools/index.js";
+import { detectShell, initSetting, initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, fix, gensql, resolveConflict, genui, explain, convert, cssOrder, genreadme, split, analyzeProject, initProjectContext, addFeature, securityScan, fixBug, estimate, genMock, design2code, startFeature, startBugfix, startReview, startRelease, startRefactor, startOnboard, startApi, startDoc, genSkill, startRalph, interview, askUser } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { getToolParamsGuide } from "./resources/index.js";
@@ -108,6 +108,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await startDoc(args);
             case "gen_skill":
                 return await genSkill(args);
+            case "start_ralph":
+                return await startRalph(args);
+            // 访谈工具
+            case "interview":
+                return await interview(args);
+            case "ask_user":
+                return await askUser(args);
             default:
                 throw new Error(`未知工具: ${name}`);
         }

package/build/schemas/index.d.ts

@@ -764,4 +764,130 @@ export declare const allToolSchemas: ({
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
+} | {
+    readonly name: "start_ralph";
+    readonly description: "当用户需要启动 Ralph Wiggum Loop 循环开发时使用。生成 .ralph/ 目录结构、安全模式脚本和执行指南。默认启用多重安全保护，防止无人值守时费用失控";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "本次要完成的目标/需求描述。例如：'实现用户认证功能'、'修复登录 bug'";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly description: "运行模式：safe（安全模式，默认）、normal（普通模式）。安全模式包含多重保护机制";
+            };
+            readonly completion_promise: {
+                readonly type: "string";
+                readonly description: "完成条件描述。默认：'tests passing + requirements met'";
+            };
+            readonly test_command: {
+                readonly type: "string";
+                readonly description: "每轮执行的测试命令。默认：'npm test'（会在首轮由 agent 识别正确命令）";
+            };
+            readonly cli_command: {
+                readonly type: "string";
+                readonly description: "Claude Code CLI 命令名。默认：'claude-code'（可能需要改为 'claude'）";
+            };
+            readonly max_iterations: {
+                readonly type: "number";
+                readonly description: "最大迭代轮数。safe 模式默认：8";
+            };
+            readonly max_minutes: {
+                readonly type: "number";
+                readonly description: "最大运行分钟数。safe 模式默认：25";
+            };
+            readonly confirm_every: {
+                readonly type: "number";
+                readonly description: "每几轮要求人工确认。safe 模式默认：1（每轮都确认）";
+            };
+            readonly confirm_timeout: {
+                readonly type: "number";
+                readonly description: "确认等待秒数，超时自动停止。safe 模式默认：20";
+            };
+            readonly max_same_output: {
+                readonly type: "number";
+                readonly description: "输出重复多少次停止（防卡死）。safe 模式默认：2";
+            };
+            readonly max_diff_lines: {
+                readonly type: "number";
+                readonly description: "git diff 变更行数超过此值停止（防失控）。safe 模式默认：300";
+            };
+            readonly cooldown_seconds: {
+                readonly type: "number";
+                readonly description: "每轮后冷却秒数。safe 模式默认：8";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+} | {
+    readonly name: "interview";
+    readonly description: "当用户需求不明确、需要澄清需求时使用。需求访谈工具，在开发前通过结构化提问澄清需求，避免理解偏差和返工；生成访谈记录文件供后续 start_feature/add_feature 使用；仅支持 feature 类型";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly description: {
+                readonly type: "string";
+                readonly description: "功能描述（如'实现用户登录功能'），用于开始访谈。可以是简短的自然语言描述";
+            };
+            readonly feature_name: {
+                readonly type: "string";
+                readonly description: "功能名称（kebab-case 格式，如 user-login）。可选，会自动从描述中提取";
+            };
+            readonly answers: {
+                readonly type: "object";
+                readonly description: "访谈问题的回答（JSON 对象，key 为问题 ID，value 为回答内容）。用于提交访谈结果";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+} | {
+    readonly name: "ask_user";
+    readonly description: "当 AI 需要更多信息、遇到不确定因素时使用。向用户提问工具，AI 可主动向用户提问；支持单个或多个问题、提供选项、标注重要性；可在任何时候使用";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly question: {
+                readonly type: "string";
+                readonly description: "单个问题（如'你希望支持哪些支付方式？'）";
+            };
+            readonly questions: {
+                readonly type: "array";
+                readonly description: "多个问题列表，每个问题可包含 question、context、options、required 字段";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly question: {
+                            readonly type: "string";
+                        };
+                        readonly context: {
+                            readonly type: "string";
+                        };
+                        readonly options: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly required: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+            };
+            readonly context: {
+                readonly type: "string";
+                readonly description: "问题的背景信息或上下文";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly description: "为什么要问这个问题（提问原因）";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
 })[];

package/build/schemas/index.js

@@ -8,6 +8,7 @@ import { codeGenToolSchemas } from "./code-gen-tools.js";
 import { docUtilToolSchemas } from "./doc-util-tools.js";
 import { projectToolSchemas } from "./project-tools.js";
 import { orchestrationToolSchemas } from "./orchestration-tools.js";
+import { interviewToolSchemas } from "./interview-tools.js";
 // 合并所有工具 schemas
 export const allToolSchemas = [
     ...basicToolSchemas,
@@ -17,4 +18,5 @@ export const allToolSchemas = [
     ...docUtilToolSchemas,
     ...projectToolSchemas,
     ...orchestrationToolSchemas,
+    ...interviewToolSchemas,
 ];

package/build/schemas/interview-tools.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 访谈工具的 Schema 定义
+ */
+export declare const interviewToolSchemas: readonly [{
+    readonly name: "interview";
+    readonly description: "当用户需求不明确、需要澄清需求时使用。需求访谈工具，在开发前通过结构化提问澄清需求，避免理解偏差和返工；生成访谈记录文件供后续 start_feature/add_feature 使用；仅支持 feature 类型";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly description: {
+                readonly type: "string";
+                readonly description: "功能描述（如'实现用户登录功能'），用于开始访谈。可以是简短的自然语言描述";
+            };
+            readonly feature_name: {
+                readonly type: "string";
+                readonly description: "功能名称（kebab-case 格式，如 user-login）。可选，会自动从描述中提取";
+            };
+            readonly answers: {
+                readonly type: "object";
+                readonly description: "访谈问题的回答（JSON 对象，key 为问题 ID，value 为回答内容）。用于提交访谈结果";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "ask_user";
+    readonly description: "当 AI 需要更多信息、遇到不确定因素时使用。向用户提问工具，AI 可主动向用户提问；支持单个或多个问题、提供选项、标注重要性；可在任何时候使用";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly question: {
+                readonly type: "string";
+                readonly description: "单个问题（如'你希望支持哪些支付方式？'）";
+            };
+            readonly questions: {
+                readonly type: "array";
+                readonly description: "多个问题列表，每个问题可包含 question、context、options、required 字段";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly question: {
+                            readonly type: "string";
+                        };
+                        readonly context: {
+                            readonly type: "string";
+                        };
+                        readonly options: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly required: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+            };
+            readonly context: {
+                readonly type: "string";
+                readonly description: "问题的背景信息或上下文";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly description: "为什么要问这个问题（提问原因）";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}];

package/build/schemas/interview-tools.js

@@ -0,0 +1,64 @@
+/**
+ * 访谈工具的 Schema 定义
+ */
+export const interviewToolSchemas = [
+    {
+        name: "interview",
+        description: "当用户需求不明确、需要澄清需求时使用。需求访谈工具，在开发前通过结构化提问澄清需求，避免理解偏差和返工；生成访谈记录文件供后续 start_feature/add_feature 使用；仅支持 feature 类型",
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "功能描述（如'实现用户登录功能'），用于开始访谈。可以是简短的自然语言描述",
+                },
+                feature_name: {
+                    type: "string",
+                    description: "功能名称（kebab-case 格式，如 user-login）。可选，会自动从描述中提取",
+                },
+                answers: {
+                    type: "object",
+                    description: "访谈问题的回答（JSON 对象，key 为问题 ID，value 为回答内容）。用于提交访谈结果",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "ask_user",
+        description: "当 AI 需要更多信息、遇到不确定因素时使用。向用户提问工具，AI 可主动向用户提问；支持单个或多个问题、提供选项、标注重要性；可在任何时候使用",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "单个问题（如'你希望支持哪些支付方式？'）",
+                },
+                questions: {
+                    type: "array",
+                    description: "多个问题列表，每个问题可包含 question、context、options、required 字段",
+                    items: {
+                        type: "object",
+                        properties: {
+                            question: { type: "string" },
+                            context: { type: "string" },
+                            options: { type: "array", items: { type: "string" } },
+                            required: { type: "boolean" },
+                        },
+                    },
+                },
+                context: {
+                    type: "string",
+                    description: "问题的背景信息或上下文",
+                },
+                reason: {
+                    type: "string",
+                    description: "为什么要问这个问题（提问原因）",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+];

package/build/schemas/orchestration-tools.d.ts

@@ -183,4 +183,62 @@ export declare const orchestrationToolSchemas: readonly [{
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
+}, {
+    readonly name: "start_ralph";
+    readonly description: "当用户需要启动 Ralph Wiggum Loop 循环开发时使用。生成 .ralph/ 目录结构、安全模式脚本和执行指南。默认启用多重安全保护，防止无人值守时费用失控";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "本次要完成的目标/需求描述。例如：'实现用户认证功能'、'修复登录 bug'";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly description: "运行模式：safe（安全模式，默认）、normal（普通模式）。安全模式包含多重保护机制";
+            };
+            readonly completion_promise: {
+                readonly type: "string";
+                readonly description: "完成条件描述。默认：'tests passing + requirements met'";
+            };
+            readonly test_command: {
+                readonly type: "string";
+                readonly description: "每轮执行的测试命令。默认：'npm test'（会在首轮由 agent 识别正确命令）";
+            };
+            readonly cli_command: {
+                readonly type: "string";
+                readonly description: "Claude Code CLI 命令名。默认：'claude-code'（可能需要改为 'claude'）";
+            };
+            readonly max_iterations: {
+                readonly type: "number";
+                readonly description: "最大迭代轮数。safe 模式默认：8";
+            };
+            readonly max_minutes: {
+                readonly type: "number";
+                readonly description: "最大运行分钟数。safe 模式默认：25";
+            };
+            readonly confirm_every: {
+                readonly type: "number";
+                readonly description: "每几轮要求人工确认。safe 模式默认：1（每轮都确认）";
+            };
+            readonly confirm_timeout: {
+                readonly type: "number";
+                readonly description: "确认等待秒数，超时自动停止。safe 模式默认：20";
+            };
+            readonly max_same_output: {
+                readonly type: "number";
+                readonly description: "输出重复多少次停止（防卡死）。safe 模式默认：2";
+            };
+            readonly max_diff_lines: {
+                readonly type: "number";
+                readonly description: "git diff 变更行数超过此值停止（防失控）。safe 模式默认：300";
+            };
+            readonly cooldown_seconds: {
+                readonly type: "number";
+                readonly description: "每轮后冷却秒数。safe 模式默认：8";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
 }];

package/build/schemas/orchestration-tools.js

@@ -193,4 +193,63 @@ export const orchestrationToolSchemas = [
             additionalProperties: true,
         },
     },
+    {
+        name: "start_ralph",
+        description: "当用户需要启动 Ralph Wiggum Loop 循环开发时使用。生成 .ralph/ 目录结构、安全模式脚本和执行指南。默认启用多重安全保护，防止无人值守时费用失控",
+        inputSchema: {
+            type: "object",
+            properties: {
+                goal: {
+                    type: "string",
+                    description: "本次要完成的目标/需求描述。例如：'实现用户认证功能'、'修复登录 bug'",
+                },
+                mode: {
+                    type: "string",
+                    description: "运行模式：safe（安全模式，默认）、normal（普通模式）。安全模式包含多重保护机制",
+                },
+                completion_promise: {
+                    type: "string",
+                    description: "完成条件描述。默认：'tests passing + requirements met'",
+                },
+                test_command: {
+                    type: "string",
+                    description: "每轮执行的测试命令。默认：'npm test'（会在首轮由 agent 识别正确命令）",
+                },
+                cli_command: {
+                    type: "string",
+                    description: "Claude Code CLI 命令名。默认：'claude-code'（可能需要改为 'claude'）",
+                },
+                max_iterations: {
+                    type: "number",
+                    description: "最大迭代轮数。safe 模式默认：8",
+                },
+                max_minutes: {
+                    type: "number",
+                    description: "最大运行分钟数。safe 模式默认：25",
+                },
+                confirm_every: {
+                    type: "number",
+                    description: "每几轮要求人工确认。safe 模式默认：1（每轮都确认）",
+                },
+                confirm_timeout: {
+                    type: "number",
+                    description: "确认等待秒数，超时自动停止。safe 模式默认：20",
+                },
+                max_same_output: {
+                    type: "number",
+                    description: "输出重复多少次停止（防卡死）。safe 模式默认：2",
+                },
+                max_diff_lines: {
+                    type: "number",
+                    description: "git diff 变更行数超过此值停止（防失控）。safe 模式默认：300",
+                },
+                cooldown_seconds: {
+                    type: "number",
+                    description: "每轮后冷却秒数。safe 模式默认：8",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
 ];