staff-mcp 1.0.5 → 1.0.7

package/README.md

@@ -2,26 +2,32 @@
 
 [English](./README.md) | [简体中文](./README_zh.md)
 
-A robust Model Context Protocol (MCP) server that provides AI assistants with a secure, cross-platform environment for file management, shell execution, and LSP-powered code intelligence.
+A next-generation Model Context Protocol (MCP) server that transforms any AI assistant into a highly capable, container-aware, and role-adaptable digital employee. 
 
----
-
-## 🚀 Usage
-
-Use this section if you want to run the published package.
+It provides secure file management, shell execution, LSP-powered code intelligence, a 5-tier Skill & Profile ecosystem, and a revolutionary **Docker Transparent Proxy Mode**.
 
-### Run with npx
+---
 
-Recommended command:
+## 🚀 Quick Start
 
+### 1. Standard Host Mode
+Run directly on your physical machine or virtual environment.
 ```bash
 npx -y staff-mcp@latest --working-dir /path/to/your/project
 ```
 
-Using `@latest` is the safest option for a published CLI package and avoids resolution issues such as `could not determine executable to run`.
+### 2. Docker Transparent Proxy Mode (Cyber-Shell)
+Seamlessly spawn the AI assistant **inside any Docker container** while keeping the protocol connection with the host. It mounts your project and the `staff-mcp` binary automatically—zero overhead, instant startup!
+
+```bash
+# Debug a Node.js project inside a pure Alpine container
+npx -y staff-mcp@latest --docker node:20-alpine
 
-### Configure for Claude Desktop
+# Perform security analysis inside a custom reverse-engineering image
+npx -y staff-mcp@latest --docker reverse-engineer:v3 --profile reverse-engineer
+```
 
+### 3. Claude Desktop Configuration
 Add the following to your `claude_desktop_config.json`:
 
 ```json
@@ -40,92 +46,74 @@ Add the following to your `claude_desktop_config.json`:
 }
 ```
 
-### CLI Arguments
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--working-dir` | Root directory for the sandbox | `process.cwd()` |
-| `--allowed-dir` | Extra directories allowed for access | `[]` |
-| `--transport` | Transport type (`stdio` or `http`) | `stdio` |
-| `--port` | Port for HTTP server (if using http) | `3000` |
-
-### Skill Loading
-
-`staff-mcp` can work with skill directories if they already exist in your workspace or home directory. To use them, place skill files in any supported location such as:
-
-- `.staff/skills/<skill-name>/SKILL.md`
-- `.claude/skills/<skill-name>/SKILL.md`
-- `.agents/skills/<skill-name>/SKILL.md`
-- `.opencode/skills/<skill-name>/SKILL.md`
-
-The server discovers them automatically at startup.
-
 ---
 
-## 🛠️ Core Features
+## 🛠️ Core Capabilities
 
-- **File Operations**: Secure read, write, delete, and list operations within the sandbox.
-- **Shell Integration**: Execute non-interactive commands or start background tasks (e.g., dev servers).
-- **Code Intelligence**: LSP-based symbol extraction and diagnostics for better code understanding.
-- **Skill System**: Automatically detects and loads domain-specific instructions from `.staff/skills/`, `.claude/skills/`, and `.agents/skills/`.
-- **Environment Awareness**: Native support for Windows (CMD/PowerShell) and Unix-like (Bash/Sh) systems.
+### 1. Seamless Containerization (`--docker`)
+Never pollute your host machine again. By simply appending `--docker <image>`, `staff-mcp`:
+- Instantly injects itself into the container via read-only bind mounts (no `npm install` inside the container).
+- Automatically translates Windows/Mac paths to Linux container paths.
+- Provides a `--docker-args` backdoor for hardware pass-through (e.g., ADB USB debugging, GPUs, host network).
 
-### Adding Skills
+### 2. Skill & Profile Ecosystem (`--profile`)
+`staff-mcp` acts as an "AI Workspace Configurator". It uses a **5-tier Cascade Resolution** architecture to load role-specific skills (SOPs & Prompts) dynamically:
+1. **Project Level**: \`<cwd>/.staff/skills\` (Highest priority)
+2. **Project Profile Level**: \`<cwd>/.staff/profiles/<profile>/skills\`
+3. **Global Profile Level**: \`~/.staff/profiles/<profile>/skills\`
+4. **Global Level**: \`~/.staff/skills\`
+5. **Built-in Infrastructure**: \`staff-mcp/builtin-profiles\` (e.g., the built-in \`skill-manager\`)
 
-Create a `SKILL.md` file in `.staff/skills/your-skill/`:
-
-```markdown
----
-name: my-skill
-description: Custom logic for my project
----
-Add your domain-specific instructions or workflows here.
+Switch roles on the fly:
+```bash
+npx -y staff-mcp@latest --profile developer
+npx -y staff-mcp@latest --profile reverse-engineer
 ```
 
