SuperAPI AI 工具集

principle-foundational-thinking

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

用途

「principle-foundational-thinking」是一个在编写逻辑之前应用的基础性思考原则技能,用于指导结构性决策。其核心主张是:结构性决策保护选择价值,代码级决策保护简洁性。

主要能力

数据结构优先

在编写逻辑之前先把数据形态确定下来。尽早定义核心类型,追踪每一个访问模式,并选择与主要路径相匹配的数据结构。

代码层面的取舍

在代码层面,对结构做 DRY,而不是对每一行做 DRY。类型与数据模型应当收敛。三条相似的语句仍然胜过一次过早的抽象。偏好显式而非取巧。测试行为与边界情况,而不是测试行数。

并发推论

在多个执行者之间共享状态之前,先问:「如果另一个执行者并发修改它,会发生什么?」如果答案不是「什么都不会发生」,就应当隔离。

脚手架优先

如果某件事对后续每一个阶段都有帮助,就先做它。问自己:「后续每一个阶段是否都会因为它的存在而受益?」CI、lint、测试基础设施和共享类型都属于脚手架。按选择价值排序:先搭建再开发功能,先测试再修复。保持提交小而单一用途。

增量与抽象

每一个增量都应当落地一个连贯的抽象,或深化一个已经存在的抽象。不要把一项新能力以特例协调的方式散落到各个调用方。

减法先于脚手架

先移除死代码,然后再打地基。

使用方式

该技能以原则形式提供,在编写逻辑之前应用。涉及模块或接口推理时,可调用 /codebase-design;涉及已接受的项目术语、关系或归属变更时,可调用 /domain-modeling,并同步项目权威产物。

适用场景

适用于需要在动手写代码前先做结构与数据形态决策的开发工作,包括核心类型与数据结构选择、脚手架与功能工作的排序,以及判断并发执行者之间共享状态的风险。

限制

资料未提供该技能的具体安装命令、运行环境、平台支持、收费方式或效果数据,这些信息暂未提供。