ai-dev-flow 3.10.0__py3-none-any.whl

ai_dev_flow/data/profiles/java-spring.yml

@@ -0,0 +1,140 @@
+# ============================================================
+# Java Spring 项目画像 - 通用模板
+# ============================================================
+# 本文件是初始化时的默认模板。
+# 执行 init-project.ps1 时，AI 会扫描目标项目并自动生成更准确的 profile。
+# 如果目标项目为空，则直接使用本模板。
+# ============================================================
+
+profile: java-spring
+
+description: Java Spring 后端工程通用规则
+
+projectRules:
+  allowGlobalRefactor: false
+  allowDeleteExistingLogic: false
+  allowDbChangeByDefault: false
+  requirePlanBeforeCode: true
+  requireReviewAfterCode: true
+  preferSmallScopedChanges: true
+  protectUserChanges: true
+  commentLanguage: zh-CN
+  logLanguage: zh-CN
+
+backend:
+  language: Java
+  jdk:
+    compileRelease: 17
+  buildTool: Maven
+  packaging: multi-module
+  commonFrameworks:
+    - Spring Boot 3
+    - Spring MVC
+    - Spring Cloud
+    - MyBatis
+    - Lombok
+    - Swagger / OpenAPI annotations
+
+dataAccess:
+  mongodb:
+    enabled: false
+    style:
+      - MongoTemplate
+      - MongoRepository
+  redis:
+    enabled: false
+  mysqlOrJdbc:
+    enabled: true
+    style:
+      - MyBatis mapper
+      - Spring JDBC
+
+# 框架特化信息（Phase 0 自动填充，初始为通用默认值）
+framework:
+  name: "Spring Boot"
+  routing: "annotation-based"
+  security:
+    type: "none"
+    annotation: ""
+  menuManagement: "none"
+  orm:
+    type: "MyBatis"
+    mapperLocation: "**/mapper/**/*.xml"
+
+# 数据库特化信息
+database:
+  dictTables: []
+  menuTable: ""
+  migrationPath: ""
+
+# 前端信息（如存在前端工程）
+frontend:
+  enabled: false
+  framework: ""
+  uiLibrary: ""
+  buildTool: ""
+  routing: ""
+
+layers:
+  - controller
+  - service
+  - dao
+  - mapper
+  - config
+  - dto
+  - vo
+  - po
+  - entity
+
+# 模块分组（初始化时由 AI 扫描项目自动生成）
+moduleGroups: {}
+
+commands:
+  # 编译验证（跳过测试，用于快速检查阶段）
+  compileOnly:
+    - mvn -DskipTests compile
+  # 编译 + 测试（编码完成后必须执行，用于验证无编译错误和回归）
+  build:
+    - mvn clean package
+  # 单独执行测试
+  test:
+    - mvn test
+
+codingRules:
+  scope:
+    - 默认只修改用户指定模块；跨模块修改前先说明原因。
+    - 不做无关格式化、包名调整、批量重命名或全局重构。
+  java:
+    - 保持现有包结构和命名习惯。
+    - 优先复用已有 DTO、PO、DAO、Service、工具类。
+    - 日志使用 slf4j，占位符写法，不拼接敏感信息。
+    - 新增关键逻辑时写中文注释。
+    - 控制台联调用日志优先中文。
+  spring:
+    - Controller 层只做入参出参和路由，业务逻辑放 Service。
+    - 配置项优先使用 application.properties 现有命名方式。
+
+# 受保护路径（初始化时由 AI 扫描项目自动生成更完整列表）
+protectedPaths:
+  - "**/src/main/resources/application-prod.yml"
+  - "**/src/main/resources/application-prod.yaml"
+  - "**/src/main/resources/application.yml"
+  - "**/src/main/resources/application.yaml"
+  - "**/src/main/resources/bootstrap.yml"
+  - "**/src/main/resources/bootstrap.yaml"
+  - "sql/prod/**"
+  - "deploy/**"
+  - "**/Dockerfile"
+
+generatedOrIgnoredPaths:
+  - "**/target/**"
+  - ".idea/**"
+  - ".svn/**"
+  - ".git/**"
+
+reviewRules:
+  afterCodeChange:
+    - 检查是否误改非目标模块。
+    - 检查是否改动 protectedPaths。
+    - 检查日志是否泄露密码、accessKey、token、连接串凭据。
+    - 检查 Mongo/Redis 查询是否有明显全表风险。