----
-
-## 🧪 Development
-
-Use this section only if you want to work on the repository itself.
+### 3. Built-in `skill-manager`
+Out of the box, the AI assistant knows how to manage its own skills! You can simply ask it to:
+> *"Install the official Anthropic canvas-design skill into my project."*
+It will securely download, configure, and reload the skill without you lifting a finger.
 
-### Local setup
+### 4. Advanced Shell & Code Intelligence
+- **Intelligent Shell Execution**: Auto-detects and upgrades to `/bin/bash` if available, supporting complex pipelines and background tasks (e.g., starting dev servers and tailing logs).
+- **LSP Integration**: Extract symbols, get diagnostics, go to definitions, and find references for TypeScript, Python, and more.
+- **Secure Sandbox**: Strictly confines the AI to the specified working directory and user-defined allowed paths.
 
-```bash
-git clone https://github.com/your-username/staff-mcp.git
-cd staff-mcp
-npm install
-npm run build
-```
-
-### Run the local build
+---
 
-```bash
-node dist/src/index.js --working-dir ./test-workspace
-```
+## 🎛️ CLI Arguments
 
-### Run with npm scripts
+| Option | Description | Default |
+| :--- | :--- | :--- |
+| `-w, --working-dir` | Root directory for the sandbox | `process.cwd()` |
+| `-d, --allowed-dir` | Extra directories allowed for access | `[]` |
+| `-r, --profile` | The active profile for skills (e.g., developer) | `default` |
+| `--docker` | Run inside a Docker container using this image | `undefined` |
+| `-D, --docker-args` | Extra args for `docker run` (e.g., `-e FOO=BAR`) | `[]` |
+| `-t, --transport` | Transport type (`stdio` or `http`) | `stdio` |
+| `-p, --port` | Port for HTTP server | `3000` |
+| `-h, --host` | Host for HTTP server | `127.0.0.1` |
+
+### Hardware Pass-through Example (Android Reverse Engineering)
+If you need the AI to interact with an Android device connected via USB while running inside a container, utilizing network-based ADB pass-through is the most reliable cross-platform solution:
 
 ```bash
-npm start -- --working-dir ./test-workspace
-npm run dev -- --working-dir ./test-workspace
-```
+# 1. Start ADB Server on the host machine listening on all interfaces:
+# adb kill-server && adb -a nodaemon server start
 
-## ✅ Testing
+# 2. Start staff-mcp with the ADB_SERVER_SOCKET environment variable injected
+# On Mac/Windows:
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "-e ADB_SERVER_SOCKET=tcp:host.docker.internal:5037"
 
-Examples for verifying the package behavior separately from normal usage:
+# On Native Linux (If not using --network host, point to the docker bridge IP):
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "-e ADB_SERVER_SOCKET=tcp:172.17.0.1:5037"
 
-### Verify the published package
-
-```bash
-npx -y staff-mcp@latest --working-dir /tmp
+# Alternative for Native Linux (Share host network stack completely):
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "--network host"
 ```
 
-### Verify the local build
-
-```bash
-npm run build
-node dist/src/index.js --working-dir /tmp
-```
+---
 
 ## 📄 License
 

package/README_zh.md

@@ -2,27 +2,33 @@
 
 [English](./README.md) | [简体中文](./README_zh.md)
 
-一个稳健的 Model Context Protocol (MCP) 服务端，为 AI 助手提供安全、跨平台的文件管理、Shell 执行和基于 LSP 的代码智能环境。
+新一代模型上下文协议 (MCP) 服务器，它将普通的 AI 助手转变为一位极具能力的、支持容器化和按角色动态适配的“数字员工”。
 
