用途:这是一个在“制定实现计划或写代码之前”阅读的技能,主题是保持简单与优雅,反对过度工程。
主要能力/原则: 1)实现功能或修 bug 前考虑所有选项,包括完全不同思路,选择最清晰、最简单、代码最少且满足需求的方案,按需选合适规模而非过大过复杂。 2)避免把不必要复杂度带进代码:检查相关处理,去除不可能的条件分支和多余 try-catch;若正常不会发生异常或被调函数内部已有 try-catch,就不必再包一层。 3)标记过度校验、过度防御、不必要的中间表示和与用途无关的复杂度。例如只为特定网站打开商品链接的函数,可能只需校验主机名;校验路径名可能只增复杂度而不提升安全;也可通过参数类型(如 https://example.com/product/{string})或只接收商品 ID 并在函数内拼链接来简化校验。 4)避免重复造轮子:加代码前先看项目已有代码或依赖是否已覆盖部分或全部功能;复杂处理先查是否有流行且维护良好的库,如有应向用户建议使用。 5)只保留必要改动:遵循 YAGNI,不为未来可能需要而引入复杂度;未发布功能无需保持向后兼容;交付的每一行改动都应必要,逐行审查 diff。 6)保持代码库干净:写代码不等于只做加法,要删除不再需要的代码;语义不同的内容不要硬塞进现有代码;必要时拆分、重构甚至重新设计。日常工作中若当前改动范围内有小型重构可解决的设计问题,应主动重构,但大规模重构前需获得用户明确许可。 7)DRY 与可修改性:避免重复定义同一事物,力求改一处即可自动更新相关处理;例如 i18n 中理想做法是在一处管理可用语言及标签,增删语言只需改这一处并增删对应翻译文件。
使用方式:在开发实现计划或写代码前阅读并据此审查方案与 diff。
适用场景:日常功能开发、修 bug、代码审查、重构与清理、国际化等需要控制复杂度的编码场景。
限制:公开资料未提供安装命令、具体代码示例、收费、价格、平台或效果评测;部分原则中的例子仅为示例,需结合具体情况寻找同类更简单实现。