rush-ai 0.2.0

package/dist/plugin-assets/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: rush-task
+description: "在 Claude Code 中创建 Rush Agent 任务并跟踪执行过程。当用户想让 Rush Agent（如 UI 生成、代码分析、文档撰写等）执行任务时使用此 Skill。"
+version: 0.2.0
+author: kanyun
+tags:
+  - rush
+  - agent
+  - task
+argument-hint: <prompt>
+---
+
+# Rush Task — Agent 任务执行
+
+你可以通过 Rush MCP 工具来创建和管理 Agent 任务。
+
+## 前置条件
+
+在执行任何操作前，确认以下条件：
+- MCP server "rush" 已连接（tools 列表中有 `rush_*` 开头的工具）
+- 如果 MCP 工具不可用，提示用户运行 `rush-ai plugin doctor` 诊断问题
+
+## 使用流程
+
+### Step 1: 列出可用 Agent
+
+调用 `rush_agent_list` 获取当前可用的 Agent 列表。
+
+**失败处理：**
+- 如果返回鉴权错误（`Not authenticated`），提示用户运行 `rush-ai auth login`
+- 如果连接失败或超时，提示用户运行 `rush-ai plugin doctor` 检查配置
+
+### Step 2: 选择 Agent
+
+- 如果只有一个 Agent，直接使用
+- 如果有多个 Agent，向用户展示列表（名称 + 能力描述），让用户选择
+- 如果没有可用 Agent，告知用户当前无可用 Agent，建议联系管理员配置
+
+### Step 3: 执行任务（策略分流）
+
+根据任务复杂度选择执行策略：
+
+**短任务（简单查询、快速操作）：**
+使用 `rush_task_run` 同步执行，直接返回结果。
+- 适用场景：用户明确说"快速"、"简单查询"、"查看状态"
+
+**长任务（复杂生成、多步骤处理）：**
+1. 调用 `rush_task_create` 创建异步任务
+2. 调用 `rush_task_watch` 跟踪进度（默认超时 5 分钟）
+3. 向用户实时展示进度信息
+- 适用场景：用户要求"生成"、"创建"、"分析"、"重构"
+
+**判断策略：**
+- 用户明确说"快速"、"简单查询" → 短任务（`rush_task_run`）
+- 用户要求"生成"、"创建"、"分析"等复杂操作 → 长任务（`rush_task_create`）
+- 不确定时默认使用异步模式（`rush_task_create`）
+
+### Step 4: 获取结果
+
+- 调用 `rush_task_result` 获取最终结果
+- 如果任务失败，展示错误信息并建议：
+  - 修改 prompt 重试
+  - 检查 Agent 是否支持该类型任务
+- 如果有输出文件，调用 `rush_task_files` 列出并展示：
+  - 代码文件（code）：展示文件路径和内容摘要
+  - 图片文件（image）：展示 URL 供用户查看
+  - 文档文件（document）：展示内容
+
+### Step 5: 后续操作
+
+- 用户可以基于结果继续对话（"修改一下..."、"重新生成..."）
+- 继续操作时创建新任务，在 prompt 中引用之前的 task_id 提供上下文
+- 用户可以随时用 `rush_task_cancel` 取消运行中的任务
+- 用 `rush_task_list` 查看历史任务
+
+## 可用 MCP 工具参考
+
+| 工具 | 用途 |
+|------|------|
+| `rush_agent_list` | 列出可用 Agent |
+| `rush_agent_info` | 获取 Agent 详细信息 |
+| `rush_task_run` | 同步执行任务（阻塞直到完成） |
+| `rush_task_create` | 创建异步任务 |
+| `rush_task_status` | 查询任务状态 |
+| `rush_task_result` | 获取任务结果 |
+| `rush_task_watch` | 实时跟踪任务进度（SSE） |
+| `rush_task_list` | 列出历史任务 |
+| `rush_task_files` | 列出任务输出文件 |
+| `rush_task_cancel` | 取消运行中的任务 |

package/dist/plugin-assets/commands/commands.test.ts

