Ben AI Toolkit

个人最强 AI 开发装备库 | Your Personal AI Development Arsenal

定位

这是彭勃的个人工具集，不是给任何人用的通用模板。

核心逻辑只有一条：

Skill = 知识库 + 工作流，Agent = 执行者，记忆系统 = 自我进化。

架构总览

ben-ai-toolkit/
├── agents/           7 个领域专家 Agent
├── skills/           12 个核心 Skill（含 ui-ux-pro-max）
├── rules/            全局规则 + 项目规则
├── memory/           自我进化记忆系统
├── hooks/            会话生命周期自动化
├── scripts/          钩子脚本
├── tools/            一键部署工具
└── docs/             使用指南

7 个领域专家 Agent

Agent = 执行者，Skill = 知识库。

| Agent | Skill | 专长领域 | |-------|-------|---------| | st-expert | st-expert | CODESYS ST / PLC 工业自动化 | | java-expert | java-expert | Java / Spring Boot 企业开发 | | python-expert | python-expert | Python / FastAPI / 数据分析 | | typescript-expert | typescript-expert | TypeScript / React / Node.js | | frontend-expert | frontend-design | UI/UX 设计 / React / CSS | | research | research | 行业调研 / 竞品分析 / 技术评估 | | architect | — | 系统架构设计决策 |

调用方式

skill:st-expert       "创建 PID 控制功能块"
skill:java-expert      "创建用户管理 Service"
skill:python-expert    "创建 FastAPI 认证模块"
skill:typescript-expert "创建用户列表组件"
skill:frontend-expert   "设计一个登录页面"
skill:research          "调研一下 PLC 行业市场"

11 个核心 Skill

工业自动化（ST）

| Skill | 用途 | 行数 | |-------|------|------| | st-expert | ST 知识库：IEC 规范、PID、通信、状态机 | 807 | | st-code-review | ST 代码审查：P0/P1/P2 检查清单 | 95 | | st-dev-workflow | ST 开发工作流：需求→实现→审查→文档 | 145 | | ui-ux-pro-max | UI/UX 设计情报库：50+样式、161色板、57字体 | — |

编程语言专家

| Skill | 用途 | 行数 | |-------|------|------| | java-expert | Java 知识库 | 549 | | python-expert | Python 知识库 | 527 | | typescript-expert | TypeScript 知识库 | 490 | | frontend-design | UI/UX 设计代码生成 | — |

通用能力

| Skill | 用途 | |-------|------| | research | 行业调研、竞品分析、技术评估 | | browser-use | 浏览器自动化（Playwright MCP） |

核心机制（OpenCode 内置）

| Skill | 用途 | |-------|------| | self-evolution | 自我进化：自动学习用户习惯 | | agent-system-creator | 创建多 Agent 协作系统 |

全局技能（已安装，skill 调用）

| Skill | 来源 | 用途 | |-------|------|------| | brainstorming | obra/superpowers | 头脑风暴，设计前置 | | prd | snarktank/ralph | 产品需求文档生成 | | test-driven-development | obra/superpowers | TDD 开发 | | code-quality | samhvw8 | 代码质量检查 | | refactoring-patterns | wondelai | 重构模式 | | systematic-debugging | obra/superpowers | 系统调试 | | requesting-code-review | obra/superpowers | 请求代码审查 | | verification-before-completion | obra/superpowers | 验证后再完成 | | writing-plans | obra/superpowers | 制定实现计划 | | dispatching-parallel-agents | obra/superpowers | 并行任务分发 |

以上均为全局安装，不需要 Agent，直接 skill:xxx 调用即可。

rules/
├── global/AGENTS.md       ← 全局规则
└── projects/
    └── st-codesys.md      ← ST 项目规则（仅 ST 项目生效）

记忆系统

memory/
├── hot-memory.md          ← 高频习惯（每次会话加载）
├── corrections.md         ← 纠正日志
└── instincts/             ← 本能行为

Hook 系统