----
-
-## 🚀 使用
-
-这一节用于说明如何直接使用已发布的包，而不是如何开发或测试这个仓库。
+内置安全的文件管理、终端执行、基于 LSP 的代码理解能力，以及创新的 **5 级技能与档案生态系统 (Skill & Profile)** 和革命性的 **Docker 透明代理模式**。
 
-### 使用 npx 运行
+---
 
-推荐命令：
+## 🚀 快速开始
 
+### 1. 标准宿主机模式
+直接在物理机或虚拟环境中运行。
 ```bash
-npx -y staff-mcp@latest --working-dir /你的项目/路径
+npx -y staff-mcp@latest --working-dir /path/to/your/project
 ```
 
-对于已发布的 CLI 包，显式使用 `@latest` 更稳妥，也可以避免类似 `could not determine executable to run` 的解析问题。
+### 2. Docker 透明代理模式 (Cyber-Shell)
+以“零侵入”的方式，将 AI 助手瞬间无缝注入到**任意 Docker 容器**中，同时保持与宿主机客户端的协议连接！底层自动挂载你的项目和 `staff-mcp` 程序包——无需 `npm install`，瞬间启动！
 
-### 在 Claude Desktop 中配置
+```bash
+# 在一个纯净的 Alpine Node 容器里调试你的代码
+npx -y staff-mcp@latest --docker node:20-alpine
 
-将以下内容添加到你的 `claude_desktop_config.json` 文件中：
+# 在自带逆向工程工具链的镜像里执行安全分析
+npx -y staff-mcp@latest --docker reverse-engineer:v3 --profile reverse-engineer
+```
+
+### 3. Claude Desktop 配置
+将以下内容添加到你的 `claude_desktop_config.json`：
 
 ```json
 {
@@ -33,98 +39,82 @@ npx -y staff-mcp@latest --working-dir /你的项目/路径
         "-y",
         "staff-mcp@latest",
         "--working-dir",
-        "/你的项目/路径"
+        "/path/to/your/project"
       ]
     }
   }
 }
 ```
 
-### 命令行参数
-
-| 参数 | 说明 | 默认值 |
-| :--- | :--- | :--- |
-| `--working-dir` | 沙箱根目录 | `process.cwd()` |
-| `--allowed-dir` | 额外允许访问的目录 | `[]` |
-| `--transport` | 传输方式 (`stdio` 或 `http`) | `stdio` |
-| `--port` | HTTP 服务端口 (如果使用 http 模式) | `3000` |
-
-### Skill 加载方式
-
-如果你的工作区或用户目录里已经存在 skill 目录，`staff-mcp` 会在启动时自动发现并加载。可用目录示例：
-
-- `.staff/skills/<skill-name>/SKILL.md`
-- `.claude/skills/<skill-name>/SKILL.md`
-- `.agents/skills/<skill-name>/SKILL.md`
-- `.opencode/skills/<skill-name>/SKILL.md`
-
 ---
 
-## 🛠️ 核心特性
+## 🛠️ 核心能力
 
-- **文件操作**: 在沙箱范围内提供安全的读、写、删除和列表操作。
-- **Shell 集成**: 执行非交互式命令或启动后台任务（如开发服务器）。
-- **代码智能**: 基于 LSP 的符号提取和诊断，帮助 AI 更好地理解代码结构。
-- **技能系统 (Skills)**: 自动检测并加载 `.staff/skills/`、`.claude/skills/` 和 `.agents/skills/` 目录下的领域特定指令。
-- **环境感知**: 原生支持 Windows (CMD/PowerShell) 和 Unix-like (Bash/Sh) 系统。
+### 1. 无缝容器化支持 (`--docker`)
+告别污染宿主机的时代。只要加上 `--docker <image>`，`staff-mcp` 将会：
+- 通过只读挂载 (`read-only bind mounts`) 瞬间注入容器（无需网络重下）。
+- 自动处理 Windows/Mac 与 Linux 容器之间的路径转换问题。
+- 提供 `--docker-args` 硬件透传后门（如 ADB USB 调试、GPU 计算、宿主机网络）。
 
