mcp-probe-kit 1.11.0 → 1.13.0

package/build/tools/ask_user.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ask_user - 向用户提问工具
+ * 当 AI 需要更多信息时，可以主动向用户提问
+ */
+export declare function askUser(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/ask_user.js

@@ -0,0 +1,124 @@
+/**
+ * ask_user - 向用户提问工具
+ * 当 AI 需要更多信息时，可以主动向用户提问
+ */
+import { parseArgs } from "../utils/parseArgs.js";
+export async function askUser(args) {
+    try {
+        // 解析参数
+        const parsed = parseArgs(args, {
+            primaryField: "question",
+            fieldAliases: {
+                question: ["q", "ask"],
+            },
+        });
+        const question = parsed.question;
+        const questions = parsed.questions;
+        const context = parsed.context;
+        const reason = parsed.reason;
+        if (!question && !questions) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# ❓ 向用户提问工具
+
+## 使用方法
+
+### 单个问题
+\`\`\`
+ask_user "你希望支持哪些支付方式？"
+\`\`\`
+
+### 多个问题
+\`\`\`
+ask_user --questions [
+  "目标用户是谁？",
+  "预期的并发量是多少？",
+  "有预算限制吗？"
+]
+\`\`\`
+
+### 带上下文的问题
+\`\`\`
+ask_user "是否需要支持移动端？" --context "当前只有 PC 端实现"
+\`\`\`
+
+## 使用场景
+
+- 需求不明确时主动澄清
+- 技术方案选择需要用户决策
+- 发现潜在风险需要确认
+- 需要补充业务背景信息
+
+## 最佳实践
+
+1. **问题要具体** - 避免过于宽泛的问题
+2. **提供上下文** - 说明为什么要问这个问题
+3. **给出选项** - 如果有明确的选项，列出来
+4. **标注重要性** - 区分必答和可选问题`,
+                    },
+                ],
+            };
+        }
+        const lines = [];
+        lines.push("# ❓ AI 需要向你确认一些信息");
+        lines.push("");
+        if (reason) {
+            lines.push(`**提问原因**: ${reason}`);
+            lines.push("");
+        }
+        if (context) {
+            lines.push("## 背景信息");
+            lines.push("");
+            lines.push(context);
+            lines.push("");
+        }
+        lines.push("## 问题");
+        lines.push("");
+        if (questions && questions.length > 0) {
+            // 多个问题
+            for (let i = 0; i < questions.length; i++) {
+                const q = questions[i];
+                const required = q.required !== false ? "**[必答]**" : "_[可选]_";
+                lines.push(`### ${i + 1}. ${q.question} ${required}`);
+                lines.push("");
+                if (q.context) {
+                    lines.push(`_${q.context}_`);
+                    lines.push("");
+                }
+                if (q.options && q.options.length > 0) {
+                    lines.push("**可选项**:");
+                    for (const option of q.options) {
+                        lines.push(`- ${option}`);
+                    }
+                    lines.push("");
+                }
+                lines.push("**你的回答**: ");
+                lines.push("");
+                lines.push("---");
+                lines.push("");
+            }
+        }
+        else if (question) {
+            // 单个问题
+            lines.push(`**${question}**`);
+            lines.push("");
+            lines.push("**你的回答**: ");
+            lines.push("");
+        }
+        lines.push("---");
+        lines.push("");
+        lines.push("💡 **提示**: 请回答上述问题，我会根据你的回答继续工作。");
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 提问失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/css_order.js

@@ -1,61 +1,61 @@
 // css_order 工具实现
 export async function cssOrder(_args) {
     try {
-        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
-
-如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
-
----
-
-## 排序逻辑（由外向内，由大到小）
-
-将属性分为五类，按顺序排列：
-
-### 1. 定位属性 (Positioning)
-决定元素“在哪里”。
-- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
-
-### 2. 盒子模型 (Box Model)
-决定元素“占多大空间”。
-- \`display\` / \`flex\` / \`grid\` 相关属性
-- \`width\` / \`height\` / \`max-width\` / \`min-width\`
-- \`margin\` / \`padding\` / \`border\`
-- \`box-sizing\` / \`overflow\`
-
-### 3. 文本排版 (Typography)
-决定元素内“文字内容”的样式。
-- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
-- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
-
-### 4. 视觉表现 (Visual/Decoration)
-决定元素“皮肤”的外观。
-- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
-
-### 5. 其他与交互 (Misc/Transitions)
-动效和交互相关。
-- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
-
----
-
-## 处理要求
-
-1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
-2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
-3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
-4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
-5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
-
----
-
-## 快速对比表
-
-| 顺序 | 类别 | 常用属性举例 | 核心目的 |
-| --- | --- | --- | --- |
-| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
-| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
-| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
-| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
-| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
+        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
+
+如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
+
+---
+
+## 排序逻辑（由外向内，由大到小）
+
+将属性分为五类，按顺序排列：
+
+### 1. 定位属性 (Positioning)
+决定元素“在哪里”。
+- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
+
+### 2. 盒子模型 (Box Model)
+决定元素“占多大空间”。
+- \`display\` / \`flex\` / \`grid\` 相关属性
+- \`width\` / \`height\` / \`max-width\` / \`min-width\`
+- \`margin\` / \`padding\` / \`border\`
+- \`box-sizing\` / \`overflow\`
+
+### 3. 文本排版 (Typography)
+决定元素内“文字内容”的样式。
+- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
+- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
+
+### 4. 视觉表现 (Visual/Decoration)
+决定元素“皮肤”的外观。
+- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
+
+### 5. 其他与交互 (Misc/Transitions)
+动效和交互相关。
+- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
+
+---
+
+## 处理要求
+
+1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
+2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
+3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
+4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
+5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
+
+---
+
+## 快速对比表
+
+| 顺序 | 类别 | 常用属性举例 | 核心目的 |
+| --- | --- | --- | --- |
+| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
+| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
+| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
+| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
+| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
 `;
         return {
             content: [

package/build/tools/index.d.ts

@@ -38,3 +38,6 @@ export { startOnboard } from "./start_onboard.js";
 export { startApi } from "./start_api.js";
 export { startDoc } from "./start_doc.js";
 export { genSkill } from "./gen_skill.js";
+export { startRalph } from "./start_ralph.js";
+export { interview } from "./interview.js";
+export { askUser } from "./ask_user.js";

package/build/tools/index.js

@@ -39,3 +39,7 @@ export { startOnboard } from "./start_onboard.js";
 export { startApi } from "./start_api.js";
 export { startDoc } from "./start_doc.js";
 export { genSkill } from "./gen_skill.js";
+export { startRalph } from "./start_ralph.js";
+// 访谈工具
+export { interview } from "./interview.js";
+export { askUser } from "./ask_user.js";

package/build/tools/interview.d.ts

@@ -0,0 +1,18 @@
+/**
+ * interview - 需求访谈工具
+ * 在开发前通过结构化访谈澄清需求，避免理解偏差
+ * 生成访谈记录文件，供后续 start_feature/add_feature 使用
+ */
+export declare function interview(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;