leniu-dev 2.0.0

package/AGENTS.md

@@ -0,0 +1,275 @@
+# AGENTS.md - [项目名称] 开发规范
+
+> ⚠️ **这是示例模板，安装后请替换为你的项目实际规范**
+> 需要修改：项目名称、技术栈描述、架构规范、禁止事项、代码模板
+
+## 对话语言设置
+
+**重要**: 在此代码库中工作时，必须始终使用**中文**与用户对话。
+
+> **项目说明**：[在此填写你的项目简介，例如：本项目是 XXX 后端服务]
+>
+> **技术栈**：[例如：Spring Boot 3.x + MyBatis-Plus + Redis + Sa-Token]
+>
+> **架构**：[例如：三层架构（Controller → Service → Mapper）]
+
+---
+
+## 术语约定
+
+| 术语 | 含义 | 对应目录 |
+|------|------|---------|
+| **后端** | Java 服务 | `[你的模块目录]/` |
+| **前端** | PC 管理端 | `[前端目录]/`（如存在） |
+| **公共模块** | 通用工具 | `[公共模块目录]/` |
+
+---
+
+## MCP 工具触发
+
+| 触发词 | 工具 | 用途 |
+|-------|------|------|
+| 深度分析、仔细思考、全面评估 | `sequential-thinking` | 链式推理，多步骤分析 |
+| 最佳实践、官方文档、标准写法 | `context7` | 框架官方文档查询 |
+| 打开浏览器、截图、检查元素 | `chrome-devtools` | 浏览器调试 |
+
+---
+
+## 🔴 Skills 技能系统（最高优先级）
+
+> **技能系统确保 AI 在编码前加载领域专业知识，保证代码风格一致**
+
+### 技能系统工作原理
+
+技能文件存储在 `.codex/skills/[skill-name]/SKILL.md` 中。
+
+**任务匹配时**：读取匹配技能的完整 SKILL.md 内容
+**需要时**：可进一步读取技能目录下的 `references/`、`scripts/` 等文件
+
+---
+
+## 技能清单与触发条件
+
+### 后端开发技能
+
+| 技能名称 | 触发条件 |
+|---------|---------|
+| `crud-development` | CRUD 开发、业务模块、Entity/Service/Mapper 创建 |
+| `database-ops` | 数据库操作、SQL、建表、字典、菜单配置 |
+| `api-development` | API 接口设计、RESTful、接口规范 |
+| `utils-toolkit` | 工具类、StringUtils 等 |
+| `error-handler` | 异常处理、错误处理规范 |
+| `security-guard` | 安全、认证授权、加密 |
+| `data-permission` | 数据权限、行级权限 |
+| `tenant-management` | 多租户、租户隔离 |
+| `workflow-engine` | 工作流、审批流 |
+| `scheduled-jobs` | 定时任务 |
+| `redis-cache` | Redis、缓存、分布式锁 |
+| `json-serialization` | JSON 序列化、反序列化 |
+| `file-oss-management` | 文件上传、OSS、云存储 |
+| `sms-mail` | 短信、邮件发送 |
+| `social-login` | 第三方登录、OAuth |
+| `websocket-sse` | WebSocket、SSE、实时推送 |
+| `backend-annotations` | 注解使用规范 |
+
+### 通用技能
+
+| 技能名称 | 触发条件 |
+|---------|---------|
+| `architecture-design` | 架构设计、模块划分、重构 |
+| `code-patterns` | 代码规范、命名、禁止事项 |
+| `git-workflow` | Git、提交、commit、分支 |
+| `tech-decision` | 技术选型、方案对比 |
+| `brainstorm` | 头脑风暴、创意、方案设计 |
+| `lanhu-design` | 蓝湖设计稿、原型图、蓝湖链接、设计图、切图 |
+| `task-tracker` | 任务跟踪、进度管理 |
+| `test-development` | 测试、单元测试 |
+| `auto-test` | API 自动化测试、Hurl、接口测试、测试报告、回归测试 |
+| `analyze-requirements` | 需求分析全流程编排（原型图/云效任务 → 开发任务清单） |
+| `fix-bug` | 修复 Bug 全流程编排（排查+修复+提交） |
+| `bug-detective` | Bug 排查、报错、异常 |
+| `performance-doctor` | 性能优化、慢查询、缓存 |
+| `add-skill` | 添加技能、创建技能文档 |
+| `collaborating-with-codex` | 与 Codex 协同分析 |
+| `collaborating-with-gemini` | 与 Gemini 协同设计 |
+| `codex-code-review` | 代码审查 |
+| `leniu-marketing-scenario` | 营销规则开发（折扣/满减/限额/限次/补贴/充值赠送/扣款/就餐规则） |
+| `jenkins-deploy` | 打包部署（Jenkins 构建 + Portainer 更新，dev/test 环境） |
+
+### OpenSpec 规格驱动开发技能（SDD）
+
+> 完整工作流：`/opsx:new` → `/opsx:ff` → `/opsx:apply` → `/opsx:archive`
+
+| 技能名称 | 触发条件 |
+|---------|---------|
+| `openspec-new-change` | 新建变更、/opsx:new |
+| `openspec-ff-change` | 快速推进、/opsx:ff |
+| `openspec-apply-change` | 实现任务、/opsx:apply |
+| `openspec-verify-change` | 验证实现、/opsx:verify |
+| `openspec-archive-change` | 归档变更、/opsx:archive |
+
+---
+
+## 多模型分层 Agent 系统
+
+> 按思维深度分层，不同 Agent 使用不同模型，各司其职。
+
+### Haiku 层 — 数据获取（快、省）
+
+| Agent | 模型 | 职责 | 触发场景 |
+|-------|------|------|---------|
+| `code-scanner` | haiku | 代码库扫描 + 文件定位 + 代码片段收集 | 任务开始前的代码探索、模块结构了解、相似实现查找 |
+| `loki-runner` | haiku | Loki 日志查询 + 格式化 | Bug 排查、线上问题、traceId 追踪 |
+| `mysql-runner` | haiku | MySQL 只读查询 + 格式化 | 数据排查、验证数据状态 |
+| `task-fetcher` | haiku | 云效任务获取 + 整理 | 需求同步、任务查询 |
+| `image-reader` | haiku | 截图/图片/Axure原型图内容提取 | 错误截图、表格截图、架构图、Axure原型分析 |
+
+### Sonnet + Codex 层 — 代码分析（理解、推理）
+
+| Agent | 模型 | 职责 | 触发场景 |
+|-------|------|------|---------|
+| `bug-analyzer` | sonnet | Bug 根因分析 + Codex 逻辑分析 | 接收 Haiku 层数据后分析根因 |
+| `code-reviewer` | sonnet | 规范检查 + Codex 逻辑审查 | /dev、/crud 完成后、代码审查 |
+
+### Opus 层 — 需求分析 + 架构决策 + 编码
+
+| Agent | 模型 | 职责 | 触发场景 |
+|-------|------|------|---------|
+| `requirements-analyzer` | opus | 需求分析，协调 Haiku 层提取数据并输出开发任务清单 | Axure 原型分析、需求转开发任务 |
+
+主会话也使用 Opus 模型，负责：
+- 接收各层 Agent 的结构化结果
+- 做出架构决策
+- 编写核心业务代码
+- 协调各层 Agent 工作
+
+### 协作流程示例
+
+```
+功能开发流程：
+  Opus 主会话 → 启动 Haiku 层扫描
+    └─ code-scanner(Haiku) → 代码扫描报告（文件清单、关键片段、依赖关系）
+                   │
+                   ▼ 基于扫描结果决策
+  Opus 主会话 → /dev 或 /crud 编写代码（不再自己做初始扫描）
+                   │
+                   ▼ 代码完成
+  Opus 主会话 → 启动审查
+    └─ code-reviewer(Sonnet+Codex) → 审查报告
+
+需求分析流程（analyze-requirements 技能编排）：
+  Opus 主会话 → 复杂度判断
+    │
+    ├─ 简单需求 → 直接分析输出任务清单 → 推荐 /crud 或 /dev
+    │
+    └─ 复杂需求 → 启动 requirements-analyzer(Opus)
+       └─ 按信息量并行调用 Haiku 层
+          ├─ image-reader(Haiku) × N张 → 原型图结构（有截图时）
+          ├─ task-fetcher(Haiku) → 云效任务信息（有任务号时）
+          └─ 汇总分析 → 输出需求分析报告 + 开发任务清单
+                      │
+                      ▼ 按任务清单开发
+  Opus 主会话 → code-scanner(Haiku) 扫描 → /dev 编写代码
+                      │
+                      ▼ 代码完成
+  Opus 主会话 → 启动审查
+    └─ code-reviewer(Sonnet+Codex) → 审查报告
+
+Bug 修复流程（fix-bug 技能编排）：
+  Opus 主会话 → 复杂度判断
+    │
+    ├─ 简单 Bug → 直接读代码修复 → git-workflow 提交
+    │
+    └─ 复杂 Bug → 按信息量并行启动 Agent
+       ├─ bug-analyzer(Sonnet+Codex) → 根因分析（必启动）
+       ├─ loki-runner(Haiku)  → 日志数据（有 traceId 时）
+       ├─ mysql-runner(Haiku) → 数据库数据（有 DB 信息时）
+       └─ code-scanner(Haiku) → 相关代码结构（需要时）
+                      │
+                      ▼ 汇总 Agent 结果
+    Opus 主会话 → 确认修复方案 → 编写修复代码
+                      │
+                      ▼ 代码完成
+    Opus 主会话 → 启动审查
+      └─ code-reviewer(Sonnet+Codex) → 审查报告
+                      │
+                      ▼ 审查通过
+    git-workflow 提交（必须通过技能，禁止直接 git commit）
+```
+
+---
+
+## 🚨 强制执行规则
+
+### 规则 1：任务匹配时必须读取技能
+
+当用户请求与上述任何技能的触发条件匹配时，**必须**：
+
+1. 读取对应的 `SKILL.md` 文件
+2. 按照技能中的指令执行
+3. 如果技能目录有 `references/`，按需读取相关文件
+
+### 规则 2：多技能组合
+
+复杂任务可能匹配多个技能，应：
+
+1. 识别所有相关技能
+2. 按依赖顺序读取（如：先 `database-ops` 再 `crud-development`）
+3. 综合所有技能的规范执行
+
+### 规则 3：响应中标注已使用技能
+
+在涉及代码的响应中，简要说明使用了哪些技能：
+
+```
+已参考技能：crud-development, database-ops
+
+[实现代码...]
+```
+
+---
+
+## 🚫 核心禁止事项
+
+> ⚠️ **请替换为你的项目实际禁止事项**
+
+```
+// ❌ [在此填写你的项目禁止写法]
+// ✅ [在此填写正确写法]
+```
+
+---
+
+## 🏗️ 核心架构
+
+> ⚠️ **请替换为你的项目实际架构**
+
+```
+[在此描述你的项目架构，例如：]
+
+Controller（接收请求、参数校验）
+    ↓
+Service（业务逻辑）
+    ↓
+Mapper（数据访问）
+```
+
+---
+
+## 快速命令
+
+| 命令 | 用途 |
+|------|------|
+| `/dev` | 开发新功能（完整流程） |
+| `/crud` | 快速生成 CRUD |
+| `/check` | 代码规范检查 |
+| `/start` | 项目快速了解 |
+| `/progress` | 查看项目进度 |
+
+---
+
+## 🤝 维护与贡献 Skills
+
+> 团队成员可以在本地修改 Skills 并将改动贡献回框架
+
+详见 [CONTRIBUTING.md](./CONTRIBUTING.md)

