ai-engineering-init 1.3.4 → 1.4.1

package/.cursor/hooks/cursor-skill-eval.js

@@ -9,6 +9,10 @@
  */
 
 const fs = require('fs');
+const path = require('path');
+
+// 项目根目录：__dirname 是 .cursor/hooks/，向上两级
+const PROJECT_ROOT = path.resolve(__dirname, '..', '..');
 
 // 从 stdin 读取用户输入
 let inputData = '';
@@ -158,6 +162,12 @@ const skillMap = [
     name: 'leniu-mealtime',
     keywords: ['餐次', '早餐', '午餐', '下午茶', '晚餐', '夜宵', 'mealtimeTypes']
   },
+  {
+    name: 'leniu-customization-location',
+    keywords: ['定制开发', '定制代码位置', 'Dz前缀', 'leniu-yunshitang', 'dz_表名', '定制仓库',
+      '覆盖Service', '@Primary', '迁移core文件', '定制开始', '定制结束', 'net.xnzn.yunshitang',
+      'wuhanxiehe定制', 'bootstrap-ext']
+  },
 
   // ========== OpenSpec 工作流 ==========
   {
@@ -313,6 +323,48 @@ const skillMap = [
   {
     name: 'store-pc',
     keywords: ['Vuex', 'store', 'mapState', 'mapActions', '状态管理']
+  },
+  {
+    name: 'add-skill',
+    keywords: ['添加技能', '创建技能', '新技能', '技能开发', '写技能', 'SKILL.md', '新增skill']
+  },
+  {
+    name: 'banana-image',
+    keywords: ['生成图片', 'AI图片', '产品图', '海报', '缩略图', '4K图片', '高清图', '制作图片', '/image']
+  },
+  {
+    name: 'collaborating-with-codex',
+    keywords: ['codex协作', '委托codex', 'openai codex', 'codex分析', '多模型协作', '让codex']
+  },
+  {
+    name: 'collaborating-with-gemini',
+    keywords: ['gemini协作', '委托gemini', 'google gemini', 'gemini分析', '让gemini', 'gemini前端']
+  },
+  {
+    name: 'leniu-brainstorm',
+    keywords: ['leniu-头脑风暴', '云食堂方案', '云食堂设计', '云食堂功能规划', 'leniu-方案设计',
+      '云食堂怎么设计', '云食堂可行性']
+  },
+  {
+    name: 'leniu-report-customization',
+    keywords: ['定制报表', 'report_order_info', 'report_order_detail', 'report_account_flow',
+      '退款汇总', '消费金额统计', '订单报表', '流水报表', '汇总报表']
+  },
+  {
+    name: 'leniu-report-standard-customization',
+    keywords: ['标准版报表', 'core-report', 'report_refund', 'report_refund_detail',
+      '经营分析', '营业额分析', '用户活跃度', '菜品排行', '操作员统计', '账户日结',
+      'ReportOrderConsumeService', 'ReportAccountConsumeService']
+  },
+  {
+    name: 'mysql-debug',
+    keywords: ['mysql查询', '查数据库', '查表', '执行SQL', '数据库排查', '验证数据',
+      '数据库调试', 'db查询', 'mysql调试', '直接查库']
+  },
+  {
+    name: 'openspec-onboard',
+    keywords: ['openspec入门', 'opsx:onboard', 'openspec onboard', 'openspec教程',
+      'openspec新手', '学习openspec工作流']
   }
 ];
 
@@ -335,7 +387,7 @@ if (matchedSkills.length === 0) {
 }
 
 // 构建技能文档路径列表
-const skillPaths = matchedSkills.map(name => `.cursor/skills/${name}/SKILL.md`);
+const skillPaths = matchedSkills.map(name => path.join(PROJECT_ROOT, '.cursor', 'skills', name, 'SKILL.md'));
 
 const skillList = matchedSkills.map((name, i) => `- **${name}**: \`${skillPaths[i]}\``).join('\n');
 

package/.cursor/hooks.json

@@ -4,19 +4,19 @@
     "beforeSubmitPrompt": [
       {
         "matcher": "",
-        "command": "node .cursor/hooks/cursor-skill-eval.js"
+        "command": "node -e \"const p=require('path'),fs=require('fs');let d=process.cwd();while(!fs.existsSync(p.join(d,'.cursor/hooks/cursor-skill-eval.js'))&&d!==p.dirname(d))d=p.dirname(d);const f=p.join(d,'.cursor/hooks/cursor-skill-eval.js');if(fs.existsSync(f))require(f);\""
       }
     ],
     "preToolUse": [
       {
         "matcher": "Shell|Write|CreateFile|EditFile",
-        "command": "node .cursor/hooks/cursor-pre-tool-use.js"
+        "command": "node -e \"const p=require('path'),fs=require('fs');let d=process.cwd();while(!fs.existsSync(p.join(d,'.cursor/hooks/cursor-pre-tool-use.js'))&&d!==p.dirname(d))d=p.dirname(d);const f=p.join(d,'.cursor/hooks/cursor-pre-tool-use.js');if(fs.existsSync(f))require(f);\""
       }
     ],
     "stop": [
       {
         "matcher": "",
-        "command": "node .cursor/hooks/stop.js"
+        "command": "node -e \"const p=require('path'),fs=require('fs');let d=process.cwd();while(!fs.existsSync(p.join(d,'.cursor/hooks/stop.js'))&&d!==p.dirname(d))d=p.dirname(d);const f=p.join(d,'.cursor/hooks/stop.js');if(fs.existsSync(f))require(f);\""
       }
     ]
   }

package/.cursor/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 执行任务所需的信息。