PanQiWei/pqw-skills

把一程长活，放心交给 agent：你和它先把边界定清，一次交出一程，它按切片自主交付，你回来验收。给 Claude Code、Codex、Cursor 等 coding agent 的 27 个技能。
bash
claude plugin marketplace add PanQiWei/pqw-skills
claude plugin install pqw-skills@pqw
Codex、Cursor、Kimi Code、DSH、Copilot、Gemini 的装法见安装。装好后问一句「这套流怎么用」，它会教你；日常做事在提示前点名 /pqw-mode。
English
我与 Claude Code、Codex、Cursor 等 coding agent 协作沉淀出的单会话研发流。它是一条控制回路：先在动手前把不确定性尽量消掉，再把执行放手给代理，再用固定节拍从顶层回看。你的注意力只花在定义边界和高层判断上，不花在逐行盯实现上。
## 怎么用
两种用法，都从总入口 pqw-mode 进。
日常的工作，点名 /pqw-mode。 它先认这件事属于哪个场景，再指出过哪几个思维模型、去哪个技能。它只路由，不写做法，不管执行风格。从上往下判，第一条命中的为准：
| 场景 | 怎么认出来 | 去向 |
| 大改动 | 要动领域边界、要同步跨域的消费者，或大到要你离开再回来验 | 必须：完整的流 single-session-dev-flow |
| 评审 | 产出是对一份已有改动的判断 | 默认：Matt 的 code-review，只核承诺的有没有做到 |
| 回答一个问题 | 产出是结论，写的代码不留在仓库 | 候选：答案在仓库里就直接读；要读外部资料用 research；要跑出来才知道用 prototype |
| 定位问题 | 有现象，没有一条会变红的复现 | 必须：Matt 的 diagnosing-bugs |
| 重构与优化 | 外部可见的行为不变 | 默认：结构用 codebase-design 加自带的读数脚本，性能用 pstack 的 benchmark-checklist |
| 改一个行为 | 其余写代码的工作 | 默认：Matt 的 tdd，测试绿了之后单独做好一轮 |
去向分三档。必须：认出场景就加载。默认：加载，事情小到不值得时说明理由跳过。候选：命中条件才加载。另有五个与场景正交的条件，命中就叠上去：没有人在场、碰到状态与操作、一句话有两种读法、要派子代理或交给人、你这一侧有风险。指到文件与行的单点修改不用过它，直接做。
大改动，走完整的流。 判据是影响范围：改动会触及领域边界、跨域协作或系统全局的架构时才走。
| 走这条流 | 不走这条流 |
| 复杂系统新增一个领域 | 小的缺陷修复 |
| 跨多个领域的功能纵线交付 | 快速原型，验证一个想法 |
| 子系统重构 | 小规模的增量接口设计与实现 |
| 较大规模的改造 | 一处局部修改，影响范围一眼看得清 |
不够格的工作整条流都不走，也不走缩水版：回到上面的场景，按场景做。做着发现够格了，停下来转到完整的流，只升级，不缩水。
## 做事方式
整套做事方式压成两句总纲，管着七个思维模型。每个模型恰好归一句。
少即是多。 少的是范围与产出，不是验证：差异之外不做，同一个结构只设计一次，能自己做的不转手。管拆、找差异、转手。
慢即是快。 慢的是不可逆的和决定后面很多步的地方，不是所有地方：先定形再写，先对再好，先有证据再说完成，先查再定。管定形、建、证、问。
两句各带一个限定语，因为不带就会被读歪：「少」不是少验证，「慢」不是处处都慢。你催进度的时候，代理应该告诉你还要多久、卡在哪，由你决定等不等，不会悄悄跳过约定的验证。
这两句和七个想法各一句，压成一张常驻卡片。把它原样放进项目的常驻入口文件，代理在加载任何技能之前就读得到；常驻卡片、pqw-mode、流的入口与教学技能里的两句一字不差，从哪个入口进来读到的都是同一套。
## 有哪些东西
仓库是扁平的：一个总入口技能，一个流的入口技能，13 个环节技能，一个交接期的阶段技能，七个横切的思维模型技能，一个诤友技能，加教学与写作技能。自定义的环节正文在这里，已有成熟做法的环节直接引用 pstack、ub-mode、mattpocock 的技能，不复制它们的正文。
定义期由你主导，每一步回答一个问题、产出一样东西，并且是下一步的输入，顺序不能跳。交接期像接力赛的接力区，由设计会话做，你在场：定约写这一程的 spec，定程定这一程多大、要不要分程，交出写交接信息包，包里只有这一程。交出是物理条件：这一程依赖的约束已在各自的拥有者处并过评审，否则边界不算定好。约束指架构与领域边界、规格、静态检查与形式化件。交出之后，你可以把注意力移开，由主代理自主推进交付；这一程交回来，你回到设计会话收回：上手验收，再交下一程。
## 技能
上面两张图是全貌。每个技能做什么、引用了哪些外部技能，展开下面的细目。
技能细目
### 入口与教学
pqw-mode：整套技能的总入口，由你点名进入。先看叠加的条件（没有人在场、碰到状态与操作、有两种读法、要转手、人这一侧有风险），再从上往下认场景：大改动、评审、回答一个问题、定位问题、重构与优化、改一个行为；每个场景给出过哪几个思维模型、去哪个技能，去向分必须、默认、候选三档；点名的技能没装时按想法自己做并说明。四条规矩：先加载去向再动手，只升级不缩水，第一条回复说出选了哪一行，单点修改不过路由。只路由，不写做法，不管执行风格。
single-session-dev-flow：流的入口，pqw-mode 的「大改动」一路。判断够不够格走这条流，定阶段、顺序、交接期，把 13 个环节与交接期的四件事写进会话任务清单，指出每个环节加载哪个技能。不写环节的做法。开头一节「写代码的四条」（先做对；再做好一轮；不过度设计、不提前优化；找本质解）对一切写代码的工作适用，是这几条心智在本仓库的唯一正文。「怎么想」一节写着两句总纲与七个模型的全表。引用 in-your-own-words、poteto-mode、tdd；不够格时转 pqw-mode。
teach-pqw-skills：教人用这套流。心智模型与哲学、每个环节人和代理各做什么、第一条提示怎么写、跑偏了怎么纠、接入自己的项目。只回答并给示例提示，不开工。
### 定义期，人主导
| 环节 | 技能 | 回答的问题 | 引用 |
| 1 | requirement-and-invariants | 给用户什么能力，系统前后有什么区别；系统永远要守住什么 | in-your-own-words、grilling |
| 2 | domain-impact-analysis | 哪些领域受影响，要不要新领域，谁是重点谁是连带，全局怎么摆 | domain-modeling、principle-model-the-domain、blast-radius |
| 3 | tech-research-and-reuse | 有没有现成的库、相近系统或社区实现可复用，自造的论证是什么 | research、principle-subtract-before-you-add |
| 4 | formal-guard | 哪些性质靠测试守不住，要靠偏函数全化、数理建模与证明 | create-formal-verification-skill、statechart、maintain-formal-verification-skill |
| 5 | detailed-domain-design | 领域内部的对象、关系、仓储长什么样，I/O 与查询性能怎么定 | domain-modeling、codebase-design、architect、principle-type-system-discipline、principle-boundary-discipline |