一个MCP服务器,它公开 代理技能 创建指南(9个阶段)作为MCP资源。 AI代理仅按需检索所需的阶段,并按照此过程构建SKILL.md文件。
快速开始
克劳德代码:
claude mcp add skill-forge-mcp -- npx skill-forge-mcpGemini CLI:
gemini mcp add skill-forge-mcp -- npx skill-forge-mcpVS代码(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流程。”
代理将自动:
- 从以下位置获取流程结构
process://manifest - 阅读第1阶段(
process://phase/1)为了确定范围,运行基线测量 - 记录进度
mark_progress随着它在每个阶段的推进 - 根据第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 testsProject 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
贡献
欢迎投稿!请随意打开 问题 或提交拉取请求。
许可证
麻省理工学院
