← 全部笔记

软件工作中的共同判断

围绕真实使用场景,保持核心简洁、内核统一,借鉴成熟方案,按整体成本与失败后果作取舍。这里维护跨产品、设计、实现与验收的共同原则,具体方法由各领域 Skill 承担。

核心数据结构和核心流程必须简洁清晰

核心数据结构和核心流程必须简洁清晰:核心对象及其关系、状态归属、从触发到完成或失败的主要路径应能直接理解。用满足当前需求的最少概念、状态和分支表达业务;发现重复状态、多余转发或隐式顺序依赖时,先整理再扩展。简洁以理解和维护成本衡量,而非代码行数。

区分稳定内核与产品变化

内核层承载共用的核心数据结构、基本机制和不变量,保持统一、稳定;产品层承载具体场景的流程编排、交互和差异化政策,通过明确契约组合内核能力。依赖从产品层指向内核层,产品特有分支留在产品层。

新需求先判断是共性机制还是产品差异:共性能力在同一内核中演进,产品差异在产品层承接,避免复制出多套内核。稳定指职责、语义与契约稳定;分层以隔离变化为目的,函数或模块边界足够时就采用最小结构。

先借鉴权威架构与成熟实现

架构设计和非平凡机制实现前,先查项目已有能力,再查官方参考方案及经过真实使用检验的成熟项目。架构借鉴核心模型、主流程与职责边界;实现优先复用,移植时连同关键测试并核对许可。按当前场景、规模和版本选择适用部分,现有方案存在具体缺口时再自研。

克制增加整体负担

新增功能、抽象、依赖或配套设施必须服务于真实场景。优先复用、删除冗余或直接替换;综合使用频率、失败后果、实现维护成本与人工操作成本,选择整体负担更小的方案。简化仍须完整承担任务,不能把省下的工作转嫁给用户或下游。

#工程

Arkk

专题 · 关于