6aspec 2.0.0-dev.3 → 2.0.0-dev.30

package/.6aspec/rules/biz/code.md

@@ -1,39 +1,133 @@
 ---
-description: 
-globs: 
-alwaysApply: false
+description: 代码编写规范与质量标准
+globs: "**/*.{java,js,ts,py,go,cpp,c,cs}"
+alwaysApply: true
 ---
 
-## 代码质量
-- **单一职责**：每个类和方法只负责一个功能
-- **开闭原则**：对扩展开放，对修改关闭
-- **依赖倒置**：依赖抽象而不是具体实现
-- **接口隔离**：使用小而专一的接口
-- **代码复用**：提取公共逻辑，避免重复代码
+# 代码编写规范
+
+## 🚨 红线规则（绝对禁止）
+
+### 性能红线
+- **禁止在循环中进行数据库查询**：避免N+1问题，使用批量查询或预加载
+- **禁止在循环中进行网络请求**：使用批量API或异步处理
+- **禁止在循环中进行文件I/O操作**：批量读写或使用缓存
+- **禁止在热点代码路径中使用反射**：影响性能，考虑编译时生成或缓存
+- **禁止在生产环境使用System.out.println调试**：使用日志框架
+
+### 安全红线
+- **禁止直接拼接SQL语句**：必须使用参数化查询防止SQL注入
+- **禁止在日志中输出敏感信息**：密码、token、身份证号等
+- **禁止硬编码密钥和敏感配置**：使用配置文件或环境变量
+- **禁止信任用户输入**：所有外部输入必须验证和过滤
+- **禁止使用弱加密算法**：MD5、SHA1等已不安全
+
+### 架构红线
+- **禁止循环依赖**：包、模块、类之间不能相互依赖
+- **禁止跨层直接调用**：Controller不能直接调用DAO
+- **禁止在实体类中包含业务逻辑**：保持实体类的纯净性
+- **禁止在静态代码块中进行复杂操作**：可能导致类加载问题
+- **禁止捕获异常后不处理**：空catch块是代码异味
+
+## 🔒 安全规范
+
+### 输入验证
+- **参数校验**：所有API入参必须校验
+- **数据过滤**：防止XSS、SQL注入等攻击
+- **权限检查**：每个操作都要验证用户权限
+- **敏感数据处理**：加密存储，脱敏展示
+
+### 日志安全
+- **敏感信息脱敏**：密码、token等不能明文记录
+- **操作审计**：关键操作必须记录审计日志
+- **错误信息**：不暴露系统内部信息给用户
+
+## ⚡ 性能优化
+
+### 数据库优化
+- **索引使用**：查询字段必须有合适的索引
+- **批量操作**：使用批量插入/更新减少数据库交互
+- **连接池管理**：合理配置数据库连接池
+- **查询优化**：避免全表扫描，使用分页查询
 
-## 性能优化
-- **算法复杂度**：选择合适的算法和数据结构
-- **缓存策略**：合理使用缓存减少重复计算
-- **懒加载**：对于昂贵的操作使用懒加载
-- **批量处理**：批量处理数据库操作和网络请求
+### 缓存策略
+- **多级缓存**：本地缓存 + 分布式缓存
+- **缓存更新**：及时更新或失效过期数据
+- **缓存穿透**：防止恶意查询不存在的数据
+- **缓存雪崩**：设置随机过期时间
 
+### 算法复杂度
+- **时间复杂度**：优先选择O(1)、O(log n)算法
+- **空间复杂度**：避免不必要的内存占用
+- **数据结构选择**：根据使用场景选择合适的数据结构
 
-## 编码规范
-- **命名规范**：类名、方法名、变量名清晰表达意图
-- **代码结构**：合理的包结构和类层次
-- **注释规范**：必要的类和方法注释
-- **代码复用**：避免重复代码，提取公共方法
+## 📝 编码规范
 
