┌───────────────────────────┐
                               │   AI Client (Claude/Cursor)│
                               └─────────────┬─────────────┘
                                             │
                                     skill_search("...")
                                             │
                                             ▼
                      ┌──────────────────────────────────────────────┐
                      │                 Skill-MCP                    │
                      ├──────────────────────┬───────────────────────┤
                      │                      │                       │
     【按需检索】      ▼                      ▼     【强制注入】       │
  ┌─────────────────────────┐         ┌────────────────────────────┐ │
  │    Tool Skills (工具型)  │         │     Rule Skills (准则型)   │ │
  ├─────────────────────────┤         ├────────────────────────────┤ │
  │ • BM25 + 向量混合召回   │         │ • 跳过搜索竞争             │ │
  │ • 多技能工作流 DAG 规划 │         │ • 随每次检索无条件跟车附带 │ │
  │ • 沙箱隔离与 HITL 权限  │         │ • 强制规范 AI 思考与代码风格│ │
  └───────────┬─────────────┘         └────────────┬───────────────┘ │
              │                                    │                 │
              └──────────────────┬─────────────────┘                 │
                                 ▼                                   │
                      ┌──────────────────────┐                       │
                      │ 统一 Payload 返回给 AI│                       │
                      └──────────────────────┘                       │
                      └──────────────────────────────────────────────┘

skills/<namespace>/<skill-name>/
├── skill.json         # 1. 机器契约（元数据、IO Schema、权限、执行入口、skillType）
├── SKILL.md           # 2. AI 执行 SOP 指南（角色定位、正反例、步骤规范）
└── scripts/           # 3. 可执行脚本工具（自动化校验器、数据抓取脚本、转换器等）
    └── run.ts

{
  "schemaVersion": 1,
  "name": "naming-conventions",
  "namespace": "dev",
  "version": "1.0.0",
  "description": "代码与变量命名规范守门人：强制统一 AI 代码命名风格，约束布尔谓词、函数动词前缀与常量大写。",
  "category": "dev",
  "tags": ["naming-conventions", "code-style", "rules"],
  "triggers": ["naming", "variable", "refactor", "code"],
  "keywords": ["naming", "camelCase", "snake_case"],
  "whenToUse": "在生成、重构或审查任何编程语言的代码时必须遵守",
  "whenNotToUse": "编写纯文本说明或无代码生成的闲聊场景无需遵守",
  
  // 核心区分：'tool' (按需搜索工具) | 'rule' (永远生效的准则)
  "skillType": "rule",

  "useCases": [
    { "task": "审查并规范生成的变量与函数命名" }
  ],
  "preconditions": {},
  "io": {
    "input": { "semanticType": "text" },
    "output": { "semanticType": "text" }
  },
  "capabilities": ["dev:naming-conventions"],
  "consumes": [],
  "dependencies": [],
  "permissions": {
    "fsRead": ["*"],
    "fsWrite": [],
    "network": [],
    "tools": [],
    "env": [],
    "maxDurationMs": 5000,
    "maxCostCents": 0,
    "mutating": false
  },
  "entrypoint": {
    "kind": "inline",
    "code": "return { applied: true, rule: 'dev:naming-conventions' };"
  },
  "status": "active"
}

# 安装依赖
npm install

# 运行测试套件（91 项自动化测试）
npm test

# 启动 Stdio MCP 服务
npm start

# 启动 HTTP 服务，监听 0.0.0.0:3000
node src/main.ts --http --host 0.0.0.0 --port 3000

# 构建镜像
docker build -t skill-mcp:latest .

# 后台运行容器（数据持久化挂载）
docker run -d \
  -p 3000:3000 \
  --name skill-mcp \
  -v $(pwd)/data:/app/data \
  skill-mcp:latest

{
  "mcpServers": {
    "skill-mcp": {
      "command": "node",
      "args": ["/path/to/Skill-mcp/src/main.ts"]
    }
  }
}

{
  "mcpServers": {
    "remote-skill-mcp": {
      "url": "http://your-server-ip:3000/mcp"
    }
  }
}