TRUST 5 质量框架

def calculate_discount(price: float, discount_rate: float) -> float:
    """计算折后价格。
 
    Args:
        price: 原价（0 或以上）
        discount_rate: 折扣率（0.0 ~ 1.0）
 
    Returns:
        折后价格
 
    Raises:
        ValueError: 对于无效输入值
    """
    if price < 0:
        raise ValueError("价格不能低于 0")
    if not 0 <= discount_rate <= 1:
        raise ValueError("折扣率必须在 0.0 和 1.0 之间")
    return price * (1 - discount_rate)
 
 
# 测试验证正常和异常情况
def test_calculate_discount_normal():
    assert calculate_discount(10000, 0.1) == 9000
    assert calculate_discount(5000, 0.5) == 2500
    assert calculate_discount(0, 0.5) == 0
 
def test_calculate_discount_invalid_price():
    with pytest.raises(ValueError, match="价格不能"):
        calculate_discount(-1000, 0.1)
 
def test_calculate_discount_invalid_rate():
    with pytest.raises(ValueError, match="折扣率"):
        calculate_discount(10000, 1.5)

# 差：从名称无法看出它做什么
def calc(d, r):
    return d * (1 - r)
 
# 好：只需阅读名称就能理解
def calculate_discounted_price(original_price: float, discount_rate: float) -> float:
    """从 original_price 计算由 discount_rate 折扣的价格。"""
    return original_price * (1 - discount_rate)

# 统一的错误处理模式
class AppError(Exception):
    """应用程序基础错误"""
    def __init__(self, message: str, code: int = 500):
        self.message = message
        self.code = code
 
class NotFoundError(AppError):
    """未找到资源"""
    def __init__(self, resource: str, id: str):
        super().__init__(f"{resource} '{id}' 未找到", code=404)
 
class ValidationError(AppError):
    """输入验证失败"""
    def __init__(self, field: str, reason: str):
        super().__init__(f"'{field}' 验证失败: {reason}", code=400)
 
# 在所有服务中使用相同模式
def get_user(user_id: str) -> User:
    user = user_repository.find_by_id(user_id)
    if not user:
        raise NotFoundError("User", user_id)
    return user

# 差：SQL 注入漏洞
def get_user(username: str) -> dict:
    query = f"SELECT * FROM users WHERE username = '{username}'"
    return db.execute(query)
 
# 好：使用参数化查询安全
def get_user(username: str) -> dict:
    query = "SELECT * FROM users WHERE username = %s"
    return db.execute(query, (username,))

# 结构: <type>(<scope>): <description>
# 示例:
 
# 添加新功能
$ git commit -m "feat(auth): 添加 JWT 登录 API"
 
# 修复 Bug
$ git commit -m "fix(auth): 修复令牌过期时间计算错误"
 
# 重构
$ git commit -m "refactor(auth): 将认证逻辑分离到 AuthService"
 
# 安全改进
$ git commit -m "security(db): 使用参数化查询防止 SQL 注入"

# 运行自动修复
> /moai fix
 
# 重复自动修复直到完成
> /moai loop

constitution:
  # 启用 TRUST 5 质量验证
  enforce_quality: true
 
  # 目标测试覆盖率
  test_coverage_target: 85
 
  # LSP 质量门设置
  lsp_quality_gates:
    enabled: true
 
    plan:
      require_baseline: true # 在 Plan 开始时捕获基线
 
    run:
      max_errors: 0 # Run 阶段错误允许：0
      max_type_errors: 0 # 类型错误允许：0
      max_lint_errors: 0 # Lint 错误允许：0
      allow_regression: false # 不允许从基线回归
 
    sync:
      max_errors: 0 # Sync 阶段错误允许：0
      max_warnings: 10 # 警告允许：最多 10
      require_clean_lsp: true # 要求清洁的 LSP 状态
 
    cache_ttl_seconds: 5 # LSP 诊断缓存时间
    timeout_seconds: 3 # LSP 诊断超时

# 1. Plan：创建 SPEC（捕获 LSP 基线）
> /moai plan "实现用户搜索 API"

# 2. Run：使用 DDD 实现（TRUST 5 验证）
> /moai run SPEC-SEARCH-001

# 3. Sync：生成文档及 PR（最终 LSP 清洁确认）
> /moai sync SPEC-SEARCH-001

LSP 诊断结果：
- 错误：0 个
- 类型错误：0 个
- Lint 错误：0 个
- 警告：3 个（低于阈值 10）
- 安全警告：0 个

TRUST 5 全部通过：可以部署