SuperAPI AI 工具集

principle-foundational-thinking

编程与开发

查看项目

更新于 11-06 21:01

技能介绍

用途

该技能用于「写逻辑之前」的决策阶段,帮助开发者在动手编码前完成基础性判断:选择核心类型与数据结构、安排脚手架工作与功能工作的先后顺序、以及思考并发执行者之间共享了什么。资料将其概括为:结构性决策保护选项价值,代码级决策保护简单性。

主要原则

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

代码层面只 DRY 结构。 类型与数据模型应当收敛;三行相似语句仍好于过早抽象;显式优于取巧。测试应针对行为与边界情况,而非代码行数。

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

脚手架先行。 如果某件事对后续每个阶段都有帮助,就先做它。判断标准是「后续每个阶段是否都因它存在而受益?」CI、lint、测试基础设施和共享类型都属于脚手架。按选项价值排序:搭建先于功能,测试先于修复。提交应保持小而单一目的。

增量应形成抽象。 每个增量都应落地一个自洽的抽象,或加深一个已存在的抽象;不要把新能力以特例协调的方式分散到各个调用方。

删除先于搭建。 先移除死代码,再打地基。

使用方式

资料说明:每个会话在遵循本技能之前,应先阅读一次主机适配器(host adapter)。适配器负责把上游 Cursor 特定的工具、模型、路径与权限指令映射到你的宿主环境,并设定权限边界。除此之外,资料未提供更具体的安装命令或调用步骤。

适用场景

适合在开始实现新功能、重构数据结构、引入并发共享状态、或在功能开发前规划工程基础设施(CI、lint、测试)时使用。也适用于代码评审中判断抽象是否过早、提交是否过大的情形。

限制

资料未提供该技能的具体工具形态、安装方式、支持的宿主平台、收费模式或量化效果,这些信息暂未提供。部分表述(如主机适配器)依赖上游 Cursor 环境语境,迁移到其他宿主时需自行确认映射规则。