@llryiop/avatar-boot-cli 1.0.0

package/templates/.claude/skills/prompt-engineering/SKILL.md

@@ -0,0 +1,249 @@
+---
+name: prompt-engineering
+description: |
+  Avatar Boot 项目 Prompt 模板库 — 提供 Java 开发各场景的即用 Prompt 模板和上下文片段。
+  触发条件：Prompt模板, prompt template, 提示词模板, prompt engineering
+  通用 Prompt 技巧请参考 ai-tool-guide Skill。
+---
+
+# Prompt 模板库
+
+> Avatar Boot 项目专用 — 各场景可直接复用的 Prompt 模板
+
+---
+
+## 1. 代码生成 — CRUD 模块
+
+```
+## 任务
+为 [模块名] 模块生成完整的 CRUD 代码。
+
+## 技术栈
+- Java 21, Spring Boot 3.5.3, Avatar Boot 框架
+- 持久层：MyBatis-Plus
+- 数据库：MySQL 8.0
+
+## 数据库表结构
+[粘贴 CREATE TABLE 语句]
+
+## 要求
+1. 分层架构：Controller → Service（接口+实现） → Mapper
+2. 统一返回 Result<T>
+3. 参数校验使用 Jakarta Validation
+4. 分页查询使用 MyBatis-Plus 的 Page<T>
+5. Entity 使用 @TableName 注解
+6. DTO 用于接收请求参数，VO 用于返回响应数据
+7. Service 实现类添加 @Transactional 注解（写操作）
+
+## 输出
+按文件逐个输出完整代码，包含 package 声明和 import 语句。
+```
+
+## 2. 代码生成 — Service 方法
+
+```
+## 任务
+在 [ServiceName] 中添加 [方法描述] 方法。
+
+## 现有代码
+[粘贴 Service 接口和相关 Entity/DTO]
+
+## 业务逻辑
+1. [步骤1]
+2. [步骤2]
+3. [步骤3]
+
+## 约束
+- 使用 Result<T> 返回
+- 异常使用 BizException 抛出
+- 需要事务控制的操作添加 @Transactional
+- 遵循现有代码的风格和命名规范
+```
+
+## 3. 代码审查
+
+```
+## 任务
+请对以下代码进行全面审查。
+
+## 审查维度
+1. **安全性**：SQL注入、XSS、权限校验、敏感数据处理
+2. **性能**：N+1查询、不必要的循环、大对象创建、缓存使用
+3. **规范性**：命名规范、代码结构、注释完整性、异常处理
+4. **可维护性**：代码重复、方法长度、圈复杂度、依赖关系
+
+## 代码
+[粘贴待审查代码]
+
+## 输出格式
+按审查维度分类，每个问题包含：
+- 问题位置（行号或方法名）
+- 问题描述
+- 严重程度（Critical / Major / Minor）
+- 修复建议（含代码示例）
+```
+
+## 4. Bug 修复
+
+```
+## 问题描述
+[简要描述问题现象]
+
+## 异常堆栈
+[粘贴完整堆栈信息]
+
+## 相关代码
+[粘贴出错的类和方法]
+
+## 期望行为
+[描述正确的行为应该是什么]
+
+## 请分析
+1. 根本原因是什么
+2. 修复方案（给出修改后的代码）
+3. 是否有类似问题需要排查
+4. 如何添加测试防止回归
+```
+
+## 5. 重构
+
+```
+## 任务
+重构以下代码，目标是 [重构目标]。
+
+## 当前代码
+[粘贴待重构代码]
+
+## 问题
+- [问题1：如方法过长]
+- [问题2：如代码重复]
+- [问题3：如职责不清]
+
+## 重构方向
+- [如：提取方法、引入策略模式、消除重复等]
+
+## 约束
+- 保持外部接口不变（方法签名、返回类型）
+- 保持现有测试通过
+- 遵循 Avatar Boot 架构规范
+```
+
+## 6. 测试生成
+
+```
+## 任务
+为 [类名.方法名] 生成单元测试。
+
+## 被测代码
+[粘贴被测类代码]
+
+## 测试要求
+- 使用 JUnit 5 + Mockito
+- 覆盖以下场景：
+  1. 正常流程
+  2. [边界场景1]
+  3. [边界场景2]
+  4. [异常场景1]
+  5. [异常场景2]
+- Mock 外部依赖（Service、Mapper 等）
+- 使用 @DisplayName 描述测试意图
+- 遵循 Given-When-Then 结构
+```
+
+## 7. SQL 编写
+
+```
+## 任务
+编写 [查询描述] 的 SQL。
+
+## 表结构
+[粘贴相关表的 CREATE TABLE 语句]
+
+## 查询需求
+- 查询条件：[条件描述]
+- 排序规则：[排序描述]
+- 分页要求：[是否需要分页]
+- 关联关系：[表之间的关联]
+
+## 输出格式
+- MyBatis XML Mapper 格式
+- 包含动态条件（<if> 标签）
+- 添加 SQL 注释说明
+```
+
+## 8. 需求分析
+
+```
+## 任务
+基于以下产品需求，输出技术设计方案。
+
+## 产品需求
+[粘贴 PRD 或需求描述]
+
+## 技术栈
+Java 21, Spring Boot 3.5.3, Avatar Boot 框架, MyBatis-Plus, MySQL 8.0
+
+## 输出要求
+1. 需求拆解：拆分为可执行的技术任务
+2. 数据模型设计：表结构 + ER 图描述
+3. 接口设计：REST API 列表 + 请求响应格式
+4. 核心流程：关键业务流程的时序描述
+5. 技术方案：核心实现思路 + 技术选型
+6. 工作量评估：按任务粒度估算开发天数
+```
+
+---
+
+## 可复用上下文片段
+
+以下片段可直接嵌入任何 Prompt 中：
+
+### 技术栈上下文
+
+```
+## 技术栈
+- 语言：Java 21
+- 框架：Spring Boot 3.5.3 + Avatar Boot
+- 持久层：MyBatis-Plus 3.5.x
+- 数据库：MySQL 8.0
+- 缓存：Redis 7.x
+- 构建工具：Maven 3.9+
+- API 风格：RESTful
+- 文档：SpringDoc OpenAPI 3
+```
+
+### 架构约束上下文
+
+```
+## 架构约束
+- 分层架构：Controller → Service（接口+实现） → Mapper
+- 统一返回格式：Result<T>，包含 code、message、data
+- 统一异常处理：GlobalExceptionHandler 捕获 BizException
+- 参数校验：Jakarta Validation 注解（@NotNull, @Size 等）
+- 分页查询：MyBatis-Plus Page<T>，Controller 接收 PageQuery 参数
+- DTO/VO 分离：DTO 用于接收请求参数，VO 用于返回响应数据
+- Entity 映射：使用 @TableName 注解，字段使用 @TableField
+```
+
+### 编码规范上下文
+
+```
+## 编码规范
+- 类名：大驼峰（UserService, OrderController）
+- 方法名：小驼峰（getUserById, createOrder）
+- 常量：全大写下划线（MAX_RETRY_COUNT）
+- 包结构：com.iflytek.avatar.[模块].[层次]
+- 异常：业务异常使用 BizException，携带错误码
+- 日志：使用 @Slf4j + log.info/warn/error
+```
+
+### 反面示例约束（防止常见错误）
+
+```
+## 请勿生成以下风格的代码：
+- Controller 直接返回 Entity（应使用 VO）
+- Controller 中写业务逻辑（应在 Service 层）
+- 使用 RuntimeException（应使用 BizException）
+- 在 Controller 中直接注入 Mapper
+- 使用 ${} 拼接 SQL（应使用 #{}）
+```

