pstack的architect技能深度解析多模型并行设计防止走错形状【免费下载链接】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 是一套面向 Claude Code、Codex、GitHub Copilot 等主流 Agent 平台的严谨工作流技能套件其中的architect 技能通过先设计、后编码的五阶段流程和多模型并行设计机制让多个大模型独立产出架构草图再择优融合从源头防止 AI 编码代理走错形状——即一旦写错结构就只能推倒重来的返工陷阱 ️。为什么需要先设计后编码的架构技能普通用户的直觉是让 AI 直接写代码不行再改。但经验表明改结构比改代码贵得多。当 AI 直接跳进实现第一个看起来可行的方案就会锁死形状后续所有修补都只能在这个错误的骨架上进行。architect 技能解决的正是这个问题在动手写代码之前先画出类型、函数签名、类形状和模块边界函数体只留not implemented占位等设计方案被验证后再对着草图填充代码。它的触发场景很明确——跨函数边界、需要重新定义所有权或分层结构的非平凡工作。一个典型入口就是这样一句话Use poteto-mode to design the search filter state management.architect 技能的五阶段工作流整个流程在 SKILL.md 中定义启动前先建一个待办清单每个阶段一条阶段名称做什么AGround 立足先用 how 技能摸清新代码要触碰的每一个子系统建立真实的心智模型BSketch 草图用 arena 技能让多个模型并行产出候选设计再综合成一个方案CAgree 对齐可选默认直接实现用户可显式要求停下来给我看DImplement 实现把not implemented换成真实代码草图就是契约EScrap 推倒草图被证明错误时整体抛弃、重新设计绝不缝缝补补两个细节值得新手注意阶段 A 不能跳。给文件起个名字不算立足必须产出 how 技能规定的追溯式模型如果设计要重新定义分层还要跑一遍 why 技能让历史决策理由变成约束条件而非猜测。阶段 E 靠模式触发不靠单次摩擦。同一形状的变通方案反复出现、类型需要any/强制转换才能编译、调用方被迫了解抽象内部规则——出现两类以上同构偏差才说明架构错了。几个边缘情况判不了死刑数据里的复杂度不等于设计里的复杂度。多模型并行设计是如何运作的这是 architect 最核心的机制由三个部件协作完成1️⃣ arena 技能负责扇出。architect 的阶段 B 并不自己写设计而是把设计草图任务连同阶段 A 的立足产物交给 arena 技能。arena 会并行启动 N 个候选代理每个候选写入独立的工作目录优先 git worktree保证彼此隔离互不污染。2️⃣ 三个不同模型各出一套完整方案。architect 默认使用opus、fable、sonnet三个模型作为 runner见 models.json 中的architect runners角色行可用/setup-pstack覆盖。每个 runner 收到同一份 runner-prompt.md 提示词产出一个设计包类型草图 函数签名 模块地图 书面理由。提示词里有一句很关键的指令你是几个 runner 之一每个跑在不同模型上。交出你的模型能做出的最好设计不要向其他人妥协。候选之间的差异才是选材信号——趋同到安全的中庸方案反而毁掉了探索。3️⃣ 综合成一份最终设计。arena 读取全部候选后按评估标准打分选出基础方案再从落选方案中嫁接最强的一两个点不是机械粘贴。规则要求至少两个结构性不同的候选才能进入综合哪怕第一个看起来已经够用——这就是 principle-exhaust-the-design-space穷尽设计空间原则的具体化。 对普通用户的含义你得到的是三个模型头脑风暴 一个评审者裁决的结果而不是单个模型的即兴发挥。设计红旗清单8 个防止走错形状的筛子综合候选之前每个方案都要过一遍 design-red-flags.md 的红旗筛查。这份清单是全文最值得细读的部分它预设了一个残酷的前提下一个改代码的人大概率是一个只能看到自己打开的文件、会照抄最近示例、走最短可编译路径的 AI 代理。红旗一句话解释浅模块接口很大、藏住的复杂度很少——简单接口背后应有厚实行为信息泄漏同一个内部决策出现在多个模块改一处要协同改多处时序分解按加载→校验→转换→保存的执行顺序切模块而非按知识归属直通方法只是把参数原样转发给别的方法没藏住任何复杂度分裂所有权多个模块写同一份状态规则会越走越偏一个任务两种做法AI 会随机抄到先发现的那种两条路都越长越肥可导入的内部实现内部模块可被外部 import就会悄悄变成公共接口手工同步清单多处列同一批条目新增一条要改遍所有地方配套的判断标准也很实用比较候选时看接口深度——优先选择用更小更简单的公共表面隐藏更多复杂度的设计深调用链是坏事深模块是好事。设计理由文档草图永远带说明书最终产出不只是类型草图还有一份按 rationale-template.md 撰写的一页理由文档与草图一起交付。它的结构值得任何做技术设计的团队借鉴Problem要做什么现有系统的什么约束让形状不显然Usage调用方视角先写这个——消费者看到的用法和两三个真实调用点类型草图由用法推导而来两者冲突时以用法为准Shape推荐架构数据结构在前指出哪些不变量由类型编码、系统刻意不做什么Synthesis decision哪个候选成为基础、从其他候选嫁接了什么、拒绝了什么Alternatives considered必填至少一个具体备选方案及落败原因Tradeoffs accepted我们接受 X 换取 Y防止后人把刻意取舍误认为疏漏这份文档还承担实现期对账职能阶段 D 中被接受的偏差、验收来源都要回写到这里保证下一个接手的代理不会收到自相矛盾的指令。快速上手如何调用 /architect在 Claude Code 中通过 docs/reference.md 列出的斜杠命令调用/architect design the notification delivery pipeline或直接用自然语言architect this、design this。几个实用技巧需要人工把关时说 /architect with checkpoint它会展示综合设计并暂停等你确认否则默认直接进实现不等人想对设计施加对抗性压力可再跑一次 interrogate 技能让三个不同模型专门尝试打爆这份草图调整模型与推理强度用/setup-pstack给角色配置模型如opus xhigh默认值在 models.json 中维护修改后运行 tools/generate.mjs 重新生成何时该用跨函数边界、引入新模块或重新分层的任务值得跑 architect模式已确立的机械实现和明确的 bug 修复则不必小结把走错形状的成本前置architect 技能的设计哲学可以浓缩为一句话让错误暴露在草图阶段而不是代码阶段。它用先立足Ground杜绝凭空设计用多模型并行 综合嫁接arena对抗单模型的第一直觉偏差用红旗清单筛选那些对 AI 维护者不友好的形状用一页理由文档让设计决策可追溯最后保留一个体面的退出机制——草图错了就整体推倒按 first-principles 重新设计新草图必须先比旧的小。对新手来说理解这套流程最大的收获未必是学会用/architect而是它示范的做事顺序先搞清楚现状 → 并行探索多种方案 → 按标准裁决 → 留痕交付 → 错了就重来。这套方法迁移到任何技术决策上都比想到一个方案直接干更稳。【免费下载链接】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），仅供参考