ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

pstack Poteto Mode Feature Playbook 全解:从设计主导到并行实现的吞吐量检查点实战指南

pstack Poteto Mode Feature Playbook 全解:从设计主导到并行实现的吞吐量检查点实战指南 pstack Poteto Mode Feature Playbook 全解从设计主导到并行实现的吞吐量检查点实战指南【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins本指南围绕 pstack 插件中poteto-mode技能SKILL.md的 Feature 演练手册展开系统讲解该模式如何让 Agent 以“设计主导者”身份完成一次新功能交付通过how摸底、architect并行设计、四维吞吐量检查点、委托子代理实现、匹配面验证与可验证单元序列提交最后经“Opening a PR”收口。读完你将掌握这套从规划、设计、并行拆分、委托、验证到提交的完整可执行工作流并理解每条规则背后的 pstack 原则技能依据与默认模型配置。一、Feature 演练手册在 poteto-mode 中的定位poteto-mode是 pstack 插件发布的一套 Agent 工作风格其 SKILL.md 通过 frontmatter 声明mode: true、icon: crown、color: yellow并定义了一组“不可协商”Non-negotiables触发规则架构决策走how并行发散走architect/swarm有争议的设计走interrogate多步骤工作必须写下吞吐量检查点任何 PR 状态请求走 Babysit 演练手册而非 Cursor 内置技能。在全部 23 个演练手册中Feature 对应 SKILL.md 中明确登记的场景“Feature.New or changed behavior, built from a named data shape.” 换言之只要任务是“新增或改变行为、并且从一个明确命名的数据形态起步”就应当匹配本手册。它的开场白定义了主导权归属“You own the design. Plan, review, verify. Delegate implementation. Stay in the lead.”你拥有设计规划、评审、验证委托实现始终保持在主导位置。值得注意的边界规则来自 SKILL.md当任务属于跨大量调用点的迁移、多部件的宏大变更或用户会离开后回来审查的工作即使 Feature 手册表面匹配也应改路由到figure-it-out技能而跨多日、多堆栈 PR、由单一协调者掌控的常驻项目级程序则路由到Orchestrate。Feature 手册面向的是“一个 Agent 能在会话预算内完成”的功能级任务。二、手册主流程八步总览Feature 手册的正文是一条八步执行链每一步都对应一个或多个 poteto-mode 原则技能对受影响子系统执行how摸底。执行architect做并行设计探索跳过必须显式记录为architect skipped: reason不得把设计决策悄悄并入实现。把吞吐量检查点写成四个待办项见下节。委托子代理写代码使用你配置的 feature 模型默认grok-4.6-fast-xhigh指定明确范围文件路径、命名的数据形态与组织结构、成功标准并亲自审查其 diff。在匹配的验证面上验证Inconclusive或验证面错误都不算通过必须标记出来。Rebase 成小而有序的提交把后续改动堆叠成栈使用sequence-verifiable-units原则技能每个小单元构建、验证、提交后再进入下一个。若设计存在争议在发布前执行interrogate。运行Opening a PR演练手册收尾。手册末尾还给出回复格式要求Reply:说明构建了什么、选择了什么及原因、吞吐量检查点、未决决策设计备选方案用表格呈现。这与 poteto-mode 的“Writing the reply”风格一致短陈述句、无长破折号、每句结论自带证据标签。三、吞吐量检查点四个必须写进待办列表的维度这是 Feature 手册最具操作性的核心在委托实现之前先写下一个“吞吐量检查点”throughput checkpoint拆成四个 todo 项。真正不适用的维度如单文件、无扇出也必须保留该项并标注n/a: reason而不是直接删除。维度检查点要求依据的原则技能Blocking first steps阻塞性首步所有闸门gates在扇出fan-out之前先跑—Independent workstreams独立工作流不重叠的文件/服务/层可并行共享写入必须串行—Shared mutable state共享可变状态默认拆分目标优先消除共享separate-before-serializing-shared-state仅在存在真实不变量时才串行principle-separate-before-serializing-shared-stateSmallest safe decomposition最小安全分解若一个 worker 最优必须说明原因—这四个维度与 pstack 的多代理并行模型直接呼应。例如 principle-separate-before-serializing-shared-state 指出当并发角色可能写同一文件、分支、key 或状态对象时先消除共享——让每个 actor 拥有自己的文件/key/分支/状态目录只在读取或汇报边界合并只有“单一共享写入目标”是真实不变量时才用锁文件、顺序阶段、单写者 actor 或原子 CAS 做结构化串行。手册用“The app is small和a subagent cannot spawn one都是错误认知”明确否定了两种常见的偷懒借口即使应用很小、即使自己就是子代理也必须完成这四个维度的检查点写作。四、委托实现范围、数据形态与成功标准的强制约束手册第 4 步对委托做了硬性规定这是区分“随意甩锅”与“受控委托”的分水岭委托对象使用你配置的 feature 模型默认grok-4.6-fast-xhigh。这与 SKILL.md 中的 Task 默认一致“grok-4.6-fast-xhighfor code”且可通过/setup-pstack技能配置per-role 行会覆盖默认值。委托范围必须具体至少包含文件路径命名的数据形态named data shape及其组织结构——依据principle-model-the-domain用状态机取代散布的布尔值、用表/注册表取代分支、用类型化模型取代重复的形状假设——这些结构选择必须在委托写逻辑之前定好成功标准success criteria。亲自审查 diff委托不等于放权。SKILL.md 亦强调 “You own every subagents work. Review the diff and write your own summary, dont pass through what it said.”存在多种合法形态时走 arena当实现允许多种合法形态错误处理、抽象层、测试结构改为通过arena技能委托让多个 runner 并行产出备选方案再由 cross-judge 守卫最终选择——而不是在委托 prompt 里拍脑袋定一个。principle-model-the-domain 是这条约束的理论底座它主张把真实领域编码进数据结构状态机、类型化模型、注册表、判别联合、reducer 等而不是散落在条件分支里其“跳过此原则的信号”正是“新功能让现有 if/else 链再长一个分支或第二个布尔值必须与第一个保持同步”。手册特别强调两条“不可逃逸条款”Mandatory: no skip-with-reason escape强制没有“带理由跳过”的逃逸口。Laziness Protocol 不覆盖本条虽然 principle-laziness-protocol 主张最小化 diff、偏向删除但这里的收益是评审分离review separation不是省行数因此“少写几行”不构成跳过委托的理由。一个被禁止生成子代理的子代理可以通过直接拥有 diff、保持同样的评审分离来满足本步要求不得出现“standing by”式等待嵌套代理的回复。注释遵循Comments规则SKILL.md只为代码无法表达的非显然 why 写注释验证/测试脚本不写阶段叙述性注释。编辑要精确surgical edits对上游派生文件要对照源重新接地re-ground against the source共享原语的改进要移植到所有消费者并逐一验证频繁提交Commit liberally。五、验证、提交与争议处理第 5 步匹配面验证。必须在匹配的验证面上验证“Inconclusive”或“验证面错误”都不算通过必须显式标记。这呼应 principle-prove-it-works对真实工件验证而不是对代理或“能编译”验证。第 6 步序列化可验证单元。将提交 rebase 成小而有序的提交后续改动堆叠成栈Stack follow-ups并依据sequence-verifiable-units原则技能执行每个单元是“已知良好状态 → 一次变更 → 跑检查 → 再前进”的 before/after 括号每单元验证通过后才推进错误在引发它的单元被捕获是廉价的批量后才暴露则难以定位。交付顺序要让评审者能回放典型形态是先失败测试、再修复其他叙事顺序包括“先减法再重塑”“先基线捕获再处理”“先脚手架再功能”。第 7 步争议设计先interrogate。当设计存在争议发布前运行 interrogate为每个配置的模型各起一个评审子代理默认 Reviewer A–D 分别为claude-fable-5-1-thinking-max、gpt-5.6-sol-max、grok-4.6-fast-xhigh、claude-opus-5-thinking-xhigh同一 prompt 与 rubric 做对抗评审先陈述 intent再汇总共识/独有发现/分歧最终由你以“务实高级工程师”身份给出 Act on / Consider / Noted / Dismissed 分级结论。注意其交付物是综合裁决不自动套用变更。第 8 步Opening a PR。每个其他手册都以 opening-a-pr.md 收尾从 main 的 git worktree 工作频繁提交后 rebase 成小而有叙事的提交提交前跑cursor-team-kit的/deslop评审前跑/no-commentsPR 标题用 Conventional Commits 形式type(scope): subject如fix(pstack): retarget opening-a-pr babysit triggerPR 正文按## Why、## Scope、## Tradeoffs、## Blast Radius、## Verification顺序组织优先五个窄 PR 而非一个大 PRPR 一律以 ready 状态打开。子代理打开 PR 时同样要跑interrogate、/deslop、/no-comments返回 URL 后回到父级不执行 babysit。六、代码耦合工作与父级扇出的边界手册第 19 行feature.md进一步划定了并行度的适用边界Code-coupled work代码耦合工作一个功能配一个迁移交给单一 owner检查点内联其中该 owner 在阻塞阶段之后内部扇出。Parent-level fan-out父级扇出仅适用于能产出独立工件的切片——审计audits、跨子系统调查cross-subsystem investigations、竞争性实验competing experiments。在阶段边界重写检查点Rewrite the checkpoint at phase boundaries需要新负责人时生成一个全新的 owner而不是链式打断interrupt chaining现有子代理——因为 SKILL.md 明确指出中断链式恢复会静默丢失指令。这条规则与 architect 的“Scrap”阶段哲学一致发现架构错误时把草稿扔掉重设计而不是在错误设计上打补丁同理Feature 手册在边界处重新写检查点而不是复用过期的工作分解。七、与 how / architect / arena 的调用关系Feature 手册的前两步并非孤立步骤而是对 poteto-mode 技能网络的三次实际调用how摸底how/SKILL.md 按复杂度分流——简单问题单模块由一个只读 explainer 直接解释复杂问题跨文件/服务的子系统先并行起 2–4 个只读 explorer默认模型grok-4.6-fast-xhigh再交给 explainer默认claude-fable-5-1-thinking-max综合最终按 Overview / Key Concepts / How It Works / Where Things Live / Gotchas 输出。architect并行设计architect/SKILL.md 分 Ground → Sketch → Agree → Implement → Scrap 五阶段先跑how建立真实心智模型再用arena对设计草图并行发散要求至少两个结构不同的候选exhaust-the-design-space用references/design-red-flags.md筛查实现证明草图错误就整体废弃重来。Feature 手册要求跳过时必须显式写architect skipped: reason正是为了防止“悄悄把设计决策折叠进实现”的偷懒路径。arena兜底多形态实现arena/SKILL.md 的 Frame → Fan out → Cross-judge → Pick → Graft → Verify 六阶段正好支撑手册“实现允许多种合法形态时委托 arena”的规则N 个 runner 并行产出同一任务的不同候选cross-judge 按 3–6 条可评分 rubric 独立打分你读完全部候选后按评分而非直觉选定 base再把败者中最好的 1–2 点手工嫁接进 base最后按 prove-it-works 验证合成结果。八、默认模型配置与 /setup-pstack 覆盖Feature 手册中“使用你配置的 feature 模型默认grok-4.6-fast-xhigh”指向的是 SKILL.md 声明的角色默认模型体系可通过/setup-pstack技能定制角色默认模型说明代码codegrok-4.6-fast-xhighFeature 手册委托实现的默认值行文与判断prose and judgmentclaude-fable-5-1-thinking-max适用于需要判断模糊意图或精确执行的任务how-explorer / how-explainergrok-4.6-fast-xhigh/claude-fable-5-1-thinking-max见 howarchitect runnersclaude-fable-5-1-thinking-max、gpt-5.6-sol-max、grok-4.6-fast-xhigh、claude-opus-5-thinking-xhigh见 architectinterrogate reviewersReviewer A–D 各一见 interrogate覆盖规则/setup-pstack规则中的 per-role 行覆盖默认值和路由技能中的模型选择未配置行的角色保持默认角色行值为inherit-parent或auto时该角色运行在父聊天模型上省略 Task 的model参数。所有Task调用默认run_in_background: true、代理模式readonly 会剥离 MCP、文件指针而非内联上下文。九、落地的关键动作清单将本手册投入实际使用时可直接照此清单执行匹配确认任务是“新增/改变行为且从命名数据形态起步” → 打开 feature.md在 todolist 首项逐字复制其步骤SKILL.md 要求“copied in verbatim”不做的步骤保留并标注skip: reason。先how摸底受影响的子系统再architect并行设计跳过即显式记录architect skipped: reason。写下四个维度的吞吐量检查点不适用维度保留n/a: reason。用 feature 模型委托实现指定文件路径、命名的数据形态、成功标准多形态时改走arena。亲自审查 diff在匹配面验证每单元红转绿后再前进。Rebase 成小而有叙事的提交并堆栈设计有争议先interrogate。以 opening-a-pr.md 收尾worktree、Conventional Commits 标题、五段式 PR 正文、/deslop与/no-comments。按“Reply”格式汇报构建了什么、选择了什么及原因、吞吐量检查点、未决决策设计备选方案用表格。这条工作流的核心价值在于它把“写代码”从一次性的线性动作重构成“先建模数据形态 → 并行探索设计 → 显式检查并行度 → 受控委托 → 匹配面验证 → 序列化提交”的可审计管线而 pstack 仓库中的每一个原则技能与默认模型配置都是这条管线可复现、可审查的底层保证。若需深入每一步的完整细节可继续阅读 poteto-mode SKILL.md 及各原则技能的叶子文件。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表