package/templates/.claude/skills/requirement-management/SKILL.md

@@ -0,0 +1,244 @@
+---
+name: requirement-management
+description: |
+  需求分析、评审与技术方案设计技能。当用户提到以下关键词时触发：
+  requirement, PRD, 需求分析, 技术方案, 需求拆解, 需求评审,
+  技术设计, 方案设计, 技术评审, PRD review, 需求检查
+
+  本技能覆盖两个阶段：
+  1. 需求评审 — 对 PRD 进行多维度检查，输出 pass/warn/fail 结论
+  2. 技术方案设计 — 从 PRD 到技术方案的完整拆解流程
+globs:
+  - "docs/**/*.md"
+  - "docs/**/*.txt"
+---
+
+# 需求管理技能（评审 + 技术方案）
+
+---
+
+## 第一阶段：需求评审
+
+对产品需求文档 (PRD) 进行系统化评审，覆盖六大维度，输出 pass / warn / fail 结论。
+
+### 评审维度与检查项
+
+#### 1. 完整性 (Completeness)
+
+| 检查项 | 说明 |
+|--------|------|
+| 业务场景覆盖 | 是否涵盖所有主流程与分支流程 |
+| 异常流程 | 是否描述了异常 / 边界场景的处理方式 |
+| 数据字典 | 关键字段是否给出类型、长度、枚举值 |
+| 依赖说明 | 上下游系统、中间件、第三方服务是否列出 |
+| 验收标准 | 是否提供可量化的验收条件 (AC) |
+
+#### 2. 清晰度 (Clarity)
+
+| 检查项 | 说明 |
+|--------|------|
+| 术语一致性 | 同一概念是否使用统一术语，无歧义 |
+| 流程图 / 时序图 | 复杂交互是否配有图示 |
+| 优先级标注 | 功能是否标注 P0 / P1 / P2 等优先级 |
+| 角色定义 | 操作角色与权限是否明确 |
+
+#### 3. 可测试性 (Testability)
+
+| 检查项 | 说明 |
+|--------|------|
+| 输入输出定义 | 接口入参、出参是否明确 |
+| 预期结果 | 每个场景是否有预期输出或状态变更 |
+| 测试数据 | 是否提供或可推导出测试数据 |
+| 边界值 | 是否标注数值范围、字符串长度等边界 |
+
+#### 4. 安全性 (Security)
+
+| 检查项 | 说明 |
+|--------|------|
+| 认证授权 | 是否说明鉴权方式 (JWT / OAuth2 等) |
+| 敏感数据 | 个人信息、密码等是否标注脱敏 / 加密要求 |
+| 输入校验 | 是否要求对用户输入进行校验与过滤 |
+| 审计日志 | 关键操作是否需要记录审计日志 |
+
+#### 5. 性能 (Performance)
+
+| 检查项 | 说明 |
+|--------|------|
+| 并发量预估 | 是否给出 QPS / TPS 预期 |
+| 响应时间 | 是否定义接口 RT 上限 (如 P99 < 200ms) |
+| 数据量级 | 是否说明初始与增长数据量 |
+| 降级方案 | 高负载时是否有降级 / 限流策略 |
+
+#### 6. 兼容性 (Compatibility)
+
+| 检查项 | 说明 |
+|--------|------|
+| 版本兼容 | 接口变更是否向后兼容 |
+| 多端适配 | 是否说明支持的客户端类型与版本 |
+| 数据迁移 | 数据库变更是否有迁移方案 |
+| 灰度策略 | 是否支持按比例 / 按用户灰度发布 |
+
+### 评审输出格式
+
+```markdown
+## 需求评审报告
+
+| 维度 | 结论 | 关键发现 |
+|------|------|----------|
+| 完整性 | pass / warn / fail | 具体说明 |
+| 清晰度 | pass / warn / fail | 具体说明 |
+| 可测试性 | pass / warn / fail | 具体说明 |
+| 安全性 | pass / warn / fail | 具体说明 |
+| 性能 | pass / warn / fail | 具体说明 |
+| 兼容性 | pass / warn / fail | 具体说明 |
+
+### 综合结论: pass / warn / fail
+
+### 建议改进项
+1. ...
+2. ...
+```
+
+---
+
+## 第二阶段：技术方案设计
+
+评审通过后，从 PRD 拆解为完整的技术方案。
+
+### 拆解工作流
+
+```
+1. 需求理解
+   ├── 阅读 PRD，提取核心业务需求
+   ├── 识别用户角色和使用场景
+   ├── 明确功能边界（做什么、不做什么）
+   └── 标记不明确的需求点，准备确认清单
+
+2. 模块识别
+   ├── 拆分功能模块
+   ├── 确定模块间依赖关系
+   ├── 映射到现有系统架构
+   └── 识别需要新增的模块
+
+3. 技术设计
+   ├── API 接口设计
+   ├── 数据库表设计
+   ├── 核心业务流程设计
+   └── 技术选型（如有新技术引入）
+
+4. 风险评估
+   ├── 技术风险识别
+   ├── 资源风险评估
+   ├── 时间风险分析
+   └── 制定应对措施
+
+5. 任务分解
+   ├── 拆分开发任务
+   ├── 评估工时
+   ├── 确定优先级和依赖
+   └── 制定开发计划
+```
+
+### 模块识别 — 映射到 Avatar Boot 架构
+
+```
+avatar-xxx-api (接口层)
+  ├── controller/
+  │   ├── XxxController.java
+  │   └── YyyController.java
+  └── dto/
+      ├── xxx/
+      └── yyy/
+
+avatar-xxx-service (业务层)
+  ├── service/
+  │   ├── XxxService.java
+  │   └── YyyService.java
+  ├── mapper/
+  │   ├── XxxMapper.java
+  │   └── YyyMapper.java
+  └── entity/
+      ├── Xxx.java
+      └── Yyy.java
+```
+
+### 从需求提取 API 设计
+
+1. 识别 PRD 中的用户操作（动词 + 名词）
+2. 映射为 RESTful 接口
+3. 确定输入输出，使用 `Result<T>` 统一返回
+
+### 风险识别模板
+
+| 分类 | 风险项 | 概率 | 影响 | 应对措施 |
+|------|--------|------|------|----------|
+| 技术 | 并发数据不一致 | 高 | 高 | Redis 分布式锁 + 乐观锁 |
+| 技术 | 外部服务超时 | 中 | 中 | Feign 超时 + 熔断降级 |
+| 资源 | 开发人员不足 | 中 | 中 | 按优先级分批交付 |
+| 时间 | 需求变更频繁 | 高 | 中 | 冻结需求节点，变更走评审 |
+
+### 技术方案输出模板
+
+```markdown
+# 技术方案 — [需求名称]
+
+## 1. 需求概述
+[简要描述需求背景和目标]
+
+## 2. 功能模块拆分
+| 模块 | 功能点 | 优先级 | 负责人 |
+|------|--------|--------|--------|
+| [模块名] | [功能描述] | P0/P1 | [人员] |
+
+## 3. 系统架构
+[描述整体架构和模块关系]
+
+## 4. API 接口设计
+| 接口 | 方法 | 描述 | 入参 | 出参 |
+|------|------|------|------|------|
+| /api/xxx | POST | [描述] | XxxCreateDTO | Result<Long> |
+
+## 5. 数据库设计
+### 新增表
+[表结构 DDL]
+
+### 变更表
+[ALTER 语句]
+
+## 6. 核心流程
+[关键业务流程描述]
+
+## 7. 依赖分析
+### 内部依赖
+[列出依赖的内部模块]
+
+### 外部依赖
+[列出依赖的外部服务和中间件]
+
+## 8. 风险评估
+| 风险 | 概率 | 影响 | 应对措施 |
+|------|------|------|----------|
+| [风险描述] | 高 | 高 | [措施] |
+
+## 9. 开发计划
+| 阶段 | 任务 | 工时 | 起止时间 |
+|------|------|------|----------|
+| 开发 | [任务描述] | X 人天 | MM-DD ~ MM-DD |
+
+## 10. 待确认事项
+- [ ] [需与产品确认的问题]
+- [ ] [需与其他团队确认的问题]
+```
+
+---
+
+## 最佳实践
+
+1. **评审先行** — 先完成需求评审，通过后再进入技术方案设计
+2. **逐项对照** — 按维度逐条检查，避免遗漏
+3. **引用原文** — 评审结论附上需求文档原文片段，便于定位
+4. **先理解再拆解** — 充分理解业务需求后再进行技术设计
+5. **渐进式设计** — 先设计核心流程，再补充边界和异常情况
+6. **评审驱动** — 技术方案完成后组织评审，收集反馈
+7. **风险前置** — 高风险项优先处理
+8. **文档先行** — API 接口设计先于编码，便于前后端并行开发