Files
PromptX/resource/role/java-backend-developer/execution/code-quality.execution.md
sean 559c146af1 refactor: 重构resource/domain为resource/role - 提升目录语义化
## 核心改进
- 将resource/domain重命名为resource/role,语义更清晰直观
- 统一更新所有硬编码路径引用,确保系统完整性
- 重新生成注册表,所有61个资源引用路径完全更新

## 目录结构优化
- resource/role (原domain) - 角色定义和专家能力
- resource/tool - JavaScript工具资源
- resource/protocol - 协议规范文档
- resource/core - 核心思维和执行模式

## 技术实现
### 发现器更新
- ProjectDiscovery.js: _scanDomainDirectory → _scanRoleDirectory
- PackageDiscovery.js: 同步更新函数名和路径引用
- 所有@project://.promptx/resource/domain/ → @project://.promptx/resource/role/
- 所有@package://resource/domain/ → @package://resource/role/

### 协议处理器
- PromptProtocol.js: domain注册表映射 → role注册表映射
- 更新协议示例和描述信息

### 注册表重新生成
- 使用generate-package-registry.js重新生成
- 61个资源路径引用全部更新为resource/role/
- 保持所有功能完全兼容

## 验证结果
-  角色发现功能正常:8个系统角色+1个项目角色
-  资源加载完全正常:61个资源正确识别
-  零功能影响:所有现有功能继续工作

这个重构显著提升了代码的语义化程度,role比domain更直观地表达目录用途,
同时建立了清晰的资源分类体系:role、tool、protocol、core。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:24:19 +08:00

1.9 KiB
Raw Blame History

# 代码质量管理流程
## 1. 代码规范制定
```mermaid
flowchart TD
    A[团队编码规范制定] --> B[代码格式化配置]
    B --> C[静态代码分析工具配置]
    C --> D[代码审查流程建立]
    D --> E[质量门禁设置]
    E --> F[持续集成集成]
```

## 2. 代码审查流程
```mermaid
flowchart TD
    A[代码提交] --> B[自动化检查]
    B --> C{检查通过?}
    C -->|是| D[人工代码审查]
    C -->|否| E[修复问题]
    E --> A
    D --> F{审查通过?}
    F -->|是| G[合并代码]
    F -->|否| H[修改建议]
    H --> E
```
# 代码质量最佳实践
## 编码规范
- **命名约定**:使用有意义的变量名和方法名
- **代码格式**:统一使用代码格式化工具
- **注释规范**:关键逻辑必须有清晰的注释
- **方法长度**单个方法不超过50行代码

## 代码结构
- **单一职责**:每个类和方法只负责一个职责
- **依赖管理**:合理管理类之间的依赖关系
- **设计模式**:恰当使用设计模式解决问题
- **重构意识**:定期重构消除代码坏味道
# 代码质量强制要求
1. **代码覆盖率**单元测试覆盖率不低于80%
2. **复杂度控制**圈复杂度不超过10
3. **重复代码**重复代码率不超过3%
4. **技术债务**:每个迭代必须分配时间处理技术债务
# 代码质量评价标准
- ✅ **可读性良好**:代码清晰易懂
- ✅ **可维护性强**:易于修改和扩展
- ✅ **性能表现佳**:无明显性能问题
- ✅ **安全性高**:无安全漏洞