尧图网页设计 
pstack原则02基础思考写逻辑前先想清核心类型与数据结构【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack 是 Lauren Tan 的知名 Cursor 技能栈而 pstack-claude 是它的开源移植版覆盖 Claude Code、Codex、Pi 等多个 Agent 运行时。本篇聚焦其中的第 02 号原则——基础思考Foundational Thinking在动手写业务逻辑之前先把核心类型与数据结构想清楚让后续的代码自然变简单。这是整个原则体系里最地基的一条。什么是基础思考原则在 pstack 的技能树里共有 24 个principle-*原则类技能作为参考底座基础思考是其中的核心条目之一。它的原文只有一段却定义了四条可执行的判断标准结构性决策保护选项价值代码级决策保护简洁性。完整定义见 principle-foundational-thinking/SKILL.md四条要点分别对应本文的四个小节。数据结构优先核心类型先于业务逻辑原则的第一条就是数据结构优先Data structures first先定义核心类型再写逻辑追踪每一种访问模式数据会被怎么读、怎么写选择匹配主流路径的数据结构为什么这么重要因为数据形状定错了后面所有逻辑都会被迫绕路——到处是特判、强转和补丁。而数据形状定对了下游代码几乎是显而易见的。这也正是 pstack 的 architect 技能 的做法先草图后实现——用伪代码和not implemented占位画出类型、函数签名和模块边界实现填进去之前先确认形状正确形状错了就推倒重来。 新手常见错误一上来就写 if/else 和布尔标志。更稳的顺序是先问这个领域里有哪些状态它们怎么流转再把答案写成类型。领域建模把规则写进结构而不是散落条件数据结构优先的展开版是姊妹原则 principle-model-the-domain/SKILL.md把领域规则编码进数据结构而不是散落在各个文件里的条件分支里。它给出的对照清单非常实用别这样做换成这个散落的布尔值、生命周期检查状态机松散的参数、重复的形状假设带类型的对象/模型跨文件的 if/else 分支映射表、注册表、判别联合随意的状态修改reducer / 命令事件模型它还说出了最典型的跳过了这一步的信号新功能让既有的 if/else 链又长了一个分支或者第二个布尔值必须与第一个保持同步。DRY 的是结构不是每一行代码原则在代码层面要求DRY 结构而非每一行类型和数据模型应该收敛同一概念只有一个权威形状三条相似的语句好过一个过早的抽象宁可显式不要取巧测试行为和边界情况而不是测试行数这条原则的反面教材是到处any、到处强转。pstack 的 principle-type-system-discipline/SKILL.md 把纪律说得更狠类型检查器是证明助手让非法状态无法被表示——比如{ completed: boolean; completedAt?: Date }允许已完成却没有完成时间这种无意义组合就该改成判别联合让编译器替你把关。脚手架先行先修路再跑车基础思考的第四条是脚手架优先Scaffold first如果某个东西能让后续每个阶段都受益就先做它。判断标准只有一句话——后续的每个阶段是否都会因为它存在而受益符合标准的例子CI、Lint、测试基础设施、共享类型。排序口诀是配置先于功能测试先于修复提交保持小而单一先删死代码再铺地基Subtraction comes before scaffolding。并发推论先问共享什么原则里还藏着一个高频踩坑点——并发。在把状态共享给多个执行者之前先问一句如果另一个执行者同时修改它会发生什么如果答案不是什么都没发生那就先隔离。配套的 principle-separate-before-serializing-shared-state/SKILL.md 进一步要求默认消灭共享而不是急着上锁——能各写各的文件/键/分支就各写各的只在读/汇报边界合并。新手落地清单写代码前的 5 个问题把原则浓缩成一个开工前自检清单核心类型写出来了吗状态、实体、边界数据各自的形状是什么访问模式追踪了吗每种数据会被谁、以什么频率读写有没有该先修的路CI、测试基建、共享类型是否就位共享状态问过了吗并发修改会发生什么能否不共享✂️能删的先删了吗死代码清掉了吗新抽象是删减后仍必需的吗去哪里学更多原则原文principle-foundational-thinking/SKILL.md配套建模原则principle-model-the-domain/SKILL.md类型纪律principle-type-system-discipline/SKILL.md设计工作流architect/SKILL.md全部斜杠命令与运行时说明docs/reference.md一句话总结先想清核心类型与数据结构逻辑只是水到渠成。把地基打对后面每个 Agent 和每个开发者都省一半力气。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 pstack原则02基础思考：写逻辑前先想清核心类型与数据结构
pstack原则02基础思考写逻辑前先想清核心类型与数据结构【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack 是 Lauren Tan 的知名 Cursor 技能栈而 pstack-claude 是它的开源移植版覆盖 Claude Code、Codex、Pi 等多个 Agent 运行时。本篇聚焦其中的第 02 号原则——基础思考Foundational Thinking在动手写业务逻辑之前先把核心类型与数据结构想清楚让后续的代码自然变简单。这是整个原则体系里最地基的一条。什么是基础思考原则在 pstack 的技能树里共有 24 个principle-*原则类技能作为参考底座基础思考是其中的核心条目之一。它的原文只有一段却定义了四条可执行的判断标准结构性决策保护选项价值代码级决策保护简洁性。完整定义见 principle-foundational-thinking/SKILL.md四条要点分别对应本文的四个小节。数据结构优先核心类型先于业务逻辑原则的第一条就是数据结构优先Data structures first先定义核心类型再写逻辑追踪每一种访问模式数据会被怎么读、怎么写选择匹配主流路径的数据结构为什么这么重要因为数据形状定错了后面所有逻辑都会被迫绕路——到处是特判、强转和补丁。而数据形状定对了下游代码几乎是显而易见的。这也正是 pstack 的 architect 技能 的做法先草图后实现——用伪代码和not implemented占位画出类型、函数签名和模块边界实现填进去之前先确认形状正确形状错了就推倒重来。 新手常见错误一上来就写 if/else 和布尔标志。更稳的顺序是先问这个领域里有哪些状态它们怎么流转再把答案写成类型。领域建模把规则写进结构而不是散落条件数据结构优先的展开版是姊妹原则 principle-model-the-domain/SKILL.md把领域规则编码进数据结构而不是散落在各个文件里的条件分支里。它给出的对照清单非常实用别这样做换成这个散落的布尔值、生命周期检查状态机松散的参数、重复的形状假设带类型的对象/模型跨文件的 if/else 分支映射表、注册表、判别联合随意的状态修改reducer / 命令事件模型它还说出了最典型的跳过了这一步的信号新功能让既有的 if/else 链又长了一个分支或者第二个布尔值必须与第一个保持同步。DRY 的是结构不是每一行代码原则在代码层面要求DRY 结构而非每一行类型和数据模型应该收敛同一概念只有一个权威形状三条相似的语句好过一个过早的抽象宁可显式不要取巧测试行为和边界情况而不是测试行数这条原则的反面教材是到处any、到处强转。pstack 的 principle-type-system-discipline/SKILL.md 把纪律说得更狠类型检查器是证明助手让非法状态无法被表示——比如{ completed: boolean; completedAt?: Date }允许已完成却没有完成时间这种无意义组合就该改成判别联合让编译器替你把关。脚手架先行先修路再跑车基础思考的第四条是脚手架优先Scaffold first如果某个东西能让后续每个阶段都受益就先做它。判断标准只有一句话——后续的每个阶段是否都会因为它存在而受益符合标准的例子CI、Lint、测试基础设施、共享类型。排序口诀是配置先于功能测试先于修复提交保持小而单一先删死代码再铺地基Subtraction comes before scaffolding。并发推论先问共享什么原则里还藏着一个高频踩坑点——并发。在把状态共享给多个执行者之前先问一句如果另一个执行者同时修改它会发生什么如果答案不是什么都没发生那就先隔离。配套的 principle-separate-before-serializing-shared-state/SKILL.md 进一步要求默认消灭共享而不是急着上锁——能各写各的文件/键/分支就各写各的只在读/汇报边界合并。新手落地清单写代码前的 5 个问题把原则浓缩成一个开工前自检清单核心类型写出来了吗状态、实体、边界数据各自的形状是什么访问模式追踪了吗每种数据会被谁、以什么频率读写有没有该先修的路CI、测试基建、共享类型是否就位共享状态问过了吗并发修改会发生什么能否不共享✂️能删的先删了吗死代码清掉了吗新抽象是删减后仍必需的吗去哪里学更多原则原文principle-foundational-thinking/SKILL.md配套建模原则principle-model-the-domain/SKILL.md类型纪律principle-type-system-discipline/SKILL.md设计工作流architect/SKILL.md全部斜杠命令与运行时说明docs/reference.md一句话总结先想清核心类型与数据结构逻辑只是水到渠成。把地基打对后面每个 Agent 和每个开发者都省一半力气。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考