mcpField
P
principle-foundational-thinking

principle-foundational-thinking

github.com/backnotprop开发3.1k5.7k 次安装今天更新
代码仓库

关于 principle-foundational-thinking

一项软件开发技能,主张先做结构性决策,再开始实现,并保持代码简单。它强调数据形状、并发隔离、尽早搭建基础、分步推进,以及在添加基础设施前清理死代码。

主要功能

  1. 01先定义数据结构,再编写逻辑
  2. 02偏好明确代码,避免巧妙抽象
  3. 03隔离不安全的共享状态
  4. 04尽早搭建共享基础
  5. 05进行小而连贯的修改
  6. 06搭建基础前清理死代码

适用场景

  1. 01根据常见访问模式规划类型
  2. 02避免共享状态时的并发风险
  3. 03准备 CI、Lint 和测试基础设施
  4. 04通过聚焦修改进行代码重构

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/backnotprop/pstack --skill principle-foundational-thinking

安装后在 Claude Code 中输入/principle-foundational-thinking确认已加载。

详细介绍

基础思维

结构性决策保护选择空间。代码层面的决策保持简洁。

先考虑数据结构。 在编写逻辑之前,先确定正确的数据形态。尽早定义核心类型,梳理每种访问模式,并选择与主要路径相匹配的结构。

在代码层面,对结构去重,而不是对每一行都去重。类型和数据模型应该趋于统一。三条相似语句也胜过过早抽象。优先选择明确的写法,而非取巧。测试行为和边界情况,而非行数。

并发推论。 在多个执行主体之间共享状态之前,先问:“如果另一个执行主体同时修改它,会发生什么?”如果答案不是“什么也不会发生”,就隔离状态。

先搭建脚手架。 如果某项工作能帮助后续每个阶段,就先做它。问问自己:“后续每个阶段是否都会受益于已有的这项工作?”CI、lint、测试基础设施和共享类型都属于脚手架。按选择空间排序:先搭建环境,再开发功能;先编写测试,再修复问题。保持提交小而专一。

每次增量都应形成一个完整的抽象,或深化已有抽象。不要通过特殊情况协调,将新能力分散到各个调用方。

先做减法,再搭脚手架。先移除死代码,再打好基础。

评论

支持 Markdown