技能构建MCP服务器

一个将AI技能创建指南(9个阶段)暴露为MCP资源的服务器,AI代理可按需检索阶段内容并遵循流程构建SKILL.md文件。

  • by popyson1648
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 popyson1648/skill-forge-mcp

使用说明

日本语

一个MCP服务器,它公开 代理技能 创建指南(9个阶段)作为MCP资源。 AI代理仅按需检索所需的阶段,并按照此过程构建SKILL.md文件。

快速开始

克劳德代码:

claude mcp add skill-forge-mcp -- npx skill-forge-mcp

Gemini CLI:

gemini mcp add skill-forge-mcp -- npx skill-forge-mcp

VS代码(GitHub副本) — .vscode/mcp.json:

{
  "servers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"]
    }
  }
}

光标:

{
  "skill-forge-mcp": {
    "command": "npx",
    "args": ["skill-forge-mcp"]
  }
}
Claude Desktop
{
  "mcpServers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"]
    }
  }
}

用法

问你的经纪人:

“我想为React组件设计创造一种技能。遵循SkillForge MCP流程。”

代理将自动:

  1. 从以下位置获取流程结构 process://manifest
  2. 阅读第1阶段(process://phase/1)为了确定范围,运行基线测量
  3. 记录进度 mark_progress 随着它在每个阶段的推进
  4. 根据第6阶段指南生成最终的SKILL.md

使用 search_process 用于跨阶段的关键字查找。

9个阶段

阶段 名称 目的
0 技能规格 Skill.md结构和正面
1 范围界定和基线 测量故障模式;确定研究范围
2 领域研究 建立质量标准和理论基础
3 差距分析 验证是否仅凭研究就能让代理采取行动
4 深度实现研究 用代码示例、反模式、验证来填补空白
5 结构和完整性 确认所有类别的覆盖范围
6 蒸馏成SKILL.md 冷凝成≤500线;最大化代币效率
7 部署和验证 放置、验证规范合规性、安全审查
8 评估和迭代 与基线进行比较,迭代改进

特性

  • 分阶段访问 --按阶段或部分粒度检索内容
  • 跨阶段搜索 --在所有9个阶段进行关键字搜索
  • 进度跟踪 --记录和查询每个阶段的完成状态
  • 提示模板 — create_skill 和 resume_skill 引导式工作流提示
  • 结构化输出 — outputSchema + structuredContent 关于所有用于程序化消费的工具
  • 状态持久性 --可选择在会话之间保留进度
  • 低开销 --上下文窗口的约1500个令牌固定成本

API

资源

URI 描述
process://manifest 完整索引(JSON)
process://phase/0 – process://phase/8 第0-8阶段内容

资源模板

模板 说明
process://phase/{phaseId}/section/{sectionName} 检索单个部分
process://phases/{+phaseIds} 批量检索(例如。 1,2,3)

工具

工具 描述 输入
search_process 所有阶段的关键字搜索 { "query": "frontmatter", "maxResults": 5 }
mark_progress 记录阶段进度 { "phaseId": 1, "status": "in-progress" }
get_status 所有阶段的进度总结 {}

status: "not-started" · "in-progress" · "completed"

提示

提示 描述
create_skill 完整的指导工作流程(阶段0→8). 接受a topic 争论。
resume_skill 从当前进度恢复。检查 get_status 并继续。

配置

集 SKILL_FORGE_PERSIST=true 坚持进步 ~/.skill-forge-mcp/state.json:

{
  "mcpServers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"],
      "env": { "SKILL_FORGE_PERSIST": "true" }
    }
  }
}

发展

git clone https://github.com/popyson1648/skill-forge-mcp.git
cd skill-forge-mcp
npm install
npm run build
npm test          # 52 tests
Project structure
src/
├── index.ts        # Entry point
├── content.ts      # Content loading & section extraction
├── search.ts       # Cross-phase search
├── state.ts        # State management & persistence
├── status.ts       # Status table formatter
├── content/        # English content (served)
└── content-ja/     # Japanese translations (developer reference only)
tests/
├── content.test.ts
├── search.test.ts
├── state.test.ts
├── resources.test.ts
└── tools.test.ts

要求: Node.js>=18

贡献

欢迎投稿!请随意打开 问题 或提交拉取请求。

许可证

麻省理工学院