跳转到内容
learn-pstack

构成与关系

读完应能口述：有哪些零件、各干什么、一次日常改动里谁调用谁、什么让交付可验证。

本页是 explanation。查完整表去 Skills 译文。跟练去 实操课。

构成清单

Section titled “构成清单”

官方插件装入 Cursor 的是 skills 与 agents。模型表不是插件静态文件，由 /setup-pstack 写到本机。

零件 数量（当前对照副本） 一句话
Skill 47 可调用的工作流与原则 leaf
其中 principle-* 23 决策规则。一般不当 slash 入口
Playbook 23 挂在 poteto-mode 下的任务规程
Agent 2 poteto-agent、Comment Sicko
Models rule 1 ~/.cursor/rules/pstack-models.mdc

INDEX 标题有时写「22 条原则」。目录里是 23 个 principle-*。以 23 为准。

没有名为「原子」的一等组件。「可验证单元」是原则 sequence-verifiable-units，不是目录名。

flowchart TB
  subgraph plugin["Cursor 插件 pstack"]
    S["47 skills<br/>含 23 principle-*"]
    A["2 agents"]
    PB["23 playbooks<br/>在 poteto-mode 内"]
  end
  SETUP["/setup-pstack"] --> R["pstack-models.mdc<br/>本机 always-apply"]
  S --> SETUP
  PB -.->|"属于"| S

各层干什么

Section titled “各层干什么”

用五层看，不要当成五个平级菜单。

层 回答的问题 干什么 不干什么
Mode（/poteto-mode） 现在按哪套规程干活 匹配 playbook、抄步骤进 todo、按需拉其他 skill、sticky 跨回合 不替代你写模型表
Playbook 这类任务逐步怎么做 Feature / Bug fix / Investigation 等操作规程 不是独立 slash skill
Skill 某一步用什么能力 how、arena、unslop、原则 leaf… 多数不必手点。mode 会路由
Agent 子任务用哪个人格跑 Task 的 subagent_type。写代码常用 poteto-agent 不是 Cursor Rules（.mdc）
Rule（models） 谁演哪个角色、预算多深 覆盖 spawn 时的模型与 panel 人数 不教怎么写代码

Skills 与 models rule 的分工长文在仓库 docs/rules-and-skills.md。查表用 Skills 译文。

原则 leaf 只在本会话已读过时才能在回复里点名。未读不可假装用过。

谁使用谁

Section titled “谁使用谁”

依赖方向是单向的。人开两扇门。Mode 选 Playbook。Playbook 步骤拉 Skill。写代码的 Skill / 步骤 spawn Agent。Models rule 覆盖「用哪款模型」。原则被 Mode 与 Playbook 引用，不反过来拥有流程。

flowchart LR
  U["你"] --> D1["/setup-pstack"]
  U --> D2["/poteto-mode"]
  D1 --> R["models rule"]
  D2 --> PB["匹配 playbook"]
  PB --> SK["how / architect / arena / …"]
  SK --> AG["Task → agents"]
  R -.->|"覆盖 model"| SK
  R -.->|"覆盖 model"| AG
  PR["principle-*"] -.->|"约束决策"| D2
  PR -.->|"约束决策"| PB

记忆口诀：

  1. Skill = 剧本与分工（做什么、按什么规程）。
  2. Rule = 演员表（谁演 explorer、panel 几个人）。
  3. Agent = 上台的角色契约（先读 poteto-mode 的 wrapper 等）。

换掉 poteto-agent 用 generalPurpose，会跳过「先读完整 poteto-mode」那次，行为会漂。

Feature 走读：一次改动怎么 work

Section titled “Feature 走读：一次改动怎么 work”

假想你说：给设置页加一个可观察的开关。控制流大致如下。

  1. 开门。 新机器先 /setup-pstack。日常任务进 /poteto-mode。
  2. 匹配。 Mode 认成 Feature playbook。把步骤原文抄进 todo。跳过的步骤留 skip: 理由。
  3. 探路。 步骤要求时跑 /how，弄清该改哪一层。跨边界设计时跑 /architect。
  4. 实现。 先命名数据形状，再写逻辑。多种合法形状时走 /arena，不靠一句「随便选」。代码 delegate 常用 poteto-agent。难度与模型读 models rule。
  5. 证明。 对着真实界面或真实产物验证。「能编译」不算完成。这是 prove-it-works。
  6. 收口。 需要时 /interrogate、/no-comments。几乎每个写码 playbook 末尾走 Opening a PR。
  7. 之后。 推到 merge-ready 是 Babysit。真要落地是 Shipping。二者不是同一本。
sequenceDiagram
  participant You as 你
  participant Mode as poteto-mode
  participant PB as Feature playbook
  participant How as how / architect
  participant Ag as poteto-agent
  participant Rule as models rule


  You->>Mode: 加一个设置开关
  Mode->>PB: 匹配并抄步骤
  PB->>How: 探路 / 定形
  Rule-->>How: 选 explorer / explainer 模型
  PB->>Ag: 实现
  Rule-->>Ag: 选 feature 模型
  Ag-->>PB: diff
  PB->>PB: 真实表面验证
  PB->>PB: Opening a PR

日常四本是 Feature、Bug fix、Refactoring、Prototype。只读问题走 Investigation。过夜与程序级（figure-it-out、orchestrate、autopilot）另有阶梯，主课稍后练。

三个容易混的边界

Section titled “三个容易混的边界”
概念 含义
Investigation 只读。交付带引用的答案。不改代码
Babysit 推到 merge-ready。没有合并权
Shipping 没写这段代码的 agent 给 PASS 后才落地。绿灯 ≠ 安全

本仓 skills/ 与 content/skills-zh/ 是阅读与学习副本。运行时永远是已安装的 Cursor 插件。不要把学习副本注册成第二套 runtime。

接下来

Section titled “接下来”