package/CLAUDE.md

@@ -0,0 +1,285 @@
+# CLAUDE.md - [你的项目名称]
+
+> **这是示例模板**。安装后请将 `[你的xxx]` 占位符替换为你的项目实际信息。
+> 如果项目有专属技能（如 `leniu-*`），它们会覆盖同名通用技能的规范。
+
+## Workflow Orchestration
+
+### 1. Plan Mode Default
+- Enter plan mode for ANY non-trivial task (3+ steps or architectural decisions)
+- If something goes sideways, STOP and re-plan immediately - don't keep pushing
+- Use plan mode for verification steps, not just building
+- Write detailed specs upfront to reduce ambiguity
+
+### 2. Agent Team Strategy
+- Use subagents liberally to keep main context window clean
+- One task per subagent for focused execution
+- **Parallel execution**: Launch independent agents concurrently (research + exploration + analysis in one message)
+- **Background agents**: Use `run_in_background` for long-running tasks, continue other work while waiting
+- **Agent type selection**: Match agent to task — `Explore` for codebase search, `Plan` for architecture, `bug-analyzer` for debugging, `general-purpose` for complex multi-step work
+- **Resume capability**: Resume completed agents by ID for follow-up work instead of starting fresh
+- For complex problems, decompose into parallel agents — throw more compute at it
+
+### 3. Self-Improvement Loop
+- After ANY correction from the user: update `tasks/lessons.md` with the pattern
+- Write rules for yourself that prevent the same mistake
+- Ruthlessly iterate on these lessons until mistake rate drops
+- Review lessons at session start for relevant project
+
+### 4. Verification Before Done
+- Never mark a task complete without proving it works
+- Diff behavior between main and your changes when relevant
+- Ask yourself: "Would a staff engineer approve this?"
+- Run tests, check logs, demonstrate correctness
+
+### 5. Demand Elegance (Balanced)
+- For non-trivial changes: pause and ask "is there a more elegant way?"
+- If a fix feels hacky: "Knowing everything I know now, implement the elegant solution"
+- Skip this for simple, obvious fixes - don't over-engineer
+- Challenge your own work before presenting it
+
+### 6. Autonomous Bug Fixing
+- When given a bug report: just fix it. Don't ask for hand-holding
+- Point at logs, errors, failing tests - then resolve them
+- Zero context switching required from the user
+- Go fix failing CI tests without being told how
+
+## Task Management
+
+1. **Plan First**: Write plan to `tasks/todo.md` with checkable items
+2. **Verify Plan**: Check in before starting implementation
+3. **Track Progress**: Mark items complete as you go
+4. **Explain Changes**: High-level summary at each step
+5. **Document Results**: Add review section to `tasks/todo.md`
+6. **Capture Lessons**: Update `tasks/lessons.md` after corrections
+
+## Core Principles
+
+- **Simplicity First**: Make every change as simple as possible. Impact minimal code.
+- **No Laziness**: Find root causes. No temporary fixes. Senior developer standards.
+- **Minimal Impact**: Changes should only touch what's necessary. Avoid introducing bugs.
+
+---
+
+## 语言设置
+**必须使用中文**与用户对话。
+
+## 术语约定
+
+> 根据你的项目实际情况填写术语表。
+
+| 术语 | 含义 | 路径 |
+|------|------|------|
+| **后端** | Java 服务 | `[你的后端根目录]/` |
+| **前端** | 管理端 | `[你的前端目录]/` |
+| **模块A** | 核心业务 | `[你的模块A路径]/` |
+| **模块B** | 辅助业务 | `[你的模块B路径]/` |
+| **公共模块** | 基础公共 | `[你的公共模块路径]/` |
+
+## 前端技术栈
+
+> 根据你的项目前端技术栈填写。
+
+| 技术 | 版本 | 说明 |
+|------|------|------|
+| [框架] | [版本] | [API 风格] |
+| [UI 库] | [版本] | [组件前缀] |
+| [状态管理] | [版本] | [配置说明] |
+| [路由] | [版本] | [路由模式] |
+
+## MCP 工具触发
+
+| 触发词 | 工具 |
+|-------|------|
+| 深度分析、仔细思考、全面评估 | `sequential-thinking` |
+| 最佳实践、官方文档、标准写法 | `context7` |
+| 打开浏览器、截图、检查元素 | `chrome-devtools` |
+
+## Skills 强制评估
+
+> UserPromptSubmit Hook 会注入评估提示，**必须严格遵循**。
+
+1. **评估**：列出匹配的技能
+2. **激活**：逐个调用 `Skill(技能名)`（串行，不能并行）
+3. **实现**：所有技能激活完成后开始
+
+**Skills 位置**：`.claude/skills/[skill-name]/SKILL.md`
+
+---
+
+## 核心规范速查
+
+> 根据你的项目规范填写。
+
+| 项目 | 规范 |
+|------|------|
+| **包名** | `[你的包名]` |
+| **JDK** | [版本] |
+| **框架** | [框架名称 + 版本] |
+| **架构** | [你的分层架构] |
+| **异常** | `[你的业务异常类]` |
+| **对象转换** | `[你的对象转换工具]` |
+| **权限** | `[你的权限注解]` |
+| **ID 生成** | `[你的ID生成策略]` |
+| **验证** | `jakarta.validation.*` |
+
+## 分层架构说明
+
+> 根据你的项目选择三层或四层架构。
+
+| 层 | 职责 | 命名示例 |
+|----|------|---------|
+| Controller | 接收请求、参数校验、路由 | `OrderController` |
+| Service | 业务逻辑、事务管理 | `OrderService` |
+| Mapper | ORM 映射 | `OrderMapper` |
+
+## 标准包结构
+
+```
+[你的包名].[module]/
+├── controller/         # 接口层
+├── service/impl/       # 服务层
+├── mapper/             # 数据访问层
+├── model/              # Entity
+├── vo/                 # 响应对象
+├── dto/                # 请求参数
+├── constants/          # 枚举和常量
+└── config/             # 配置类
+```
+
+## Entity 审计字段
+
+> 根据你的项目审计字段命名填写。
+
+| 字段 | 含义 | 填充时机 |
+|------|------|---------|
+| `create_by` | 创建人 | INSERT |
+| `create_time` | 创建时间 | INSERT |
+| `update_by` | 更新人 | INSERT_UPDATE |
+| `update_time` | 更新时间 | INSERT_UPDATE |
+| `deleted` | 逻辑删除（0=正常，1=删除） | 手动 |
+
+## 工具类速查
+
+> 根据你的项目使用的工具类填写。
+
+| 工具 | 用途 |
+|------|------|
+| `[对象转换工具]` | 对象转换 |
+| `[集合工具]` | 集合判空/操作 |
+| `[字符串工具]` | 字符串处理 |
+| `[业务异常类]` | 抛出业务异常 |
+| `[分页工具]` | 分页查询 |
+
+## 绝对禁止
+
+```java
+// ❌ 旧验证包（JDK 17+ 必须用 jakarta）
+import javax.validation.constraints.*;
+// ✅ 使用 jakarta
+import jakarta.validation.constraints.*;
+
+// ❌ Map 传递业务数据
+Map<String, Object> result = new HashMap<>();
+// ✅ 使用 VO/DTO
+return new OrderVO(order);
+
+// ❌ 在 Controller 直接操作数据库
+// ✅ 通过 Service 层
+
+// ❌ 硬编码配置值
+String url = "http://localhost:8080";
+// ✅ 使用配置文件
+@Value("${app.url}") String url;
+```
+
+## 数据库规范
+
+```sql
+CREATE TABLE [表名] (
+    id          BIGINT       NOT NULL COMMENT '主键',
+    -- 业务字段...
+    create_by   VARCHAR(64)  COMMENT '创建人',
+    create_time DATETIME     COMMENT '创建时间',
+    update_by   VARCHAR(64)  COMMENT '更新人',
+    update_time DATETIME     COMMENT '更新时间',
+    deleted     INT DEFAULT 0 COMMENT '逻辑删除(0-正常,1-删除)',
+    PRIMARY KEY (id)
+);
+```
+
+## 开发模式选择指南
+
+根据功能复杂度和开发类型，选择合适的工作流：
+
+### 复杂度路由表
+
+| 复杂度 | 判断标准 | 推荐工作流 | 说明 |
+|--------|---------|-----------|------|
+| **轻量** | 单表 CRUD、字段增删、简单查询 | `/dev` 或 `/crud` 直接开发 | 无需需求拆解 |
+| **中等** | 2-3 张表联动、跨 Service 调用、状态流转 | `/dev` 开发（可选 OpenSpec） | 建议先理清逻辑再编码 |
+| **复杂** | 多模块协作、复杂业务流程、需要设计评审 | OpenSpec → `/dev` | 先用 `/opsx:ff` 生成制品，再按 tasks 逐步实现 |
+| **大型项目** | 新项目从零开始、10+ 文件重构、多阶段里程碑 | `/gsd:new-project` 或 `/gsd:plan-phase` | GSD 编排 + Skills 执行 |
+
+### 开发类型路由
+
+| 类型 | 特征 | 工作流 |
+|------|------|--------|
+| **产品开发（core 迭代）** | 改 core 代码、会有后续迭代 | 复杂功能用 OpenSpec 拆解，简单功能直接 `/dev` |
+| **项目定制（一次性）** | Dz 前缀类、dz_ 表、@Primary 覆盖 | 直接 `/dev`，参考 `leniu-customization-location` 技能 |
+
+### OpenSpec 与 Commands 的关系
+
+```
+OpenSpec（思考）          Commands（执行）
+───────────────          ──────────────
+proposal.md    ────→    /dev（按 task 逐个开发）
+specs/*.md     ────→    /crud（快速生成 CRUD）
+design.md      ────→    /check（验证规范）
+tasks.md       ────→    /progress（跟踪进度）
+```
+
+> **原则**：OpenSpec 负责需求拆解和设计决策，Commands 负责代码生成和质量管控。简单任务跳过 OpenSpec，直接用 Commands。
+
+## 快速命令
+
+| 命令 | 用途 |
+|------|------|
+| `/dev` | 开发新功能 |
+| `/crud` | 快速生成 CRUD |
+| `/check` | 代码规范检查 |
+| `/next` | 下一步建议（含 OpenSpec 变更扫描） |
+| `/progress` | 项目进度（含 OpenSpec 状态） |
+
+## GSD 集成（大型任务编排）
+
+本框架与 [GSD (Get Shit Done)](https://github.com/gsd-build/get-shit-done) 深度集成。GSD 负责项目编排，Skills 负责代码执行。
+
+### GSD + Skills 协作模式
+
+| GSD 阶段 | 自动激活的 Skills/Agents |
+|----------|------------------------|
+| `/gsd:debug` | 优先使用 `loki-runner` 查日志 + `mysql-runner` 查数据库 + `bug-analyzer` 根因分析 |
+| `/gsd:execute-phase` | 读取 `.claude/skills/` 自动应用项目编码规范（CRUD、API、数据库等） |
+| `/gsd:plan-phase` | 参考 Skills 中的架构设计和模块划分规范 |
+| `/gsd:verify-work` | 可调用 `auto-test-generator` 生成接口测试验证 |
+
+### 可用的领域 Agents（GSD 子 agent 可调用）
+
+| Agent | 能力 | 适用场景 |
+|-------|------|---------|
+| `loki-runner` | 查 Grafana Loki 线上日志 | debug 时查错误日志、traceId 链路 |
+| `mysql-runner` | 查 MySQL 数据库验证数据 | debug 时验证数据状态 |
+| `bug-analyzer` | 根因分析（含日志+数据库联动） | 复杂 Bug 的多维度排查 |
+| `code-scanner` | 快速扫描代码库定位文件 | 大型代码库的文件定位 |
+| `auto-test-generator` | 生成 Hurl 接口测试 | verify-work 阶段验证 |
+| `image-reader` | 读取 Axure 原型截图 | 需求分析阶段 |
+| `task-fetcher` | 获取云效任务信息 | 任务管理联动 |
+| `code-reviewer` | 代码审查（含 leniu 规范） | 执行完成后质量检查 |
+
+### 环境配置（GSD agent 共享）
+
+GSD 子 agent 可读取以下配置（全局或本地）：
+- `mysql-config.json` — 数据库连接（支持 range 环境匹配）
+- `loki-config.json` — Grafana Loki Token
+- 初始化：`npx ai-engineering-init config --type all --scope global`

package/README.md

@@ -0,0 +1,104 @@
+# leniu-dev
+
+> 🐂 AI 工程化开发工具 — 一键安装 Skills、Commands、Hooks 到 Claude Code / Cursor / Codex
+
+[![npm version](https://img.shields.io/npm/v/leniu-dev)](https://www.npmjs.com/package/leniu-dev)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+## 快速开始
+
+```bash
+# 交互式安装向导（推荐）
+npx leniu-dev install
+
+# 或直接指定工具和角色
+npx leniu-dev install --tool claude --role backend
+```
+
+安装向导会引导你完成 5 个步骤：
+1. **选择角色** — 后端研发 / 前端研发 / 产品经理 / 全部
+2. **选择工具** — Claude Code / Cursor / Codex / 全部
+3. **配置服务** — MySQL / Loki（可跳过）
+4. **安装 MCP** — 推荐 MCP 服务器一键安装
+5. **确认安装** — 查看摘要后开始
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `npx leniu-dev install` | 交互式安装向导 |
+| `npx leniu-dev@latest update` | 更新已安装的框架文件 |
+| `npx leniu-dev syncback` | 推送本地技能修改到源仓库 |
+| `npx leniu-dev config` | 环境配置（MySQL / Loki） |
+| `npx leniu-dev mcp` | MCP 服务器管理 |
+| `npx leniu-dev doctor` | 诊断安装状态 |
+| `npx leniu-dev uninstall` | 卸载已安装文件 |
+| `npx leniu-dev help` | 显示帮助 |
+
+> 运行 `npx leniu-dev help` 查看全部选项和示例。
+
+## 角色化安装
+
+不同角色安装不同的技能包，通用技能（导航/Git/审查/云效等）所有角色都有：
+
+| 角色 | 技能数 | 包含内容 |
+|------|--------|---------|
+| 🖥️ 后端研发 | 89 | CRUD/API/数据库/异常/日志/MQ/Redis/部署/测试... |
+| 🎨 前端研发 | 41 | UI组件/Vuex/Gemini协作/Git... |
+| 📋 产品经理 | 37 | 需求分析/蓝湖/图片生成/任务管理... |
+| 🔧 全部 | 91 | 所有技能 |
+
+```bash
+npx leniu-dev install --tool claude --role backend   # 后端研发
+npx leniu-dev install --tool claude --role frontend  # 前端研发
+npx leniu-dev install --tool claude --role product   # 产品经理
+```
+
+## 3 分钟上手
+
+```bash
+# 第一步：安装
+npx leniu-dev install --tool claude
+
+# 第二步：修改配置（必做！）
+# CLAUDE.md 是示例模板，把 [你的xxx] 占位符替换为项目实际信息
+
+# 第三步：验证
+# 在 Claude Code 中输入 /start，AI 会扫描并介绍你的项目
+```
+
+**核心命令**（第一天用这 3 个就够了）：
+
+| 命令 | 作用 |
+|------|------|
+| `/start` | AI 扫描项目，给出概览 |
+| `/dev` | 从需求到代码的完整开发流程 |
+| `/check` | 检查代码是否符合规范 |
+
+**更多命令**：`/crud`（生成增删改查）、`/progress`（项目进度）、`/sync`（代码状态同步）
+
+> **包含内容**：91 个 Skills 技能 + 20 个快捷命令 + 9 个多模型分层 Agent + 自动化 Hooks
+
+## 从 v1 迁移
+
+v2 简化了命令结构，旧命令自动兼容：
+
+| v1 命令 | v2 命令 | 说明 |
+|---------|---------|------|
+| `npx ai-engineering-init` | `npx leniu-dev install` | 改为用户级安装 |
+| `npx ai-engineering-init global` | `npx leniu-dev install` | 不再区分项目/全局 |
+| `npx ai-engineering-init sync-back` | `npx leniu-dev syncback` | 命令简化 |
+| `npx ai-engineering-init config` | `npx leniu-dev config` | 不变 |
+| `npx ai-engineering-init mcp` | `npx leniu-dev mcp` | 不变 |
+
+## 更多信息
+
+[参考文档](./docs/reference.md) — Skills 列表、包含内容、命令详情
+
+[更新日志](./CHANGELOG.md) — 完整版本变更记录
+
+[贡献指南](./CONTRIBUTING.md) — 如何维护和更新 Skills，团队协作工作流
+
+## License
+
+MIT