ai-engineering-init 1.7.0 → 1.10.0

package/.cursor/agents/task-fetcher.md

@@ -0,0 +1,75 @@
+---
+name: task-fetcher
+description: 获取云效任务信息并整理为结构化清单。当需要查看任务状态、同步需求、读取工作项时使用。仅做数据获取和整理，不做需求分析。
+model: fast
+readonly: true
+---
+
+你是云效任务获取助手。你的唯一职责是：**调用云效 API 获取任务数据并格式化返回**。不要分析需求，不要给出实现建议。
+
+## 配置读取
+
+从 `.claude/settings.json` 的 `mcpServers.yunxiao.env` 中读取 Token：
+
+```bash
+TOKEN=$(python3 -c "
+import json
+s = json.load(open('$CLAUDE_PROJECT_DIR/.claude/settings.json'))
+print(s.get('mcpServers',{}).get('yunxiao',{}).get('env',{}).get('YUNXIAO_ACCESS_TOKEN',''))
+")
+```
+
+## 已知信息
+
+- 组织 ID: `61dbcd725356b19beeb1dc03`
+- 用户: 徐嘉骏（ID: `66286d4b06679a65daed4d28`）
+- 常用项目: SARW（`4574cb1c653fe873335b6c4716`）、EZML（`6f99a4e627fa88d6f8cb541e6c`）
+- Base URL: `https://openapi-rdc.aliyuncs.com`
+
+## API 调用模板
+
+```bash
+# 通用请求
+curl -s "https://openapi-rdc.aliyuncs.com${PATH}" \
+  -H "Accept: application/json" \
+  -H "Content-Type: application/json" \
+  -H "x-yunxiao-token: ${TOKEN}"
+
+# 查询工作项详情
+# GET /oapi/v1/workitems/{workitemIdentity}?organizationId={orgId}
+
+# 搜索工作项
+# GET /oapi/v1/workitems?organizationId={orgId}&projectId={projectId}&keyword={keyword}
+
+# 查询我的待办
+# GET /oapi/v1/workitems?organizationId={orgId}&assignedTo={userId}&status=开发中,待处理
+```
+
+## 输出格式（严格遵守）
+
+```markdown
+## 云效任务信息
+
+**项目**: [项目名]
+**查询时间**: [时间]
+
+### 任务列表
+
+| 编号 | 标题 | 状态 | 负责人 | 优先级 | 截止日期 |
+|------|------|------|--------|--------|---------|
+| SARW-123 | xxx | 开发中 | 徐嘉骏 | P1 | 2026-03-15 |
+
+### 任务详情（如查询单个任务）
+
+- **标题**: [标题]
+- **描述**: [描述内容]
+- **状态**: [状态]
+- **子任务**: [子任务列表]
+- **评论**: [最近评论]
+```
+
+## 约束
+
+- 只获取数据，不分析需求
+- 只格式化，不给实现建议
+- Token 不存在时明确说"缺少云效 Token 配置"

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