@@ -0,0 +1,140 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+
+const COMMANDS_DIR = resolve(__dirname);
+
+/**
+ * Slash command behavior tests.
+ *
+ * These .md files are Claude Code prompt templates — they define the AI's
+ * behavioral contract for each slash command. The tests validate:
+ *   1. All expected command files exist
+ *   2. Each command references the correct MCP tools
+ *   3. Each command defines error handling / recovery guidance
+ *   4. Each command follows the required structure (description + numbered steps)
+ */
+
+const EXPECTED_COMMANDS = [
+  {
+    file: 'rush-task.md',
+    description: '/rush-task',
+    requiredTools: ['rush_agent_list', 'rush_task_run', 'rush_task_files'],
+    requiredRecovery: ['rush-ai auth login', 'rush-ai plugin doctor'],
+  },
+  {
+    file: 'rush-agent.md',
+    description: '/rush-agent',
+    requiredTools: ['rush_agent_list', 'rush_agent_info'],
+    requiredRecovery: ['rush-ai auth login', 'rush-ai plugin doctor'],
+  },
+  {
+    file: 'rush-files.md',
+    description: '/rush-files',
+    requiredTools: ['rush_task_files', 'rush_task_list'],
+    requiredRecovery: ['rush-ai auth login', 'rush-ai plugin doctor'],
+  },
+];
+
+describe('slash command definitions', () => {
+  it('all expected command files exist', () => {
+    for (const cmd of EXPECTED_COMMANDS) {
+      const filePath = resolve(COMMANDS_DIR, cmd.file);
+      expect(existsSync(filePath), `${cmd.file} should exist`).toBe(true);
+    }
+  });
+
+  it('no unexpected command files', () => {
+    const mdFiles = readdirSync(COMMANDS_DIR).filter((f) =>
+      f.endsWith('.md')
+    );
+    const expectedFiles = EXPECTED_COMMANDS.map((c) => c.file);
+    for (const file of mdFiles) {
+      expect(expectedFiles, `unexpected command file: ${file}`).toContain(file);
+    }
+  });
+
+  for (const cmd of EXPECTED_COMMANDS) {
+    describe(cmd.description, () => {
+      const filePath = resolve(COMMANDS_DIR, cmd.file);
+      const content = existsSync(filePath)
+        ? readFileSync(filePath, 'utf-8')
+        : '';
+
+      it('has a description on the first line', () => {
+        const firstLine = content.split('\n')[0].trim();
+        expect(firstLine.length).toBeGreaterThan(0);
+        // First line should be descriptive text, not a heading or empty
+        expect(firstLine).not.toMatch(/^#/);
+      });
+
+      it('defines a numbered execution flow', () => {
+        // Must contain at least "1." and "2." steps
+        expect(content).toMatch(/^1\./m);
+        expect(content).toMatch(/^2\./m);
+      });
+
+      it('references required MCP tools', () => {
+        for (const tool of cmd.requiredTools) {
+          expect(
+            content,
+            `${cmd.file} should reference MCP tool: ${tool}`
+          ).toContain(tool);
+        }
+      });
+
+      it('includes error recovery guidance', () => {
+        for (const recovery of cmd.requiredRecovery) {
+          expect(
+            content,
+            `${cmd.file} should include recovery: ${recovery}`
+          ).toContain(recovery);
+        }
+      });
+    });
+  }
+});
+
+describe('/rush-agent specific behavior', () => {
+  const content = readFileSync(
+    resolve(COMMANDS_DIR, 'rush-agent.md'),
+    'utf-8'
+  );
+
+  it('supports listing all agents (no argument)', () => {
+    expect(content).toContain('rush_agent_list');
+    expect(content).toMatch(/列表/);
+  });
+
+  it('supports querying a specific agent by name (with argument)', () => {
+    expect(content).toContain('rush_agent_info');
+    expect(content).toMatch(/\/rush-agent\s+\S+/);
+  });
+});
+
+describe('/rush-files specific behavior', () => {
+  const content = readFileSync(
+    resolve(COMMANDS_DIR, 'rush-files.md'),
+    'utf-8'
+  );
+
+  it('supports direct task ID input', () => {
+    expect(content).toMatch(/\/rush-files\s+\S+/);
+    expect(content).toContain('task ID');
+  });
+
+  it('supports interactive task selection when no ID given', () => {
+    expect(content).toContain('rush_task_list');
+    expect(content).toMatch(/最近/);
+  });
+
+  it('defines file type categories for display', () => {
+    expect(content).toMatch(/代码文件|code/i);
+    expect(content).toMatch(/图片文件|image/i);
+    expect(content).toMatch(/文档文件|document/i);
+  });
+
+  it('handles empty file list scenario', () => {
+    expect(content).toMatch(/没有.*文件|no.*file/i);
+  });
+});

package/dist/plugin-assets/commands/rush-agent.md

@@ -0,0 +1,18 @@
+查看和选择可用的 Rush Agent。
+
+当用户调用 /rush-agent 时，按照以下流程执行：
+
+1. 确认 Rush MCP 工具可用（检查 `rush_agent_list` 等工具是否在 tools 列表中）
+2. 调用 `rush_agent_list` 获取所有可用 Agent
+3. 以列表形式展示每个 Agent 的：
+   - 名称（name）
+   - 描述（description）
+   - 支持的能力/技能（skills）
+4. 如果用户在命令中指定了 Agent 名称（如 `/rush-agent ui-generator`），调用 `rush_agent_info` 获取该 Agent 的详细信息并展示：
+   - 完整描述
+   - 支持的 skills 列表
+   - 可用的 MCP servers
+   - 使用示例
+5. 失败时给出修复建议：
+   - 鉴权错误 → `rush-ai auth login`
+   - 连接失败 → `rush-ai plugin doctor`

package/dist/plugin-assets/commands/rush-files.md

@@ -0,0 +1,19 @@
+获取并展示 Rush Agent 任务的输出文件。
+
+当用户调用 /rush-files 时，按照以下流程执行：
+
+1. 确认 Rush MCP 工具可用（检查 `rush_task_files` 等工具是否在 tools 列表中）
+2. 如果用户提供了 task ID（如 `/rush-files abc123`），直接使用该 ID
+3. 如果没有提供 task ID：
+   - 调用 `rush_task_list` 获取最近的任务列表
+   - 展示最近 5 个任务，让用户选择
+4. 调用 `rush_task_files` 获取指定任务的输出文件列表
+5. 按文件类型分类展示：
+   - **代码文件**（code）：展示文件名、语言、内容摘要
+   - **图片文件**（image）：展示文件名和 URL
+   - **文档文件**（document）：展示文件名和内容预览
+6. 如果没有输出文件，告知用户该任务没有产出文件
+7. 失败时给出修复建议：
+   - 鉴权错误 → `rush-ai auth login`
+   - 任务不存在 → 检查 task ID 是否正确
+   - 连接失败 → `rush-ai plugin doctor`

package/dist/plugin-assets/commands/rush-task.md

@@ -0,0 +1,15 @@
+使用 Rush Agent 执行任务。
+
+当用户调用 /rush-task 时，按照以下流程执行：
+
+1. 确认 Rush MCP 工具可用（检查 `rush_agent_list` 等工具是否在 tools 列表中）
+2. 调用 `rush_agent_list` 列出可用 Agent
+3. 如果有多个 Agent，让用户选择；只有一个则直接使用
+4. 根据任务复杂度选择执行策略：
+   - 简单查询 → `rush_task_run`（同步）
+   - 复杂生成 → `rush_task_create` + `rush_task_watch`（异步）
+5. 展示执行结果
+6. 如有文件输出（代码、图片、文档），调用 `rush_task_files` 并展示
+7. 失败时给出明确的修复建议（`rush-ai auth login` / `rush-ai plugin doctor`）
+
+如果用户在命令中指定了参数（如 `/rush-task 生成登录页`），直接作为 prompt 使用，无需再次询问。

package/dist/plugin-assets/rules/rush-agent.md

@@ -0,0 +1,24 @@
+# Rush Agent 使用规则
+
+当项目中安装了 Rush plugin 且 MCP server "rush" 已连接时，遵循以下规则：
+
+## 何时使用 Rush Agent
+
+- 用户明确要求使用 Rush Agent 执行任务
+- 用户调用 `/rush-task` 命令
+- 用户提到"让 Rush 来做"、"用 Agent 处理"等意图
+
+## 何时不使用 Rush Agent
+
+- 用户要求本地操作（编辑文件、运行命令等）— 直接使用 Claude Code 本身能力
+- 用户没有提到 Rush 或 Agent — 不要主动推荐
+
+## 错误恢复
+
+当 Rush MCP 工具调用失败时：
+
+1. **鉴权错误**（`Not authenticated`）→ 提示：`rush-ai auth login`
+2. **连接失败** → 提示：`rush-ai plugin doctor`
+3. **Agent 不存在** → 调用 `rush_agent_list` 列出可用 Agent
+4. **任务超时** → 建议用户检查网络或简化任务
+5. **任务失败** → 展示错误信息，建议修改 prompt 重试