| name | principle-yagni |
| description | 识别并消除过度设计，确保只实现当前明确需要的功能。当需要评审功能范围、重构冗余代码、权衡技术债务时使用。覆盖功能必要性、过度设计信号、技术债务权衡三大维度，提供具体的识别标准和删减建议。 |
| stage | COMMON |
| level_supported | L1-STREAMLINED, L2-BALANCED, L3-RIGOROUS |
YAGNI Principle Skill
Scope: COMMON（全阶段通用）
版本: 0.1.0（占位）| 创建日期: 2025-11-27
概述
YAGNI（You Ain't Gonna Need It）是极限编程（XP）的核心原则：
┌─────────────────────────────────────────────────────┐
│ 🎯 YAGNI Principle │
├─────────────────────────────────────────────────────┤
│ "Always implement things when you actually need │
│ them, never when you just foresee that you │
│ need them." │
│ — Ron Jeffries │
└─────────────────────────────────────────────────────┘
检查维度
功能必要性
- 这个功能是当前需求明确要求的吗？
- 是否有用户/业务方确认需要？
- 删除这个功能会影响当前交付吗？
过度设计信号
- 是否为"将来可能需要"而设计？
- 是否有未使用的接口/参数/配置？
- 是否有"以防万一"的代码？
- 是否有过度抽象？
技术债务权衡
- 简单实现 vs 过度设计的成本
- 重构成本 vs 预测性设计成本
- 维护负担 vs 灵活性收益
YAGNI 违反示例
❌ 不好的做法：
- 为"未来扩展"添加未使用的参数
- 创建只有一个实现的接口
- 预留"可能需要"的配置项
- 实现"完整"功能但只用 20%
✅ 好的做法：
- 实现当前需要的最简方案
- 需要时再重构扩展
- 保持代码精简可读
分级检查策略
L1-STREAMLINED
- 检查 3 个核心问题
- 关注明显过度设计
- 通过标准：3 项中 2 项通过（≥67%）
L2-BALANCED
- 检查 6-8 个关键点
- 扫描未使用的代码/接口
- 通过标准：6 项中 5 项通过（≥83%）
L3-RIGOROUS
- 全面检查所有子项（10+ 项）
- 量化未使用代码比例（目标 < 3%）
- 记录技术债务和简化建议
- 通过标准：10 项中 9 项通过（≥90%）
>> 命令
>>yagni_check_l1 # YAGNI 快速检查
>>yagni_unused # 识别未使用的代码/功能
>>yagni_overdesign # 过度设计检测
相关 Skills
- 同类: principle-kiss, principle-dry, principle-soc（设计原则家族）
- 前置: vertical-slice（只实现当前切片需要的）
- 应用: task-breakdown（只分解当前需要的任务）
- 验证: code-review（检查过度设计）
TODO: 待细化过度设计的检测规则