-### 如何添加技能
+### 2. 技能与工种生态系统 (`--profile`)
+`staff-mcp` 充当了“AI 工位配置器”的角色。它采用 **5 级级联寻址架构 (Cascade Resolution)** 动态加载角色专属的技能包 (SOP 与提示词)：
+1. **项目级 (最高优)**：\`<cwd>/.staff/skills\`
+2. **项目级角色层**：\`<cwd>/.staff/profiles/<profile>/skills\`
+3. **全局级角色层**：\`~/.staff/profiles/<profile>/skills\`
+4. **全局级默认层**：\`~/.staff/skills\`
+5. **内置基建层**：\`staff-mcp/builtin-profiles\` (如系统自带的 \`skill-manager\`)
 
-在 `.staff/skills/your-skill/` 目录下创建一个 `SKILL.md` 文件：
-
-```markdown
----
-name: my-skill
-description: 我的项目专属逻辑
----
-在此处添加你的领域特定指令或工作流。
+在不同角色中自由切换：
+```bash
+npx -y staff-mcp@latest --profile developer
+npx -y staff-mcp@latest --profile reverse-engineer
 ```
 
----
-
-## 🧪 开发
-
-这一节只面向要修改仓库源码的开发者。
+### 3. 聪明的“技能管家” (`skill-manager`)
+系统内置了基础设施技能，AI 助手生来就知道如何管理自己！你可以直接对它说：
+> *"请帮我把 Anthropic 官方的 canvas-design 技能安装到当前项目里。"*
+它会自动帮你下载、配置并热更新技能文件，全程不需要你动手。
 
-### 本地准备
+### 4. 增强的终端与代码智能
+- **智能终端执行**：自动检测并在支持的环境中升级为 `/bin/bash`，完美支持复杂的管道命令、后台守护进程 (如开发服务器) 及日志持续读取。
+- **LSP 深度集成**：支持提取符号 (Symbols)、获取诊断信息 (Diagnostics)、跳转定义 (Definition) 和查找引用 (References)，大幅提升 AI 理解 TypeScript/Python 等代码的能力。
+- **沙盒安全**：将 AI 严格限制在你指定的工作区和允许的目录内，对全局破坏“零容忍”。
 
-```bash
-git clone https://github.com/your-username/staff-mcp.git
-cd staff-mcp
-npm install
-npm run build
-```
-
-### 运行本地构建产物
+---
 
-```bash
-node dist/src/index.js --working-dir ./test-workspace
-```
+## 🎛️ CLI 参数说明
 
-### 使用 npm 脚本运行
+| 选项 | 描述 | 默认值 |
+| :--- | :--- | :--- |
+| `-w, --working-dir` | 沙盒的根目录 (工作区) | `process.cwd()` |
+| `-d, --allowed-dir` | 额外允许 AI 访问的宿主机目录 | `[]` |
+| `-r, --profile` | 当前激活的技能档案/工种 (如 developer) | `default` |
+| `--docker` | 在指定的 Docker 镜像内运行 AI | `undefined` |
+| `-D, --docker-args` | 传递给 `docker run` 的自定义底层参数 | `[]` |
+| `-t, --transport` | 传输协议 (`stdio` 或 `http`) | `stdio` |
+| `-p, --port` | HTTP 服务的监听端口 | `3000` |
+| `-h, --host` | HTTP 服务的监听地址 | `127.0.0.1` |
+
+### 硬件透传案例 (Android 移动端逆向)
+如果你希望 AI 在容器内运行时，仍能连接并控制物理机上的 Android 手机，利用基于网络端口的 ADB 透传是最稳妥的跨平台方案：
 
 ```bash
-npm start -- --working-dir ./test-workspace
-npm run dev -- --working-dir ./test-workspace
-```
+# 1. 首先在物理机上启动 ADB Server，允许所有网卡连接：
+# adb kill-server && adb -a nodaemon server start
 
-## ✅ 测试
+# 2. 启动 staff-mcp 并注入 ADB_SERVER_SOCKET 环境变量
+# Mac/Win 环境下：
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "-e ADB_SERVER_SOCKET=tcp:host.docker.internal:5037"
 
-这一节单独用于说明如何验证包是否可用，而不是日常使用方式。
+# 原生 Linux 环境下（若不使用 host 网络，可指向虚拟桥接 IP）：
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "-e ADB_SERVER_SOCKET=tcp:172.17.0.1:5037"
 
