企业官网建设流程全解析

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 原则技能：

1. 对受影响子系统执行how摸底。
2. 执行architect做并行设计探索；跳过必须显式记录为architect skipped: <reason>，不得把设计决策悄悄并入实现。
3. 把吞吐量检查点写成四个待办项（见下节）。
4. 委托子代理写代码，使用你配置的 feature 模型（默认grok-4.6-fast-xhigh），指定明确范围（文件路径、命名的数据形态与组织结构、成功标准），并亲自审查其 diff。
5. 在匹配的验证面上验证，Inconclusive或验证面错误都不算通过，必须标记出来。
6. Rebase 成小而有序的提交，把后续改动堆叠成栈，使用sequence-verifiable-units原则技能，每个小单元构建、验证、提交后再进入下一个。
7. 若设计存在争议，在发布前执行interrogate。
8. 运行Opening a PR演练手册收尾。

手册末尾还给出回复格式要求：Reply:说明构建了什么、选择了什么及原因、吞吐量检查点、未决决策；设计备选方案用表格呈现。这与 poteto-mode 的“Writing the reply”风格一致（短陈述句、无长破折号、每句结论自带证据标签）。

三、吞吐量检查点：四个必须写进待办列表的维度

这是 Feature 手册最具操作性的核心：在委托实现之前，先写下一个“吞吐量检查点”（throughput checkpoint），拆成四个 todo 项。真正不适用的维度（如单文件、无扇出）也必须保留该项，并标注n/a: <reason>，而不是直接删除。

这四个维度与 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 subagent's work. Review the diff and write your own summary, don't 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-comments；PR 标题用 Conventional Commits 形式type(scope): subject（如fix(pstack): retarget opening-a-pr babysit trigger）；PR 正文按## Why、## Scope、## Tradeoffs、## Blast Radius、## Verification顺序组织；优先五个窄 PR 而非一个大 PR；PR 一律以 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技能定制：

覆盖规则：/setup-pstack规则中的 per-role 行覆盖默认值和路由技能中的模型选择；未配置行的角色保持默认；角色行值为inherit-parent或auto时，该角色运行在父聊天模型上（省略 Task 的model参数）。所有Task调用默认run_in_background: true、代理模式（readonly 会剥离 MCP）、文件指针而非内联上下文。

九、落地的关键动作清单

将本手册投入实际使用时，可直接照此清单执行：

1. 匹配确认：任务是“新增/改变行为且从命名数据形态起步” → 打开 feature.md，在 todolist 首项逐字复制其步骤（SKILL.md 要求“copied in verbatim”），不做的步骤保留并标注skip: <reason>。
2. 先how摸底受影响的子系统，再architect并行设计；跳过即显式记录architect skipped: <reason>。
3. 写下四个维度的吞吐量检查点，不适用维度保留n/a: <reason>。
4. 用 feature 模型委托实现，指定文件路径、命名的数据形态、成功标准；多形态时改走arena。
5. 亲自审查 diff；在匹配面验证；每单元红转绿后再前进。
6. Rebase 成小而有叙事的提交并堆栈；设计有争议先interrogate。
7. 以 opening-a-pr.md 收尾：worktree、Conventional Commits 标题、五段式 PR 正文、/deslop与/no-comments。
8. 按“Reply”格式汇报：构建了什么、选择了什么及原因、吞吐量检查点、未决决策，设计备选方案用表格。

这条工作流的核心价值在于：它把“写代码”从一次性的线性动作，重构成“先建模数据形态 → 并行探索设计 → 显式检查并行度 → 受控委托 → 匹配面验证 → 序列化提交”的可审计管线，而 pstack 仓库中的每一个原则技能与默认模型配置，都是这条管线可复现、可审查的底层保证。若需深入每一步的完整细节，可继续阅读 poteto-mode SKILL.md 及各原则技能的叶子文件。

【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins