
文章正文
这套源码属于 AI 编程代理的「环境脚手架」类命令行工具,解决的是「每次接手新项目都要手动配代理、装技能、接 MCP」的麻烦。
它只需要一条 `ai-factory init`,就能按你选用的代理(Claude Code、Cursor、Codex、Windsurf 等)自动安装对应技能、写入 MCP 配置并生成子代理模板。
从代码看,它的核心在 src/core 下:agents.ts 管理代理清单、installer.ts 负责安装注入、mcp.ts / mcp-toml.ts 生成 MCP 配置、transformer.ts 做代理专属转换。
仓库还内置了一整套 aif-* 斜杠命令技能(探索、规划、实现、修复、CI、文档、Docker 化等)以及 claude / codex 的子代理包。
如果你在搭自己的 AI 编码工作流,或想研究怎么给多种代理做统一配置,这套命令式的脚手架结构很值得参考。
源码简介
这套源码属于 AI 编程代理辅助工具类项目,围绕「一键初始化 AI 编码开发环境」展开。它用 Node.js 命令行工具,把技能安装、MCP 服务器配置与子代理模板统一封装,支持 Claude Code、Cursor、Codex 等多种代理。适合研究 AI 编码工作流、代理配置管理与 slash 命令技能的开发者做本地部署测试与二次开发参考。
适用场景
- AI 编程代理(Claude Code / Cursor / Codex 等)环境快速搭建
- 团队统一 AI 编码规范与 slash 命令技能管理
- 研究多代理配置注入与 MCP 自动编排
技术栈与运行环境
- 语言:Node.js + TypeScript(package.json type=module)
- CLI 框架:commander,交互用 inquirer,终端着色 chalk,文件操作 fs-extra
- 构建:tsc 编译到 bin/ai-factory.js
- 配置生成:MCP TOML/JSON 模板(src/core/mcp*.ts)、代理转换(transformer.ts)
- 运行环境:Node.js 环境,需 npm 全局或 npx 运行;支持 mise 管理
- 其他:内置 skills/ 技能目录、subagents/ 子代理包、mcp/ 模板
功能亮点
- 一键初始化:bin/ai-factory.js 提供 `ai-factory init`,交互或 `–agents/–mcp/–skills` 参数非交互完成环境搭建。
- 多代理支持:src/core/agents.ts 维护代理清单,支持 Claude Code、Cursor、Windsurf、Codex、Gemini CLI 等多种编码代理。
- 技能安装:skills/ 下含 aif、aif-ci、aif-commit、aif-docs、aif-dockerize、aif-fix、aif-plan 等一整套 aif-* 斜杠命令技能。
- MCP 配置生成:src/core/mcp.ts 与 mcp-toml.ts 负责生成 MCP 服务器配置,mcp/ 提供模板。
- 子代理模板:subagents/ 下含 claude 与 codex 的子代理包,可注入到对应代理工作区。
- 规范化工件:内置 AGENTS.md 与 docs/ 开发流(探索、规划、实现、修复、质量门),强调 spec-driven 可复现开发。
安装与部署提示
- 环境:安装 Node.js(建议 LTS),可选 mise 管理版本。
- 安装:执行 `npm install -g ai-factory`,或 `npx skills add lee-to/ai-factory` 仅取技能文件。
- 初始化:在项目目录运行 `ai-factory init`,按向导选择代理与需要安装的技能、MCP。
- 非交互:用 `ai-factory init –agents claude,codex –mcp playwright,github` 直接指定。
- 使用:在代理中输入 `/aif` 等命令进入工作流(Codex 系用 `$aif` 风格调用)。
截图与演示说明
安全风险提示
特别提示:本源码未检测安全风险文件,下载后请务必进行安全审计,删除恶意代码后再部署使用!
补充提示:该仓库未随包附带明确 LICENSE 文件(GitHub 显示为未声明授权),下载与二次开发前请自行确认授权范围与版权,商用需获得作者许可。
下载说明
源码仅供学习研究、测试部署和二次开发参考,商用前请自行确认授权、版权和安全风险。
GitHub开源地址:https://github.com/lee-to/ai-factory