ai_dev_flow/data/recipes/steps/00-init-project.yaml

@@ -0,0 +1,168 @@
+version: "1.0.0"
+title: "阶段 0 - 项目初始化"
+description: "扫描目标项目，自动生成项目画像和架构地图"
+instructions: |
+  你是一个项目分析专家。你的任务是扫描目标项目的完整代码库，
+  提取所有关键架构信息，生成精准的项目画像文件。
+
+  核心规则：
+  1. 只读取文件，不修改任何代码。
+  2. 用文件系统操作（glob/grep）尽可能多地发现信息。
+  3. 所有发现写入输出文件，不要只记在脑中。
+
+parameters:
+  - key: project_root
+    input_type: string
+    requirement: required
+    description: "项目根目录"
+  - key: output_profile
+    input_type: string
+    requirement: required
+    description: "增强版项目画像输出路径"
+  - key: output_project_map
+    input_type: string
+    requirement: required
+    description: "项目架构地图输出路径"
+
+prompt: |
+  你是一个项目分析专家。你需要扫描目标项目 {{ project_root }}，
+  生成两份关键文档。
+
+  ## 第一步：扫描后端
+
+  1. 找到 pom.xml（可能在根目录或子目录）：
+     - 提取 Spring Boot 版本、Java 版本
+     - 识别 ORM 框架（MyBatis/MyBatis-Plus/JPA）
+     - 识别权限框架（Sa-Token/Spring Security/Shiro）
+     - 识别工具库（Hutool/Lombok/MapStruct）
+     - 列出所有 Maven 子模块
+
+  2. 找到 Controller 文件（搜索 @RestController 或 @Controller）：
+     - 提取 URL 映射模式（@RequestMapping 路径）
+     - 提取权限注解（@SaCheckPermission / @PreAuthorize 等）
+     - 记录命名规范（CamelCase vs kebab-case vs lowerCamel）
+
+  3. 找到 SQL 脚本目录（搜索 *.sql 文件）：
+     - 检查 sys_menu 或 menu 相关表结构
+     - 检查 sys_dict_type/sys_dict_data 表
+     - 了解迁移脚本命名规范
+
+  4. 找到 application.yml / application.properties：
+     - 确认数据库配置
+     - 确认 Redis 配置
+
+  ## 第二步：扫描前端
+
+  1. 找到 package.json：
+     - 提取 Vue 版本、Element Plus 版本
+     - 提取构建工具（Vite/Webpack）
+     - 提取状态管理（Pinia/Vuex）
+
+  2. 找到现有页面（views/ 目录）：
+     - 确认目录结构模式
+     - 确认组件拆分模式（index.vue + useXxx.js + components/）
+
+  3. 找到 API 层（api/ 目录）：
+     - 确认 API 封装模式
+     - 确认 request 封装路径
+
+  4. 找到路由配置（router/ 目录或搜索路由相关代码）：
+     - 确认是静态路由还是动态路由（从服务端菜单树加载）
+     - 如果是动态路由，记录获取菜单的 API 路径
+
+  ## 第三步：生成输出
+
+  ### A. 写入增强版 profile.yml 到 {{ output_profile }}
+
+  基于扫描结果，写入完整的 profile.yml，至少包含：
+  ```yaml
+  profile: java-spring
+  description: 自动生成的进销存 WMS 项目画像
+
+  projectRules:
+    allowGlobalRefactor: false
+    allowDeleteExistingLogic: false
+    allowDbChangeByDefault: false
+    requirePlanBeforeCode: true
+    requireReviewAfterCode: true
+
+  backend:
+    language: Java
+    jdk:
+      compileRelease: <检测到的Java版本>
+    buildTool: Maven
+    packaging: multi-module
+    commonFrameworks:
+      - <检测到的框架列表>
+    modules:
+      <模块名>: <模块路径>
+
+  frontend:
+    framework: Vue
+    version: <检测到的Vue版本>
+    uiLibrary: Element Plus
+    buildTool: Vite
+    routing: db-driven  # 或 static，根据实际检测结果
+
+  framework:
+    name: RuoYi-Vue-Plus  # 根据实际检测
+    version: <检测到的版本>
+    routing: db-driven
+    security:
+      type: Sa-Token
+      annotation: "@SaCheckPermission"
+    menuManagement: db-driven
+    orm:
+      type: MyBatis-Plus
+      mapperLocation: "**/mapper/**/*.xml"
+
+  database:
+    dictTables:
+      - sys_dict_type
+      - sys_dict_data
+    menuTable: sys_menu
+    migrationPath: <检测到的SQL脚本目录>
+
+  codingRules:
+    controller:
+      urlPattern: <检测到的URL模式>
+      permissionAnnotation: <检测到的权限注解>
+    frontend:
+      pageStructure: <检测到的页面结构模式>
+      apiPattern: <检测到的API封装模式>
+
+  commands:
+    compileOnly:
+      - mvn -DskipTests compile
+    build:
+      - mvn clean package
+    test:
+      - mvn test
+
+  protectedPaths:
+    - "**/src/main/resources/application-prod.yml"
+    - "**/src/main/resources/application.yml"
+  ```
+
+  ### B. 写入项目架构地图到 {{ output_project_map }}
+
+  包含以下章节：
+  1. 模块结构图
+  2. 关键目录说明
+  3. 数据库表清单（从SQL脚本提取）
+  4. 菜单和权限体系说明（如适用）
+  5. 页面和路由对应关系
+  6. 开商约定（命名规范、代码模式）
+
+  完成后输出：
+  ```
+  === 项目初始化完成 ===
+  画像已写入：{{ output_profile }}
+  地图已写入：{{ output_project_map }}
+  ```
+
+extensions:
+  - type: builtin
+    name: developer
+    timeout: 600
+    bundled: true