| Hook | 时机 | 动作 | |------|------|------| | session-start | 会话开始 | 加载热记忆 | | session-end | 会话结束 | 保存状态 | | evaluate-session | 会话结束 | 提取学习模式 | | check-format | Write/Edit 后 | 检查格式 |

安装部署（Windows）

📋 前置依赖

1. 安装 Node.js

1. 访问 https://nodejs.org/
2. 下载 LTS 版本（推荐 v18+）
3. 安装后重启终端

2. 安装 OpenCode

winget install opencode-ai
# 或
npm install -g opencode

🚀 安装 Ben AI Toolkit

方式一：指定路径安装（推荐）

# 1. 克隆到指定路径
git clone https://github.com/BenPeng0205/ben-ai-toolkit.git D:\你的路径\ben-ai-toolkit

# 2. 进入目录
cd D:\你的路径\ben-ai-toolkit

# 3. 安装（自动安装所有组件并配置环境变量）
npm install

示例：

git clone https://github.com/BenPeng0205/ben-ai-toolkit.git D:\AI-Tools\ben-ai-toolkit
cd D:\AI-Tools\ben-ai-toolkit
npm install

方式二：默认路径安装

git clone https://github.com/BenPeng0205/ben-ai-toolkit.git
cd ben-ai-toolkit
npm install

📋 完整生命周期管理

更新工具集

cd D:\你的路径\ben-ai-toolkit
git pull && npm install

查看安装状态

cd D:\你的路径\ben-ai-toolkit
npm run status

显示内容：

• 项目信息和版本
• 依赖检查（Node.js、npm、OpenCode）
• 技能安装状态
• 配置目录状态
• 环境变量状态

修复损坏的安装

cd D:\你的路径\ben-ai-toolkit
npm run repair

自动修复：

• 缺失的技能
• 缺失的配置目录
• 缺失的 AGENTS.md

完全卸载

cd D:\你的路径\ben-ai-toolkit
npm run uninstall

卸载内容：

• 所有已安装的技能
• 环境变量配置
• 配置目录（~/.config/opencode）

卸载后可删除项目目录：

rmdir /s /q D:\你的路径\ben-ai-toolkit

🔄 命令速查表

| 命令 | 用途 | 使用场景 | |------|------|---------| | npm install | 安装 | 首次安装 | | git pull && npm install | 更新 | 获取最新版本 | | npm run status | 状态检查 | 确认安装是否正常 | | npm run repair | 修复 | 部分组件安装失败时 | | npm run uninstall | 卸载 | 完全移除工具集 |

✅ 安装完成后

1. 重启终端（使环境变量生效）
2. 启动 OpenCode
3. 测试技能： skill:brainstorming "测试"

🔧 常见问题

Q: 提示 "command not found: opencode" A: OpenCode 未安装，运行 npm install -g opencode

Q: 提示 "command not found: npx" A: Node.js 未安装，访问 https://nodejs.org/

Q: 技能安装卡住 A: 网络问题，脚本会自动重试，等待即可（最多5分钟）

Q: 安装后技能未生效 A: 运行 npm run status 检查状态，如有问题运行 npm run repair

Q: 卸载后如何重新安装 A: 重新克隆仓库并运行 npm install

更新日志

| 版本 | 日期 | 变更 | |------|------|------| | V5.0 | 2026-03-21 | 完整生命周期管理：install/update/uninstall/status/repair | | V4.0 | 2026-03-21 | 重构安装系统：git clone + npm install，支持指定路径，自动配置环境变量 | | V3.4 | 2026-03-21 | 实现npm包一键安装，支持自定义路径 | | V3.2 | 2026-03-20 | 新增 ui-ux-pro-max（71.7K installs，UI/UX 设计情报库） | | V3.1 | 2026-03-20 | 新增 frontend-expert + research（7 Agent 架构） | | V3.0 | 2026-03-20 | 五星级架构重构：10→7 Agent，精简 Skill | | V2.0 | 2026-03-19 | Agent+Skill 分层架构完成 |

作者：彭勃