+### 命名规范
+- **类名**：大驼峰命名，名词，表达清晰意图
+- **方法名**：小驼峰命名，动词开头，表达具体行为
+- **变量名**：小驼峰命名，避免缩写，见名知意
+- **常量名**：全大写，下划线分隔
+- **包名**：全小写，层次清晰
 
-## 设计原则
-- **SOLID 原则**：单一职责、开闭原则等
-- **DRY 原则**：不重复自己
-- **KISS 原则**：保持简单
-- **YAGNI 原则**：你不会需要它
+### 代码结构
+- **包结构**：按功能模块划分，层次清晰
+- **类大小**：单个类不超过500行
+- **方法长度**：单个方法不超过50行
+- **参数个数**：方法参数不超过5个
+- **嵌套层次**：代码嵌套不超过4层
 
+### 注释规范
+- **类注释**：说明类的职责和使用场景
+- **方法注释**：说明参数、返回值、异常
+- **复杂逻辑注释**：解释为什么这样做
+- **TODO注释**：标记待完成的工作
 
-## 重构策略
-- **持续重构**：小步快跑，持续改进
+## 🏗️ 设计原则
+
+### SOLID原则
+- **单一职责原则**：一个类只负责一个功能领域
+- **开闭原则**：对扩展开放，对修改关闭
+- **里氏替换原则**：子类可以替换父类
+- **接口隔离原则**：使用多个专门的接口
+- **依赖倒置原则**：依赖抽象而不是具体实现
+
+### 其他原则
+- **DRY原则**：不重复自己，提取公共代码
+- **KISS原则**：保持简单，避免过度设计
+- **YAGNI原则**：你不会需要它，不做过度设计
+- **最少知识原则**：对象应该对其他对象有最少的了解
+
+## 🔄 重构策略
+
+### 重构时机
+- **新功能开发时**：同步重构相关代码
+- **Bug修复时**：改善代码结构
+- **代码审查时**：发现问题及时重构
+- **性能优化时**：重构性能瓶颈代码
+
+### 重构原则
+- **小步快跑**：每次重构范围要小
 - **测试保护**：重构前确保测试覆盖
-- **重构时机**：新功能开发时同步重构
-- **技术债务**：定期评估和偿还技术债务
+- **持续集成**：频繁提交，及时发现问题
+- **技术债务管理**：定期评估和偿还
+
+## ✅ 检查清单
+
+### 代码提交前检查
+- [ ] 是否违反红线规则
+- [ ] 是否有安全漏洞
+- [ ] 是否有性能问题
+- [ ] 命名是否规范
+- [ ] 是否有充分的测试
+- [ ] 是否有必要的注释
+- [ ] 是否符合团队编码风格
+
+### 代码审查检查
+- [ ] 业务逻辑是否正确
+- [ ] 异常处理是否完善
+- [ ] 边界条件是否考虑
+- [ ] 是否有代码重复
+- [ ] 是否符合设计原则
+- [ ] 是否有技术债务
+- [ ] 文档是否需要更新

package/.6aspec/rules/biz/code_implementation_sop.md