-### 验证已发布包
-
-```bash
-npx -y staff-mcp@latest --working-dir /tmp
+# 原生 Linux 的极简方案（直接与物理机共享网络栈）：
+npx -y staff-mcp@latest --docker reverse-engineer:v1 -D "--network host"
 ```
 
-### 验证本地构建
-
-```bash
-npm run build
-node dist/src/index.js --working-dir /tmp
-```
+---
 
-## 📄 开源协议
+## 📄 License
 
 MIT

package/dist/src/index.js

@@ -1,10 +1,16 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import * as path from "path";
+import * as fs from "fs";
+import * as os from "os";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
 import { createServer } from "./server.js";
 import { startStdioServer } from "./transports/stdio.js";
 import { startHttpServer } from "./transports/http.js";
 import { ensureStaffDirs } from "./utils/paths.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 const program = new Command();
 program
     .name("staff-mcp")
@@ -15,11 +21,107 @@ program
     .option("-h, --host <address>", "Host for HTTP server", "127.0.0.1")
     .option("-w, --working-dir <path>", "Working directory for the server (defaults to current execution path)", process.cwd())
     .option("-d, --allowed-dir <paths...>", "Additional directories allowed for sandbox", [])
-    .action(async (options) => {
+    .option("-r, --profile <name>", "The active profile for skills and instructions (e.g., developer, default)", "default")
+    .option("--docker <image>", "Run the MCP server inside a Docker container using the specified image")
+    .option("-D, --docker-args <args...>", "Additional arguments to pass to the docker run command (e.g., -e ADB_SERVER_SOCKET=...)")
+    .allowUnknownOption()
+    .action(async (options, command) => {
+    // -------------------------------------------------------------
+    // Docker Transparent Proxy Mode
+    // -------------------------------------------------------------
+    if (options.docker) {
+        // 1. Locate the package root (where package.json is)
+        let pkgRoot = path.resolve(__dirname, "..");
+        while (!fs.existsSync(path.join(pkgRoot, "package.json")) && pkgRoot !== "/") {
+            pkgRoot = path.dirname(pkgRoot);
+        }
+        // 2. Cross-platform path normalizer for Volume Mounts
+        const toDockerVolumePath = (p) => {
+            if (os.platform() === "win32") {
+                return p.replace(/^([a-zA-Z]):/, (_, drive) => `/${drive.toLowerCase()}`).replace(/\\/g, "/");
+            }
+            return p;
+        };
+        const hostCwd = path.resolve(options.workingDir);
+        const dockerArgs = ["run", "-i", "--rm"];
+        // 3. Mount working directory and package source
+        dockerArgs.push("-v", `${toDockerVolumePath(hostCwd)}:/workspace`);
+        dockerArgs.push("-w", "/workspace");
+        dockerArgs.push("-v", `${toDockerVolumePath(pkgRoot)}:/opt/staff-mcp:ro`);
+        // 4. Mount additional allowed directories
+        if (options.allowedDir && options.allowedDir.length > 0) {
+            options.allowedDir.forEach((dir) => {
+                const absDir = path.resolve(dir);
+                dockerArgs.push("-v", `${toDockerVolumePath(absDir)}:${absDir}`);
+            });
+        }
+        // 5. Handle HTTP port forwarding
+        if (options.transport === "http") {
+            dockerArgs.push("-p", `${options.port}:${options.port}`);
+        }
+        // 6. Inject advanced custom args (e.g., ADB pass-through, network configs)
+        if (options.dockerArgs && options.dockerArgs.length > 0) {
+            // commander parses varargs as an array of strings
+            options.dockerArgs.forEach((arg) => {
+                // simple split by space if the user quoted them (e.g., "-e FOO=1")
+                // If the user uses standard bash expansion, commander already handles it.
+                const parts = arg.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) || [arg];
+                parts.forEach(p => dockerArgs.push(p.replace(/^['"]|['"]$/g, '')));
+            });
+        }
+        // 7. Inject environment variable to detect docker proxy mode
+        dockerArgs.push("-e", "STAFF_MCP_IS_DOCKER=1");
+        // 8. Specify the target image
+        dockerArgs.push(options.docker);
+        // 9. Reconstruct the command inside the container
+        dockerArgs.push("node", "/opt/staff-mcp/dist/src/index.js");
+        dockerArgs.push("-t", options.transport);
+        dockerArgs.push("-p", String(options.port));
+        // Inside container, we must listen on all interfaces for HTTP to be exposed
+        if (options.transport === "http") {
+            dockerArgs.push("-h", "0.0.0.0");
+        }
+        else {
+            dockerArgs.push("-h", options.host);
+        }
+        dockerArgs.push("-w", "/workspace");
+        if (options.allowedDir && options.allowedDir.length > 0) {
+            options.allowedDir.forEach((dir) => {
+                dockerArgs.push("-d", path.resolve(dir)); // paths inside container match host
+            });
+        }
+        dockerArgs.push("-r", options.profile);
+        // 10. Spawn Docker and pipe I/O natively
+        const child = spawn("docker", dockerArgs, { stdio: ["pipe", "inherit", "inherit"] });
+        process.stdin.pipe(child.stdin);
+        child.on("exit", (code) => process.exit(code ?? 0));
+        child.on("error", (err) => {
+            console.error("[staff-mcp] Failed to start docker proxy:", err.message);
+            process.exit(1);
+        });
+        return; // Terminate host process execution
+    }
+    // -------------------------------------------------------------
+    // Standard Host Mode
+    // -------------------------------------------------------------
+    // Auto-exit if we are running as a proxy child and the host pipe breaks
+    if (process.env.STAFF_MCP_IS_DOCKER === "1") {
+        if (options.transport === "http") {
+            process.stdin.resume(); // keep reading to detect end in HTTP mode
+        }
+        process.stdin.on("end", () => {
+            console.error("[staff-mcp] Host pipe closed, terminating container...");
+            process.exit(0);
+        });
+        process.stdin.on("error", () => {
+            process.exit(1);
+        });
+    }
     ensureStaffDirs();
     const workingDir = path.resolve(options.workingDir);
     const allowedDirs = options.allowedDir.map((d) => path.resolve(d));
-    const server = createServer("staff-mcp", "1.0.0", workingDir, allowedDirs);
+    const profile = options.profile;
+    const server = createServer("staff-mcp", "1.0.0", workingDir, allowedDirs, profile);
     if (options.transport === "http") {
         await startHttpServer(server, parseInt(options.port, 10), options.host);
     }

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,wBAAwB,EAAE,gCAAgC,EAAE,OAAO,CAAC;KAC3E,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,CAAC;KAC7D,MAAM,CAAC,sBAAsB,EAAE,sBAAsB,EAAE,WAAW,CAAC;KACnE,MAAM,CAAC,0BAA0B,EAAE,uEAAuE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC1H,MAAM,CAAC,8BAA8B,EAAE,4CAA4C,EAAE,EAAE,CAAC;KACxF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,eAAe,EAAE,CAAC;IAClB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE3E,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/server.d.ts

@@ -5,6 +5,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
  * @param version The server's version.
  * @param workingDir The working directory for the server.
  * @param allowedDirs Additional directories for the SecurityManager.
+ * @param profile The active profile for skills and instructions.
  * @returns An initialized McpServer instance.
  */
-export declare function createServer(name: string, version: string, workingDir: string, allowedDirs: string[]): McpServer;
+export declare function createServer(name: string, version: string, workingDir: string, allowedDirs: string[], profile?: string): McpServer;

package/dist/src/server.js

@@ -3,7 +3,7 @@ import { SecurityManager } from "./security.js";
 import { registerFileTools } from "./tools/file-tools.js";
 import { registerShellTools } from "./tools/shell-tools.js";
 import { registerLspTools } from "./tools/lsp-tools.js";
-import { registerSkillTools } from "./tools/skill-tools.js";
+import { registerSkillTools } from "./tools/skills.js";
 import { getMcpInstructions } from "./tools/system-tools.js";
 /**
  * Creates and initializes a new McpServer with all functional tools.
@@ -11,9 +11,10 @@ import { getMcpInstructions } from "./tools/system-tools.js";
  * @param version The server's version.
  * @param workingDir The working directory for the server.
  * @param allowedDirs Additional directories for the SecurityManager.
+ * @param profile The active profile for skills and instructions.
  * @returns An initialized McpServer instance.
  */
-export function createServer(name, version, workingDir, allowedDirs) {
+export function createServer(name, version, workingDir, allowedDirs, profile = "default") {
     const security = new SecurityManager(workingDir, allowedDirs);
     // Generate instructions with system-specific details (OS, shell, etc.)
     const instructions = getMcpInstructions(workingDir, security);
@@ -28,7 +29,7 @@ export function createServer(name, version, workingDir, allowedDirs) {
     registerFileTools(server, security);
     registerShellTools(server, security);
     registerLspTools(server, security);
-    registerSkillTools(server, workingDir, security);
+    registerSkillTools(server, workingDir, security, profile);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,UAAkB,EAAE,WAAqB;IACnG,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAE9D,uEAAuE;IACvE,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI;QACJ,OAAO;KACR,EACD;QACE,yDAAyD;QACzD,YAAY;KACb,CACF,CAAC;IAEF,uCAAuC;IACvC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,UAAkB,EAAE,WAAqB,EAAE,UAAkB,SAAS;IAChI,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAE9D,uEAAuE;IACvE,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI;QACJ,OAAO;KACR,EACD;QACE,yDAAyD;QACzD,YAAY;KACb,CACF,CAAC;IAEF,uCAAuC;IACvC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/{tools/skill-manager.d.ts → skills/manager.d.ts}

@@ -5,9 +5,8 @@ export interface SkillInfo {
     content: string;
 }
 export declare class SkillManager {
-    private static readonly SEARCH_DIRS;
-    private static readonly SKILL_SUBDIRS;
-    static loadSkills(workingDir: string): Record<string, SkillInfo>;
+    static getSearchPaths(workingDir: string, profile?: string): string[];
+    static loadSkills(workingDir: string, profile?: string): Record<string, SkillInfo>;
     private static scanDirSync;
     private static addSkillSync;
     private static parseMarkdown;

package/dist/src/{tools/skill-manager.js → skills/manager.js}

@@ -1,31 +1,14 @@
 import * as fs from "fs";
 import * as path from "path";
-import * as os from "os";
+import { getSearchPaths } from "./resolver.js";
 export class SkillManager {
-    // 定义搜索的基准目录名（隐藏目录）
-    static SEARCH_DIRS = [".staff", ".claude", ".agents", ".opencode"];
-    // 定义技能子目录名
-    static SKILL_SUBDIRS = ["skills", "skill"];
-    static loadSkills(workingDir) {
+    static getSearchPaths(workingDir, profile = "default") {
+        return getSearchPaths(workingDir, profile);
+    }
+    static loadSkills(workingDir, profile = "default") {
         const skills = {};
-        const searchPaths = [];
-        // 0. 直接检查工作目录下的 skills (兼容旧逻辑)
-        searchPaths.push(path.join(workingDir, "skills"));
-        searchPaths.push(path.join(workingDir, "skill"));
-        // 1. 添加当前工作区搜索路径
-        this.SEARCH_DIRS.forEach(dir => {
-            this.SKILL_SUBDIRS.forEach(sub => {
-                searchPaths.push(path.join(workingDir, dir, sub));
-            });
-        });
-        // 2. 添加全局搜索路径 (用户主目录)
-        const homeDir = os.homedir();
-        this.SEARCH_DIRS.forEach(dir => {
-            this.SKILL_SUBDIRS.forEach(sub => {
-                searchPaths.push(path.join(homeDir, dir, sub));
-            });
-        });
-        // 3. 扫描所有有效路径
+        const searchPaths = this.getSearchPaths(workingDir, profile);
+        // 扫描所有有效路径
         for (const root of searchPaths) {
             if (fs.existsSync(root) && fs.statSync(root).isDirectory()) {
                 this.scanDirSync(root, skills);
@@ -60,7 +43,7 @@ export class SkillManager {
             const { data, content } = this.parseMarkdown(fileContent);
             // 确保有必要的元数据
             if (data.name && data.description) {
-                // 如果名称冲突，优先保留先扫描到的（项目本地优先于全局）
+                // 如果名称冲突，优先保留先扫描到的（优先级高的路径在前）
                 if (!skills[data.name]) {
                     skills[data.name] = {
                         name: data.name,
@@ -94,4 +77,4 @@ export class SkillManager {
         return { data, content: body };
     }
 }
-//# sourceMappingURL=skill-manager.js.map
+//# sourceMappingURL=manager.js.map