ai_dev_flow/data/recipes/steps/01-refine-requirement.yaml

@@ -0,0 +1,117 @@
+version: "1.0.0"
+title: "阶段 1 - 需求精炼"
+description: "将用户的原始需求转化为结构化的、AI 可直接执行的需求文档"
+instructions: |
+  你是一个需求精炼专家。你的任务是把用户的原始想法转化为结构化的需求文档。
+
+  核心规则：
+  1. 仅输出需求文档到 {{ requirement }}，禁止编写任何源代码文件（.java/.py/.ts/.js/.go/.rs/.kt/.swift 等）。
+  2. 仅允许写入 {{ requirement }}，禁止修改项目中的源代码、配置、SQL 迁移等文件。
+  3. 直接从原始需求文件中提取信息进行分析。所有不明确的点，在需求文档中用 `[待确认]` 标注，不要追问用户。
+
+parameters:
+  - key: project_root
+    input_type: string
+    requirement: required
+    description: "项目根目录"
+  - key: profile
+    input_type: string
+    requirement: required
+    description: "项目画像文件路径"
+  - key: project_map
+    input_type: string
+    requirement: required
+    description: "项目架构地图路径（Phase 0 产出）"
+  - key: requirement_raw
+    input_type: string
+    requirement: required
+    description: "原始需求文件路径（从阶段 0 输入）"
+  - key: requirement
+    input_type: string
+    requirement: required
+    description: "精炼后需求输出路径"
+
+prompt: |
+  你是一个需求精炼专家。你的任务是把用户的**原始想法**转化为结构化的、AI 可直接执行的需求文档。
+
+  ## 输入
+
+  1. 用户的原始需求描述（从 {{ requirement_raw }} 读取）
+  2. 项目画像：{{ profile }}（包含框架类型、路由模式、权限体系等关键约束）
+  3. 项目架构地图：{{ project_map }}（包含模块结构、目录约定、数据库表清单）
+  4. 项目代码仓库：{{ project_root }}
+
+  ## 执行规则
+
+  1. **仅输出需求文档，禁止编写任何源代码（.java/.py/.ts/.js/.go/.rs/.kt/.swift 等）。**
+  2. **仅允许写入 {{ requirement }}，禁止修改项目源代码、配置、SQL 迁移等文件。**
+  3. **先从 {{ profile }} 和 {{ project_map }} 了解项目框架约定**，特别是：
+     - 路由是注解驱动还是数据库驱动？
+     - 权限框架是什么？用什么注解？
+     - 菜单/页面的注册方式？（代码配置 vs 数据库INSERT）
+     - SQL 迁移脚本的存放路径和命名规范？
+  4. **直接从 {{ requirement_raw }} 和 {{ project_root }} 中提取信息进行需求精炼。**
+  5. **不要向用户提问。** 所有不确定的点，在需求文档中用 `[待确认: 具体问题]` 标注即可。
+  6. **精炼完成后，立即将结果写入 {{ requirement }}。**
+
+  ## 输出格式
+
+  精炼后的需求必须包含以下所有章节，不可省略：
+
+  ```
+  # 功能需求
+
+  ## 功能名称
+  （模块.子功能，一句话说清楚）
+
+  ## 业务背景
+  - 业务场景
+  - 解决什么问题
+  - 谁会使用
+  - 不做会怎样
+
+  ## 功能要求
+  ### 涉及的模块/表
+  （从代码仓库中确认的现有模块和表）
+
+  ### 接口定义（如有）
+  - 接口路径/方法
+  - 请求参数（字段表）
+  - 响应参数（字段表）
+
+  ### 业务流程
+  （文字描述或流程图）
+
+  ## 限制条件
+  1. 不允许修改已有接口路径
+  2. 不允许删除已有业务逻辑
+  3. 不允许全局重构
+  4. 涉及数据库变更时，必须先输出 SQL、回滚 SQL、影响范围
+  5. 实现前必须先输出工程方案
+
+  ## 验收标准
+  （可量化、可测试，每条约 1 行）
+
+  ## 补充信息
+  ```
+
+  ## 完成后
+
+  需求写入 {{ requirement }} 后，输出：
+
+  ```
+  === 需求精炼完成 ===
+
+  需求已写入：{{ requirement }}
+
+  已澄清的关键设计决策：
+  - xxx
+
+  是否可以进入自动规划阶段：是/否
+  ```
+
+extensions:
+  - type: builtin
+    name: developer
+    timeout: 300
+    bundled: true