@@ -0,0 +1,77 @@
+---
+description: 代码实现标准操作流程 (Code Implementation SOP)
+alwaysApply: false
+---
+
+# code: 代码实现标准操作流程
+
+你现在是 **Senior Developer**，负责根据用户描述的需求编写高质量、可运行的业务代码。
+
+## 0. 需求类型智能判断
+
+分析用户描述中的关键词和场景，判断需求类型：
+
+**判断规则**：
+- **API接口**：接口、API、Controller、HTTP、REST、查询、新增、修改、删除、DataApi
+- **后台任务**：BackgroundJob、异步任务、批量操作、批量绑定、批量解绑、批量更新
+- **定时任务**：定时任务、Job、定时执行、Cron、每天、每小时、凌晨、定时清理
+- **事件订阅**：EventSubscriber、监听事件、订阅、事件处理、事件触发
+- **其他类型**：不属于以上四种类型（工具类、辅助方法、配置类、实体类等）
+
+**判断输出**：
+```
+📋 需求类型：<类型名称>
+📚 加载规范：<规范文件列表>
+```
+
+## 1. 上下文加载
+
+### 1.1 必须加载（所有类型）
+1. `.6aspec/rules/biz/code.md` - 代码编写规范
+2. `.6aspec/rules/biz/project-structure.md` - 项目结构规范
+
+### 1.2 根据类型加载
+- **API接口** → `.6aspec/rules/biz/api_rule.md`
+- **后台任务** → `.6aspec/rules/biz/background_job_rule.md`
+- **定时任务** → `.6aspec/rules/biz/scheduled_job_rule.md`
+- **事件订阅** → `.6aspec/rules/biz/event_subscriber_rule.md`
+- **其他类型** → 只加载基础规范
+
+## 2. 代码实现
+
+严格按照加载的规范文件进行实现，遵循规范中定义的：
+- 包结构和命名规范
+- 类结构和注解使用
+- 实现顺序和关键要点
+- 异常处理和日志记录
+
+## 3. 质量检查
+
+### 3.1 代码规范检查
+使用 `.6aspec/rules/biz/code.md` 中的"检查清单"进行自我验证。
+
+**红线规则（零容忍）**：
+- [ ] 循环中的数据库查询、网络请求、文件I/O操作
+- [ ] SQL字符串拼接、敏感信息硬编码、弱加密算法使用
+- [ ] 循环依赖、跨层直接调用、空catch块
+
+### 3.2 类型特定检查
+使用对应规范文件中的"检查清单"章节进行验证。
+
+## 4. 完成输出
+
+```
+✅ 代码实现完成
+
+**需求类型**：<类型名称>
+**实现文件**：<文件列表>
+**关键点**：<关键实现点>
+```
+
+## 5. 异常处理
+
+遇到以下情况时停止并报告：
+- 需求不清晰，无法判断类型或实现方式
+- 缺少必要信息（参数定义、消息类型等）
+- 技术方案冲突，与现有架构或规范冲突
+- 依赖缺失，需要的 Service、Repository 等不存在

package/.6aspec/rules/brown/brown_archive_sop.md

@@ -9,8 +9,11 @@
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.review` 为 "done"
-   - 如果未完成 Phase 7，询问是否强制归档
+   - 获取 `flowDepth`（流程深度）
+   - 根据流程深度检查前置条件：
+     - **轻量级/标准级流程**：确认 `phases.implement` 为 "done" 或 `status` 为 "completed"
+     - **完整级流程**：确认 `phases.review` 为 "done"
+   - 如果未满足前置条件，询问是否强制归档
 
 2. **确认归档**
 
@@ -36,6 +39,9 @@
 
    c. **更新归档状态**
    在归档目录中创建 `archive-info.json`：
+
+   **注意**：所有时间戳必须使用东八区（北京时间）格式：`yyyy-MM-dd HH:mm:ss`（例如：`2026-02-20 12:36:23`）
+
    ```json
    {
      "name": "<name>",
@@ -44,8 +50,7 @@
      "originalPath": "6aspecdoc/brown/<name>",
      "archivePath": "6aspecdoc/brown/.archived/<timestamp>-<name>",
      "completedPhases": 7,
-     "totalTasks": 8,
-     "priority": "P0/P1/P2"
+     "totalTasks": 8
    }
    ```
 
@@ -56,7 +61,6 @@
    # 归档摘要：<name>
 
    > **归档时间**: <timestamp>
-   > **优先级**: P0/P1/P2
    > **完成阶段**: 7/7
    > **总任务数**: 8
    > **总工时**: <工时>
@@ -74,13 +78,13 @@
 
    ## 关键文档
 
-   - 01-understanding.md - 需求理解与现状分析
-   - 02-impact-analysis.md - 影响面分析
-   - 03-technical-design.md - 技术方案设计
+   - understanding.md - 需求理解与现状分析
+   - impact-analysis.md - 影响面分析
+   - design.md - 技术方案设计
    - 04-tasks-overview.md - 任务拆解
    - 05-verification-report.md - 验证报告
    - 06-post-implementation-review.md - 实施后评估
-   - ADR-<name>.md - 架构决策记录（P0）
+   - ADR-<name>.md - 架构决策记录（如有）
 
    ## 经验教训
 
@@ -104,7 +108,6 @@
 **归档位置**: 6aspecdoc/brown/.archived/<timestamp>-<name>/
 
 ### 需求统计
-- 优先级：P0/P1/P2
 - 完成阶段：7/7
 - 总任务数：8
 - 总工时：<工时>
@@ -126,7 +129,10 @@
 ```
 
 **防护措施**