@@ -222,11 +222,11 @@ const skillMap = [
   },
   {
     name: 'backend-annotations',
-    keywords: ['@RateLimiter', '@DataScope', '@RepeatSubmit', '@Sensitive', '@EncryptField']
+    keywords: ['注解', '限流', '防重复', '脱敏', '加密注解', 'AOP注解']
   },
   {
     name: 'utils-toolkit',
-    keywords: ['MapstructUtils', 'StreamUtils', 'TreeBuildUtils', 'DateUtils']
+    keywords: ['工具类', '对象转换', '字符串工具', '集合工具', '日期工具', 'BeanUtils']
   },
   {
     name: 'file-oss-management',
@@ -238,7 +238,7 @@ const skillMap = [
   },
   {
     name: 'error-handler',
-    keywords: ['异常处理', 'ServiceException', '全局异常', '参数校验异常']
+    keywords: ['异常处理', '全局异常', '业务异常', '参数校验异常', '@RestControllerAdvice']
   },
   {
     name: 'performance-doctor',
@@ -250,7 +250,7 @@ const skillMap = [
   },
   {
     name: 'security-guard',
-    keywords: ['Sa-Token', '认证授权', '加密', 'XSS', 'SQL注入', '数据脱敏']
+    keywords: ['安全', '认证授权', '加密', 'XSS', 'SQL注入', '数据脱敏', 'Spring Security']
   },
   {
     name: 'architecture-design',
@@ -298,7 +298,7 @@ const skillMap = [
   },
   {
     name: 'scheduled-jobs',
-    keywords: ['定时任务', 'SnailJob', '@Scheduled', '@JobExecutor', '任务调度', '重试机制']
+    keywords: ['定时任务', '@Scheduled', 'Quartz', 'XXL-Job', '任务调度', '重试机制']
   },
   {
     name: 'websocket-sse',
@@ -314,7 +314,7 @@ const skillMap = [
   },
   {
     name: 'tenant-management',
-    keywords: ['多租户', '租户隔离', 'TenantEntity', 'TenantHelper', 'tenantId', '跨租户', 'SaaS']
+    keywords: ['多租户', '租户隔离', 'tenantId', '跨租户', 'SaaS', '数据隔离']
   },
   {
     name: 'ui-pc',
@@ -332,6 +332,10 @@ const skillMap = [
     name: 'banana-image',
     keywords: ['生成图片', 'AI图片', '产品图', '海报', '缩略图', '4K图片', '高清图', '制作图片', '/image']
   },
+  {
+    name: 'codex-code-review',
+    keywords: ['代码审查', 'code review', 'review代码', '代码检查', 'codex审查']
+  },
   {
     name: 'collaborating-with-codex',
     keywords: ['codex协作', '委托codex', 'openai codex', 'codex分析', '多模型协作', '让codex']
@@ -365,6 +369,62 @@ const skillMap = [
     name: 'openspec-onboard',
     keywords: ['openspec入门', 'opsx:onboard', 'openspec onboard', 'openspec教程',
       'openspec新手', '学习openspec工作流']
+  },
+  {
+    name: 'loki-log-query',
+    keywords: ['Loki', '日志查询', '线上日志', 'Loki日志', '日志排查', 'LogQL']
+  },
+  {
+    name: 'yunxiao-task-management',
+    keywords: ['云效', '任务管理', '需求管理', '云效任务', 'yunxiao', '迭代管理']
+  },
+  {
+    name: 'crud',
+    keywords: ['快速CRUD', 'CRUD生成', '脚手架生成', '/crud']
+  },
+  {
+    name: 'dev',
+    keywords: ['开发新功能', '功能开发', '/dev', '新建功能']
+  },
+  {
+    name: 'check',
+    keywords: ['代码检查', '规范检查', '/check', '代码审查规范']
+  },
+  {
+    name: 'start',
+    keywords: ['项目启动', '初始化项目', '/start', '开始项目']
+  },
+  {
+    name: 'next',
+    keywords: ['下一步', '接下来', '/next', '继续做什么']
+  },
+  {
+    name: 'progress',
+    keywords: ['进度查看', '当前进度', '/progress', '任务进度']
+  },
+  {
+    name: 'sync',
+    keywords: ['同步代码', '代码同步', '/sync', '同步分支']
+  },
+  {
+    name: 'sync-back-merge',
+    keywords: ['回合并', 'sync back merge', '主分支同步', '回合主分支']
+  },
+  {
+    name: 'init-docs',
+    keywords: ['初始化文档', '项目文档', '生成文档', '/init-docs']
+  },
+  {
+    name: 'add-todo',
+    keywords: ['添加待办', '新增TODO', '任务添加', '/add-todo']
+  },
+  {
+    name: 'update-status',
+    keywords: ['更新状态', '状态变更', '修改状态', '/update-status']
+  },
+  {
+    name: 'skill-creator',
+    keywords: ['创建技能', '技能模板', '技能脚手架', 'skill scaffold', '新建skill']
   }
 ];
 

package/.cursor/skills/api-development/SKILL.md

@@ -1,20 +1,19 @@
 ---
 name: api-development
 description: |
-  后端 API 接口设计规范。基于三层架构的 RESTful API 开发指南。
+  后端 API 接口设计规范。基于 Spring Boot 的 RESTful API 开发指南。
 
   触发场景：
   - 设计 RESTful API 接口
   - 编写 Controller 层代码
-  - 配置接口权限、日志、防重复提交注解
+  - 配置接口权限、日志注解
   - 接口返回值类型选择
   - 数据验证和参数校验
 
   触发词：API、接口、RESTful、Controller、GetMapping、PostMapping、权限注解、日志注解、分页查询、接口规范
 
   注意：
-  - 本项目是三层架构：Controller -> Service -> Mapper
-  - 参考 java-controller 技能获取更详细的 Controller 层规范
+  - 参考项目实际架构层次选择合适的分层模式
 ---
 
 # API 接口设计规范
@@ -23,22 +22,22 @@ description: |
 
 | 原则 | 说明 |
 |------|------|
-| 统一入口 | 所有接口使用 POST 或 RESTful 风格 |
+| RESTful 风格 | 使用标准 HTTP 方法表达语义 |
 | 认证保护 | 所有业务接口必须添加认证注解 |
 | 参数校验 | 使用分组校验区分新增/修改场景 |
 | 统一响应 | 使用统一的响应格式包装返回数据 |
 
 ### HTTP 方法规范
 
-| 操作 | 方法 | 路径 |
-|------|------|------|
-| 列表查询 | POST/GET | `/query` 或 `/list` |
-| 获取详情 | POST/GET | `/{id}` 或 `/detail` |
-| 新增 | POST | `/add` |
-| 修改 | POST/PUT | `/update` |
-| 删除 | POST/DELETE | `/delete` 或 `/batch/delete` |
+| 操作 | 方法 | 路径示例 |
+|------|------|---------|
+| 列表查询 | GET | `/list` 或 `/page` |
+| 获取详情 | GET | `/{id}` |
+| 新增 | POST | `/` 或 `/add` |
+| 修改 | PUT | `/` 或 `/update` |
+| 删除 | DELETE | `/{ids}` |
 | 导出 | POST | `/export` |
-| 导入 | POST | `/import-excel` |
+| 导入 | POST | `/import` |
 
 ---
 
@@ -47,65 +46,106 @@ description: |
 ```java
 @Slf4j
 @RestController
-@RequiresAuthentication
-@RequestMapping("/module/feature")
-@Api(value = "模块/功能", tags = "模块/功能")
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/[模块]/[功能]")
 public class XxxController {
 
-    @Resource @Lazy
-    private XxxService xxxService;
+    private final XxxService xxxService;
 
-    @PostMapping("/add")
-    @ApiOperation(value = "功能描述-新增")
-    public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-        return xxxService.add(request.getContent());
+    /**
+     * 分页查询
+     */
+    @GetMapping("/page")
+    public Result<PageResult<XxxVO>> page(XxxQueryDTO query) {
+        return Result.ok(xxxService.pageList(query));
     }
 
-    @PostMapping("/update")
-    @ApiOperation(value = "功能描述-修改")
-    public void update(@Validated(UpdateGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-        xxxService.update(request.getContent());
+    /**
+     * 获取详情
+     */
+    @GetMapping("/{id}")
+    public Result<XxxVO> getById(@PathVariable Long id) {
+        return Result.ok(xxxService.getById(id));
     }
 
-    @PostMapping("/query")
-    @ApiOperation(value = "功能描述-分页查询")
-    public Page<XxxVO> query(@Validated @RequestBody LeRequest<XxxQueryParam> request) {
-        return xxxService.pageList(request.getContent());
+    /**
+     * 新增
+     */
+    @PostMapping
+    public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) {
+        return Result.ok(xxxService.add(dto));
     }
 
-    @PostMapping("/delete")
-    @ApiOperation(value = "功能描述-删除")
-    public void delete(@RequestBody LeRequest<Long> request) {
-        xxxService.delete(request.getContent());
+    /**
+     * 修改
+     */
+    @PutMapping
+    public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) {
+        xxxService.update(dto);
+        return Result.ok();
+    }
+
+    /**
+     * 删除
+     */
+    @DeleteMapping("/{ids}")
+    public Result<Void> delete(@PathVariable List<Long> ids) {
+        xxxService.deleteByIds(ids);
+        return Result.ok();
     }
 }
 ```
 
 ---
 
-## 参数封装规范
+## 统一响应封装
 
-### 请求参数用 LeRequest 包装
+### Result 包装类（通用模式）
 
 ```java
-@PostMapping("/query")
-public Page<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) {
-    return xxxService.pageList(request.getContent());
+@Data
+public class Result<T> {
+    private int code;
+    private String message;
+    private T data;
+
+    public static <T> Result<T> ok() {
+        return ok(null);
+    }
+
+    public static <T> Result<T> ok(T data) {
+        Result<T> result = new Result<>();
+        result.setCode(200);
+        result.setMessage("success");
+        result.setData(data);
+        return result;
+    }
+
+    public static <T> Result<T> fail(String message) {
+        Result<T> result = new Result<>();
+        result.setCode(500);
+        result.setMessage(message);
+        return result;
+    }
 }
 ```
 
-### 分页参数
+### 分页响应
 
 ```java
 @Data
-public class XxxPageParam implements Serializable {
-    @NotNull(message = "分页参数不能为空")
-    private PageDTO page;
-    private String keyword;
-    private Integer status;
+public class PageResult<T> {
+    private List<T> records;
+    private long total;
+    private long current;
+    private long size;
 }
 ```
 
+---
+
+## 参数校验
+
 ### 分组校验
 
 ```java
@@ -116,142 +156,152 @@ public class XxxDTO {
     private Long id;
 
     @NotBlank(message = "名称不能为空", groups = {InsertGroup.class, UpdateGroup.class})
+    @Size(max = 100, message = "名称长度不能超过100个字符")
     private String name;
+
+    @Min(value = 0, message = "排序不能为负数")
+    private Integer sort;
 }
 
 // Controller 中应用
-@PostMapping("/add")
-public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request)
-```
+@PostMapping
+public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) { ... }
 
-> Jakarta Validation: 项目用 JDK 21，必须 `import jakarta.validation.constraints.*`
+@PutMapping
+public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) { ... }
+```
 
----
+> Jakarta Validation: JDK 17+ 必须 `import jakarta.validation.constraints.*`
 
-## 响应格式
+### 查询参数
 
 ```java
-// 分页响应
-@PostMapping("/query")
-public Page<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) { ... }
+@Data
+public class XxxQueryDTO {
+    private String keyword;
+    private Integer status;
 
-// 单条数据
-@GetMapping("/{id}")
-public XxxVO getById(@PathVariable Long id) { ... }
+    @Min(value = 1)
+    private Integer pageNum = 1;
 
-// 新增返回 ID / 修改删除返回 void
-@PostMapping("/add")
-public Long add(@RequestBody LeRequest<XxxDTO> request) { ... }
+    @Min(value = 1) @Max(value = 100)
+    private Integer pageSize = 10;
+}
 ```
 
 ---
 
 ## 常见场景
 
-### 带 Redisson 分布式锁的导入
+### 带分布式锁的导入
 
 ```java
-@PostMapping("/import-excel")
-@ApiOperation(value = "Excel导入")
-public void importExcel(@RequestParam(value = "file") MultipartFile file) {
-    if (Objects.isNull(file) || file.isEmpty()) {
-        throw new LeException("文件不能为空");
-    }
-    RLock lock = redissonClient.getLock("import:lock:" + TenantContextHolder.getTenantId());
-    if (!lock.tryLock(5, 60, TimeUnit.SECONDS)) {
-        throw new LeException("正在处理中，请稍后再试");
+@PostMapping("/import")
+public Result<Void> importExcel(@RequestPart("file") MultipartFile file) {
+    if (file == null || file.isEmpty()) {
+        throw new [你的异常类]("文件不能为空");
     }
+    RLock lock = redissonClient.getLock("import:lock:" + getCurrentTenantId());
     try {
-        xxxService.importExcel(file);
-    } finally {
-        if (lock.isLocked() && lock.isHeldByCurrentThread()) {
-            lock.unlock();
+        if (!lock.tryLock(5, 60, TimeUnit.SECONDS)) {
+            throw new [你的异常类]("正在处理中，请稍后再试");
+        }
+        try {
+            xxxService.importExcel(file);
+        } finally {
+            if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                lock.unlock();
+            }
         }
+    } catch (InterruptedException e) {
+        Thread.currentThread().interrupt();
+        throw new [你的异常类]("导入被中断");
     }
+    return Result.ok();
 }
 ```
 
 ### 批量删除
 
 ```java
-@RequestMapping(value = "/batch/delete", method = {RequestMethod.POST, RequestMethod.PUT})
-@ApiOperation(value = "批量删除")
-public void batchDelete(@RequestBody LeRequest<List<Long>> request) {
-    if (CollUtil.isEmpty(request.getContent())) {
-        throw new LeException("ID列表不能为空");
+@DeleteMapping("/{ids}")
+public Result<Void> delete(@PathVariable List<Long> ids) {
+    if (ids == null || ids.isEmpty()) {
+        throw new [你的异常类]("ID列表不能为空");
     }
-    xxxService.batchDelete(request.getContent());
+    xxxService.deleteByIds(ids);
+    return Result.ok();
 }
 ```
 
-### 带合计行的分页查询
+### 文件上传
 
 ```java
-@PostMapping("/query")
-@ApiOperation(value = "分页查询（带合计）")
-public ReportBaseTotalVO<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) {
-    ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
-    result.setTotalLine(xxxService.getSummaryTotal(request.getContent()));
-    result.setResultPage(PageVO.of(xxxService.pageList(request.getContent())));
-    return result;
+@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+public Result<UploadResult> upload(@RequestPart("file") MultipartFile file) {
+    return Result.ok(ossService.upload(file));
 }
 ```
 
 ---
 
-## Swagger 注解
+## API 文档注解
+
+### Swagger / SpringDoc 注解
 
 ```java
-@Api(value = "模块/功能", tags = "模块/功能")  // Controller 类
-@ApiOperation(value = "功能描述-新增")           // 方法
-@ApiModel("功能描述DTO")                         // DTO/VO 类
-@ApiModelProperty(value = "主键ID", required = true) // 字段
+// SpringDoc (OpenAPI 3.0, 推荐)
+@Tag(name = "用户管理")                              // Controller 类
+@Operation(summary = "新增用户")                      // 方法
+@Schema(description = "用户DTO")                      // DTO/VO 类
+@Schema(description = "主键ID", requiredMode = REQUIRED) // 字段
+
+// Swagger 2 (旧项目)
+@Api(value = "用户管理", tags = "用户管理")
+@ApiOperation(value = "新增用户")
+@ApiModel("用户DTO")
+@ApiModelProperty(value = "主键ID", required = true)
 ```
 
 ---
 
-## 检查清单
+## 全局异常处理
 
-- [ ] 认证注解 `@RequiresAuthentication`
-- [ ] API 文档注解 `@ApiOperation`
-- [ ] 参数校验 `@Validated` + 分组
-- [ ] 返回值类型正确（分页用 `Page<VO>`）
-- [ ] 使用 `LeRequest<T>` 封装请求
-- [ ] 敏感操作加分布式锁
+```java
+@RestControllerAdvice
+public class GlobalExceptionHandler {
 
----
+    @ExceptionHandler([你的异常类].class)
+    public Result<Void> handleBusinessException([你的异常类] e) {
+        return Result.fail(e.getMessage());
+    }
 
-## 多项目对比
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public Result<Void> handleValidException(MethodArgumentNotValidException e) {
+        String message = e.getBindingResult().getFieldErrors().stream()
+            .map(FieldError::getDefaultMessage)
+            .collect(Collectors.joining(", "));
+        return Result.fail(message);
+    }
 
-| 特征 | RuoYi-Vue-Plus | leniu-tengyun-core |
-|-----|----------------|-------------------|
-| JDK | 17 | 21 |
-| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
-| 请求封装 | 直接 BO | `LeRequest<T>` |
-| 响应封装 | `R<T>`, `TableDataInfo<T>` | `Page<T>`, `void` |
-| 分组校验 | `AddGroup`, `EditGroup` | `InsertGroup`, `UpdateGroup` |
-| 认证 | `@SaCheckPermission` | `@RequiresAuthentication` |
-| 异常 | `ServiceException` | `LeException` |
-| 国际化 | `MessageUtils.message()` | `I18n.getMessage()` |
+    @ExceptionHandler(Exception.class)
+    public Result<Void> handleException(Exception e) {
+        log.error("系统异常", e);
+        return Result.fail("系统繁忙，请稍后再试");
+    }
+}
+```
 
 ---
 
-## 错误对比
+## 检查清单
 
-```java
-// ---- 错误 ----
-@RestController                                    // 缺认证注解
-public Long add(@RequestBody XxxDTO dto) { }       // 不用 LeRequest
-public Long add(@Valid @RequestBody LeRequest<XxxDTO> request) { }  // @Valid 应为 @Validated(InsertGroup.class)
-import javax.validation.constraints.NotNull;        // JDK 21 用 jakarta
-
-// ---- 正确 ----
-@RestController @RequiresAuthentication
-public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-    return xxxService.add(request.getContent());
-}
-import jakarta.validation.constraints.NotNull;
-```
+- [ ] 认证注解（`@PreAuthorize` / `[你的认证注解]`）
+- [ ] API 文档注解（`@Operation` / `@ApiOperation`）
+- [ ] 参数校验 `@Validated` + 分组
+- [ ] 统一响应包装 `Result<T>`
+- [ ] 敏感操作加分布式锁
+- [ ] 全局异常处理器已配置
 
 ---
 
@@ -259,8 +309,7 @@ import jakarta.validation.constraints.NotNull;
 
 | 需要了解 | Skill |
 |---------|-------|
-| Service 层 | `java-service` |
-| Controller 详细 | `java-controller` |
 | 异常处理 | `error-handler` |
-| 参数校验 | `java-entity` |
 | 数据库设计 | `database-ops` |
+| 缓存 | `redis-cache` |
+| 文件上传 | `file-oss-management` |