ai-engineering-init 1.3.4 → 1.4.1

package/.claude/hooks/skill-forced-eval.js

@@ -72,6 +72,7 @@ const instructions = `## 强制技能激活流程（必须执行）
 - ai-langchain4j: AI/大模型/ChatGPT/DeepSeek
 - media-processing: 图片处理/二维码/水印/Excel
 - bug-detective: Bug/报错/异常/不工作
+- mysql-debug: 查数据库/查表/执行SQL/查记录/mysql查询/数据库排查/验证数据/数据库调试/db查询
 - error-handler: 异常处理/ServiceException
 - performance-doctor: 性能/慢查询/优化/缓存
 - data-permission: 数据权限/@DataPermission/DataScope/行级权限
@@ -108,6 +109,7 @@ const instructions = `## 强制技能激活流程（必须执行）
 - leniu-java-total-line: 合计行/totalLine/报表合计/SUM合计/ReportBaseTotalVO/合计查询
 - leniu-report-customization: 定制报表/汇总报表/report_order_info/report_order_detail/report_account_flow/退款汇总/消费金额统计/订单报表/流水报表
 - leniu-report-standard-customization: 标准版报表/core-report/report_refund/report_refund_detail/经营分析/营业额分析/用户活跃度/菜品排行/操作员统计/账户日结/钱包消费汇总/商户消费汇总/ReportOrderConsumeService/ReportAccountConsumeService
+- leniu-customization-location: 定制开发/定制代码位置/Dz前缀/leniu-yunshitang/dz_表名/定制仓库/覆盖Service/@Primary/迁移core文件/定制开始/定制结束/net.xnzn.yunshitang/wuhanxiehe定制/bootstrap-ext
 - leniu-crud-development: CRUD/增删改查/新建模块/Business层/Service/Mapper/Controller/分页查询/LeRequest/PageDTO/PageVO/事务管理
 - leniu-database-ops: 数据库/SQL/建表/双库/商户库/系统库/审计字段/crby/crtime/del_flag
 - leniu-utils-toolkit: 工具类/BeanUtil/StrUtil/CollUtil/ObjectUtil/RedisUtil/JacksonUtil/LeBeanUtil

package/.claude/settings.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/skill-forced-eval.js"
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/skill-forced-eval.js\""
           }
         ]
       }
@@ -18,7 +18,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/pre-tool-use.js",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-tool-use.js\"",
             "timeout": 5000
           }
         ]
@@ -30,7 +30,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/stop.js",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/stop.js\"",
             "timeout": 10000
           }
         ]

package/.claude/skills/add-skill/SKILL.md

@@ -18,6 +18,57 @@ description: |
 
 本指南用于在 leniu-tengyun-core 项目中添加新的技能（Skill）。项目同时支持三个 AI 编码平台，技能需在所有平台保持一致。
 
+## 核心设计原则
+
+### 精简至上
+
+上下文窗口是共享资源。技能与系统提示、对话历史、其他技能元数据共享窗口。
+
+**默认假设：AI 已经很聪明。** 只添加 AI 本身不具备的知识。每段内容都应自问："AI 真的需要这个解释吗？"、"这段内容值得占用 token 吗？"
+
+**优先用简洁的代码示例代替冗长的文字说明。**
+
+### 自由度控制
+
+根据任务的脆弱性和变化性，匹配不同的指定程度：
+
+| 自由度 | 适用场景 | 形式 |
+|--------|---------|------|
+| **高** | 多种方案均可，依赖上下文决策 | 文字描述指导 |
+| **中** | 有推荐模式但允许变通 | 伪代码/带参数脚本 |
+| **低** | 操作脆弱易错，必须严格一致 | 精确脚本/步骤 |
+
+### 渐进披露
+
+技能使用三级加载系统管理上下文：
+
+1. **元数据（name + description）** — 始终在上下文中（~100 词）
+2. **SKILL.md 正文** — 技能触发时加载（< 500 行）
+3. **捆绑资源** — 按需加载（无限制）
+
+**SKILL.md 正文控制在 500 行以内。** 接近上限时拆分到独立文件。拆分后必须在 SKILL.md 中引用并说明何时读取。
+
+**大技能拆分模式**：
+
+```
+技能名/
+├── SKILL.md              # 核心流程 + 导航（< 500 行）
+├── references/           # 按需加载的参考文档
+│   ├── patterns.md       # 设计模式详解
+│   └── examples.md       # 完整代码示例
+└── assets/               # 输出资源（模板、图片等）
+```
+
+当技能支持多种变体时，按变体组织 references：
+```
+leniu-report-xxx/
+├── SKILL.md
+└── references/
+    ├── basic-report.md    # 基础报表模式
+    ├── summary-report.md  # 汇总报表模式
+    └── analysis-report.md # 分析报表模式
+```
+
 ### 三平台架构
 
 | 平台 | 技能目录 | Hook 文件 | 激活方式 |
