（3686期）Quality-Driven Development (QDD) – 质量门禁驱动的智能TDD/DDD开发框架

质量门禁驱动的智能TDD/DDD开发框架 基于TRUST 5框架的质量驱动开发，自动选择TDD/DDD方法论，强制质量门禁与结构化日志策略，确保代码可测试、可读、统一、安全、可追踪 使用说明 核心概述 Quality-Driven Development（质量驱动开发）是一套源自MoAI-ADK TRUST 5框架的结构化软件开发方法论。该skill的核心价值在于自动化方法论选择与强制性质量门禁，而非简单的编码辅助工具。 方法论自动切换机制 系统根据项目测试覆盖率智能选择开发路径： TDD路径（覆盖率≥10%或新项目）：严格遵循RED→GREEN→REFACTOR循环 DDD路径（覆盖率<10%的老项目）：采用ANALYZE→PRESERVE→IMPROVE渐进式改造 这种设计解决了传统TDD在遗留代码库中"无从下笔"的困境，同时避免了对已有良好测试覆盖项目的过度保守。 TRUST 5质量框架 五个维度构成不可绕过的质量门禁： | 维度 | 关键检查点 ||------|-----------|| Tested | 全量测试通过，覆盖率维持或提升 || Readable | 自解释代码命名、清晰日志上下文 || Unified | 风格一致性、日志格式统一 || Secured | 无硬编码密钥、日志脱敏 || Trackable | SPEC文档完整、关键路径日志覆盖 | 日志策略的工程深度 该skill将日志提升至"第一防线"地位，设计了精细的分级策略： ERROR/WARN/INFO：全环境输出，INFO级别需保证"仅凭日志即可追踪业务流程" DEBUG：开发环境自由使用，生产自动屏蔽 强制埋点位置：API入口、外部服务调用、异常捕获、状态变更、批处理起止 特别值得注意的是日志内容规范——要求结构化上下文（orderId=123, reason=재고부족）而非模糊描述（"처리 실패"），这对生产排障效率有显著提升。 显著优点 零配置智能适配：自动检测测试框架、日志框架、语言生态 防御性流程设计：MUST/MUST NOT约束形成刚性边界，杜绝"先写代码后补测试"的捷径诱惑 遗留代码友好：DDD路径为低覆盖率项目提供了可行的改进路径 多角色协作机制：Architect/Backend/Frontend/Security/Tester/Performance六角色视角切换 潜在局限与风险 启动成本较高：SPEC文档、测试先行、质量门禁等环节对简单脚本类任务可能过度设计 工具链依赖：需项目已具备基础测试运行能力（jest/pytest/go test等），纯原型验证场景适用性受限 团队认知门槛：TRUST 5检查需要开发者理解各维度标准，新团队可能有学习曲线 自动化执行盲区：虽然要求"tests are actually executed"，但实际依赖外部测试运行器，无法内嵌验证 适合人群 中大型项目团队（特别是微服务、企业级应用） 技术债务较重、希望渐进式提升质量的遗留系统维护者 对生产可观测性（日志质量）有强诉求的运维敏感型团队 需要多开发者协作、代码风格一致性要求高的场景 常规风险提醒 ⚠️ 敏感数据泄露：日志策略虽明确要求脱敏，但print/console.log等裸日志在快速DEBUG时极易被滥用，需配合代码审查或敏感信息扫描工具 ⚠️ 覆盖率指标陷阱：10%阈值是经验性启发式规则，非绝对标准；极复杂遗留系统可能需要人工 override ⚠️ SPEC文档漂移：长期迭代中SPEC可能与实际代码脱节，需建立SPEC版本与代码提交的关联机制 原始说明 Quality-driven development with automatic TDD/DDD methodology selection and TRUST 5 quality framework. Use when building features, refactoring code, fixing b...