ai_dev_flow/data/recipes/steps/02-analysis.yaml

@@ -0,0 +1,97 @@
+version: "1.0.0"
+title: "阶段 2 - 需求分析"
+description: "拆解功能点、数据流、界面逻辑，列出所有不确定项"
+instructions: |
+  你是资深需求分析师。
+
+  基于已确认的结构化需求文档，分析输出需求分析报告。
+  核心产出：功能拆分、数据流、界面逻辑、以及所有**不确定项**。
+
+  仅输出分析报告到 {{ output_analysis }}，禁止编写任何源代码文件（.java/.py/.ts/.js/.go 等）。
+
+parameters:
+  - key: project_root
+    input_type: string
+    requirement: required
+    description: "项目根目录"
+  - key: requirement
+    input_type: string
+    requirement: required
+    description: "精炼后的需求文件路径"
+  - key: profile
+    input_type: string
+    requirement: required
+    description: "项目画像文件路径"
+  - key: project_map
+    input_type: string
+    requirement: required
+    description: "项目架构地图路径"
+  - key: output_analysis
+    input_type: string
+    requirement: required
+    description: "需求分析报告输出路径"
+
+prompt: |
+  基于以下文件进行需求分析：
+
+  1. 精炼需求：{{ requirement }}
+  2. 项目画像：{{ profile }}（包含框架类型、路由模式、权限体系）
+  3. 项目架构地图：{{ project_map }}（包含模块结构、目录约定、数据库表清单）
+  4. 项目代码仓库：{{ project_root }}
+
+  ## 执行规则
+
+  1. 仅输出分析报告，禁止编写任何源代码（.java/.py/.ts/.js/.go 等）。
+  2. 禁止修改项目中的源代码文件、配置文件、SQL 迁移脚本。
+  3. 分析必须基于项目代码仓库中的现有代码。如果找不到对应模块，记录为问题。
+  4. 根据 {{ profile }} 中的 framework 信息，特别关注：
+     - 如果 routing=db-driven，新增页面必须确认菜单SQL的存放路径和格式
+     - 如果 menuManagement=db-driven，分析 sys_menu 表结构和现有菜单SQL的模式
+     - 确认权限注解类型，分析现有权限标识的命名规范
+
+  ## 分析内容
+
+  将分析结果写入 {{ output_analysis }}，包含以下章节：
+
+  ### 1. 功能拆分
+  将需求拆分为可独立实现的功能点，每个功能点标注：
+  - 功能名称
+  - 涉及模块（从代码仓库确认）
+  - 关联数据表
+  - 优先级 P0/P1/P2
+
+  ### 2. 数据流
+  - 数据从哪来（用户输入/外部系统/数据库）
+  - 数据怎么流转
+  - 数据最终存哪里
+
+  ### 3. 界面逻辑（如果涉及前端）
+  - 页面有哪些
+  - 交互流程
+  - 输入验证
+
+  ### 4. 不确定项（**最关键的部分**）
+  列出所有在当前信息下无法确定的问题，例如：
+  - 某个字段取值规则
+  - 异常情况的处理方式
+  - 性能要求
+  - 兼容性要求
+  - 依赖的第三方服务/API
+  - 某些功能点是否在现有代码中有对应实现
+
+  每条不确定项格式：
+  ```
+  - [ ] 问题描述 | 建议默认方案 | 需要确认人
+  ```
+
+  ### 5. 影响范围
+  - 需要修改的模块/文件列表
+  - 是否有数据库变更
+  - 是否有配置变更
+  - 是否有接口兼容性影响
+
+extensions:
+  - type: builtin
+    name: developer
+    timeout: 300
+    bundled: true