@@ -113,6 +164,18 @@ description: |
 
 ---
 
+## 第 0 步：理解需求
+
+> 跳过条件：技能的使用模式已经很清楚时可跳过。
+
+创建有效技能前，先用具体示例理解技能将如何被使用：
+
+1. **收集使用场景**：用户会说什么触发这个技能？
+2. **识别可复用内容**：哪些代码/模板/参考文档在每次使用时都会重复？
+3. **确定资源类型**：重复代码/技术文档 → `references/`；输出模板 → `assets/`；高频规则 → SKILL.md 正文
+
+---
+
 ## 第 1 步：规划
 
 ### 1.1 定义技能属性
@@ -191,13 +254,11 @@ description: |
 
 ### 2.4 不同类型技能的侧重
 
-| 类型 | 侧重 | 示例 |
-|------|------|------|
-| 后端开发类 | 代码模板、标准写法、禁止项 | leniu-crud-development |
-| 工具类 | API 列表、使用示例、返回值 | leniu-utils-toolkit |
-| 中间件类 | 配置方法、集成步骤、注意事项 | leniu-redis-cache |
-| 流程类 | 步骤说明、决策树、检查清单 | leniu-brainstorm |
-| 报表类 | SQL 模板、fix 模式、退款处理 | leniu-report-customization |
+| 类型 | 侧重 |
+|------|------|
+| 后端开发类 | 代码模板、标准写法、禁止项 |
+| 工具/中间件类 | API 列表、配置方法、使用示例 |
+| 流程/报表类 | 步骤说明、SQL 模板、决策树 |
 
 ---
 
@@ -409,33 +470,19 @@ cp .claude/skills/$SKILL_NAME/SKILL.md .cursor/skills/$SKILL_NAME/SKILL.md
 cp .claude/skills/$SKILL_NAME/SKILL.md .codex/skills/$SKILL_NAME/SKILL.md
 ```
 
-### 4. 触发词过于宽泛
-
-**症状**：技能在不相关场景被频繁误触发
-
-**原因**：触发词太通用（如"开发"、"功能"）
-
-**解决**：使用具体术语（如"CRUD开发"、"支付接入"）
+### 4-7. 其他常见问题
 
-### 5. 代码示例虚构
-
-**症状**：AI 参考技能生成的代码使用了不存在的类或方法
-
-**解决**：编写前用 Grep/Glob 搜索确认引用的类和方法确实存在
-
-### 6. 技能范围重叠
-
-**症状**：同一个问题触发多个技能，指导矛盾
-
-**解决**：在 SKILL.md 末尾添加"注意"段落说明边界：
-```
-注意：如果是行级数据权限（@DataPermission），请使用 leniu-data-permission。
-```
+| # | 症状 | 原因 | 解决 |
+|---|------|------|------|
+| 4 | 技能频繁误触发 | 触发词太通用（如"开发"） | 用具体术语（如"CRUD开发"） |
+| 5 | 生成代码引用不存在的类 | 代码示例虚构 | 编写前用 Grep/Glob 确认类和方法存在 |
+| 6 | 多技能触发、指导矛盾 | 技能范围重叠 | SKILL.md 末尾添加"注意"段落说明边界 |
+| 7 | 生成代码编译失败 | 写了 `org.dromara.*` | 统一使用 `net.xnzn.core.*` |
 
-### 7. 包名写错
+---
 
-**症状**：生成的代码编译失败
+## 迭代优化
 
-**原因**：技能中写了 `org.dromara.*`（旧包名）
+技能创建后持续改进：使用技能完成真实任务 → 发现不足 → 更新 SKILL.md → 同步三平台 → 重新测试。
 
-**解决**：leniu 项目统一使用 `net.xnzn.core.*`
+> **提示**：不要创建多余的文档文件（README.md 等）。技能只包含 AI 执行任务所需的信息。