-- 如果未完成所有阶段，警告用户并询问是否强制归档
+- 根据流程深度检查不同的前置条件：
+  - 轻量级/标准级：implement 必须完成
+  - 完整级：review 必须完成
+- 如果未满足前置条件，警告用户并询问是否强制归档
 - 归档前必须确认
 - 归档操作不可逆（除非手动恢复）
 - 保留完整的归档信息和摘要

package/.6aspec/rules/brown/brown_constitution.md

@@ -6,6 +6,17 @@
 
 **所有生成的文档内容必须使用中文**，包括标题、字段名、描述等所有文本内容。
 
+## 时间格式规范
+
+**所有时间戳必须使用东八区（北京时间）格式**：`yyyy-MM-dd HH:mm:ss`
+
+示例：`2026-02-20 12:36:23`
+
+适用范围：
+- status.json 中的 `createdAt`、`lastModified`、`completedAt` 等字段
+- 所有 artifacts 文档中的时间戳（创建时间、完成时间、评估时间等）
+- 归档时使用的时间戳
+
 ## 核心行为规则
 
 1. **阶段化推进**：每个阶段完成后必须停止，等待用户通过显式命令推进

package/.6aspec/rules/brown/brown_continue_sop.md

@@ -30,7 +30,9 @@
    **如果所有阶段都完成 (`phases` 全部为 "done")**：
    - 祝贺用户
    - 显示最终状态
-   - 建议："所有阶段已完成！可以运行 `/6aspec:brown:implement` 开始实施，或运行 `/6aspec:brown:archive` 归档。"
+   - 根据流程深度给出建议：
+     - 轻量级/标准级："所有阶段已完成！可以运行 `/6aspec:brown:verify` 进行质量检查（可选），或运行 `/6aspec:brown:archive` 归档。"
+     - 完整级："所有阶段已完成！可以运行 `/6aspec:brown:archive` 归档。"
    - 停止
 
    **如果有待执行的阶段**：
@@ -39,22 +41,27 @@
 
    **轻量级流程（lightweight）**：
    - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`
+   - 如果 implement 已完成且无待执行阶段 → 提示："所有阶段已完成！可以运行 `/6aspec:brown:verify` 进行质量检查（可选），或运行 `/6aspec:brown:archive` 归档。"
 
    **标准级流程（standard）**：
    - `understand` → 调用 `/6aspec:brown:understand`
-   - `specs` → 调用 `/6aspec:brown:specs`
    - `impact` → 调用 `/6aspec:brown:impact`
+   - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`
+   - 如果 implement 已完成且无待执行阶段 → 提示："所有阶段已完成！可以运行 `/6aspec:brown:verify` 进行质量检查（可选），或运行 `/6aspec:brown:archive` 归档。"
 
    **完整级流程（complete）**：
    - `understand` → 调用 `/6aspec:brown:understand`
-   - `specs` → 调用 `/6aspec:brown:specs`
    - `impact` → 调用 `/6aspec:brown:impact`
+   - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`