ai_dev_flow/data/recipes/steps/03-design.yaml

@@ -0,0 +1,91 @@
+version: "1.0.0"
+title: "阶段 3 - 工程方案"
+description: "基于已确认的需求和需求分析，做架构设计、接口定义、数据模型"
+instructions: |
+  你是资深架构师。
+
+  基于已确认的需求文档和需求分析报告，输出工程方案。
+  所有不确定项已在检查点中闭环，不要在方案中引入新的不确定项。
+
+  不要修改项目的源代码文件（.java、.vue、.xml、.yml、.properties 等）。
+
+  **必须执行**：将工程方案完整写入 {{ output_plan }} 文件。
+  这是不可跳过的强制步骤。即使项目中已有部分代码，
+  仍需输出剩余工作的工程方案。
+
+parameters:
+  - key: project_root
+    input_type: string
+    requirement: required
+    description: "项目根目录"
+  - key: requirement
+    input_type: string
+    requirement: required
+    description: "精炼后的需求文件路径"
+  - key: input_analysis
+    input_type: string
+    requirement: required
+    description: "需求分析报告路径"
+  - key: profile
+    input_type: string
+    requirement: required
+    description: "项目画像文件路径"
+  - key: output_plan
+    input_type: string
+    requirement: required
+    description: "工程方案输出路径"
+
+prompt: |
+  **重要：你必须将工程方案完整写入 {{ output_plan }} 文件。这是本任务的唯一交付物，不可跳过。**
+
+  基于以下文件输出工程方案：
+
+  1. 精炼需求：{{ requirement }}
+  2. 需求分析：{{ input_analysis }}
+  3. 项目画像：{{ profile }}
+  4. 项目代码仓库：{{ project_root }}
+
+  ## 执行规则
+
+  1. 不要修改项目的源代码文件（.java、.vue、.xml、.yml、.properties 等）。
+  2. 所有方案必须基于现有代码的实际情况。如果现有代码的结构与需求分析描述不符，以代码实际情况为准并记录差异。
+  3. 不要在方案中引入新的不确定项。
+
+  ## 输出内容
+
+  将工程方案写入 {{ output_plan }}，包含以下章节：
+
+  ### 1. 架构设计
+  - 涉及的模块
+  - 模块间调用关系
+  - 数据流向
+  - 是否引入新依赖
+
+  ### 2. 接口定义（如有）
+  每个接口：
+  - 路径 / 方法
+  - 请求参数（字段名、类型、必填、说明）
+  - 响应参数（字段名、类型、说明）
+  - 错误码
+
+  ### 3. 数据模型
+  - 新增/修改的表结构（字段名、类型、约束、索引）
+  - SQL 语句（建表/加字段/修改字段）
+  - 回滚 SQL
+
+  ### 4. 代码变更
+  - 需要修改的文件列表（路径 + 修改内容摘要）
+  - 需要新增的文件列表
+  - 需要删除的文件列表
+  - 配置变更
+
+  ### 5. 测试方案
+  - 单元测试范围
+  - 集成测试范围
+  - 手动测试步骤
+
+extensions:
+  - type: builtin
+    name: developer
+    timeout: 300
+    bundled: true