SkillForge v1.5.1

AI Agent Skills 锻造炉 — 用 AI 自动锻造生产级 Agent Skills 的开源工具。

---

---

这是什么

SkillForge 是一个完整的 Web 应用，内置经过实战验证的 4 步 Agent Skills 生成引擎，严格对齐 Anthropic 官方 Agent Skills 规范。

它解决一个核心问题：如何让 AI 模型生成真正可用的、符合官方最佳实践的 Agent Skill，而不是内容过长、格式错误、无法触发的半成品。

---

核心功能

---

两大模式

创建新 Skill — 4 步生成流程

修正已有 Skill — 3 步优化流程

支持文本粘贴和 .md 文件上传两种输入方式。

---

版本历史

---

技术栈

---

快速开始

前置条件

• Node.js 22+
• pnpm
• MySQL 或 TiDB 数据库
• LLM 后端（三选一，见下方配置）

安装

git clone https://github.com/mmlong818/skillforge.git
cd skillforge

pnpm install

cp .env.example .env
# 编辑 .env 填入数据库连接和 LLM 配置

数据库初始化

按顺序执行 drizzle/ 目录下的迁移文件：

mysql -u user -p skillforge < drizzle/0000_striped_iron_man.sql
mysql -u user -p skillforge < drizzle/0001_legal_thor.sql
mysql -u user -p skillforge < drizzle/0002_supreme_gabe_jones.sql
mysql -u user -p skillforge < drizzle/0003_wet_vance_astro.sql
mysql -u user -p skillforge < drizzle/0004_concerned_mattie_franklin.sql

启动

# 开发模式
pnpm dev

# 生产构建
pnpm build
node dist/index.js

访问 http://localhost:3000 即可使用。

---

LLM 配置

支持三种后端，按优先级选择其一：

方式一：Claude CLI（本地订阅，推荐）

CLAUDE_CLI=true
CLAUDE_CLI_PATH=claude   # Windows 示例：C:\Users\xxx\AppData\Roaming\npm\claude.cmd

需已安装并登录 Claude Code CLI。

方式二：Anthropic API Key

ANTHROPIC_API_KEY=sk-ant-xxxxx
LLM_MODEL=claude-sonnet-4-6   # 可选，默认 claude-sonnet-4-6

方式三：OpenAI-compatible API

BUILT_IN_FORGE_API_URL=https://api.openai.com
BUILT_IN_FORGE_API_KEY=sk-xxxxx
LLM_MODEL=gpt-4o

支持 OpenAI、DeepSeek、Together AI、Ollama 等任何兼容 /v1/chat/completions 的提供商。

---

本地开发

无需 OAuth 服务器，启用 LOCAL_DEV 模式即可直接以管理员身份访问：

LOCAL_DEV=true

---

项目结构

skillforge/
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── skill/                 # Manus Skill（轻量版，无需部署）
│   ├── SKILL.md
│   └── references/
│       └── step-prompts.md
├── client/                # 前端 React 应用
│   └── src/
│       ├── pages/         # Home, Generate, History
│       └── components/
├── server/                # 后端 Express + tRPC
│   ├── skillEngine.ts     # 4 步生成引擎
│   ├── fixEngine.ts       # 3 步修正引擎
│   ├── prompts.json       # 提示词配置
│   ├── routers.ts
│   └── db.ts
├── drizzle/               # 数据库 Schema 和迁移
└── shared/                # 前后端共享类型

---

Skill 质量标准

SkillForge 生成的每个 Skill 严格对齐 Anthropic 官方规范：

---

许可证

本项目采用 CC BY-NC-SA 4.0 许可证。

如需商业授权，请联系作者。

---

作者

猫叔 — AI 技术专家

与 Claude Code 协作构建。