尧图网页设计 
pstack的how技能详解走读子系统工作原理的完整方法【免费下载链接】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、Copilot、Pi 等智能体运行时的技能栈其中的how 技能专门回答某个子系统是怎么工作的这类问题。它把走读代码变成一套可复用的标准流程判断复杂度、按需派出并行探索代理explorer、再由讲解代理explainer合成一份让资深工程师快速建立心智模型的系统性说明。这篇文章带你完整看懂 how 技能的工作原理与产物结构。什么是 how 技能适合什么时候用how 技能的定义写在 SKILL.md 的元数据里它的适用场景非常明确代码走读在动手改代码之前先弄清X 是怎么工作的归属与分层问题这段逻辑应该放在哪里哪个包负责这件事这是正确的分层吗架构讲解面向新接触某个子系统的工程师解释其架构与运行时流程一句话概括how 技能产出的是资深工程师入职某个子系统时需要的架构级讲解——足以建立可用的心智模型但不会写成逐行源码注释。需要注意它与why技能的分工how 解释系统如何运转why 解释当初为什么这么设计。在 poteto-mode 的路由规则中不确定的架构决策或我们确认一下这类情况会直接路由到 how 技能见 poteto-mode/SKILL.md。第一步评估复杂度决定走哪条路径how 技能的第一步不是读代码而是判断问题复杂度问题类型典型例子处理路径简单问题单个模块、小型工具、函数 X 怎么工作2b单个讲解代理一次完成探索与解释复杂问题跨多个文件/服务的子系统、横切特性、整体架构概览2a先并行派出 2~4 个探索代理再交给讲解代理合成一个实用原则写在技能定义里拿不准时就走简单路径避免为小问题付出编排成本。简单问题单代理直讲直接生成一个general-purpose子代理readonly: true只读访问代码库用 explainer-prompt.md 模板去掉探索发现部分后构造提示词探索与解释一步到位随后进入呈现环节。复杂问题并行探索 集中合成这是 how 技能最核心的设计——分而治之分解视角把大问题拆成 2~4 个探索角度angle每个角度对应子系统的一个独立切面并行派出所有 explorer 在同一条消息中一次性启动每个都用 explorer-prompt.md 模板填入各自的角度合成讲解等所有 explorer 返回后启动一个 explainer 子代理把所有发现填入 explainer 模板整合成一份统一说明explainer 的提示词明确要求它调和各 explorer 之间重叠甚至矛盾的描述合并重复内容遇到冲突时自己查代码裁决把碎片拼成一张完整图景。探索代理的五步走读法explorer 提示词模板规定了一套严谨的探索方法论值得单独拿出来看找到入口点什么触发了这个行为用户操作、API 调用还是定时任务追踪流程从入口沿调用链走下去读每个函数弄清数据如何流转和变形梳理关键抽象哪些类型、接口、服务是核心读懂它们的定义与存在理由找出边界子系统与外部如何交互什么进、什么出留意不显而易见之处有历史遗留吗有什么新人容易误解的点吗模板里还有两条很有分量的纪律不要凭名字猜去读代码Dont guess from names. Read the code.查不到就明说——我无法确定 X 如何连接到 Y比编造答案好得多最终每个 explorer 返回结构化发现组件清单名称文件路径一句话职责、执行流程、读过的文件、边界、非显而易见的细节以及诚实列出的未解问题Open Questions。讲解产出固定的五段式输出how 技能的最终说明采用固定的章节结构不适用的部分可以省略章节作用Overview1~2 段这是什么、做什么、为什么存在。读完这段就能决定要不要继续读Key Concepts跟进后续内容所需的关键类型、服务、抽象的简要定义How It Works全文核心、篇幅最长触发条件、逐步流程、数据流向、决策点用散文而非伪代码涉及多组件协作时附 mermaid 或 ASCII 图Where Things Live文件/目录速查表只列上手工作真正需要的Gotchas反直觉的行为、历史背景、易踩的坑提示词对文风也有硬性要求用具体语言UserService 调用 AuthClient.refresh()而不是服务委托给客户端、复杂的东西要解释为什么复杂、简单的事物不要注水、有用的类比才用没有就别硬凑。模型与推理努力度配置how 技能的两个角色在 models.json 中都有默认值how exploreropushow explaineropus你可以在本地覆盖表pstack-models.md中按角色改配模型甚至指定推理努力度例如opus xhigh通过/setup-pstack技能即可完成配置。在 Claude Code 上带努力度后缀的角色会被调度到插件对应的pstack:effort-level或pstack:poteto-agent-level代理模型名不受影响。how 技能在整体工作流中的位置how 不是孤立技能它在 pstack 的多个剧本中反复出现Bug 修复用 how 对受影响子系统建立认知配合 why 查回归历史再开始二分定位见 bug-fix.md功能开发动手前第一步就是对受影响子系统运行 how见 feature.md性能调优先跑 how 确定真实负载维度再选可复现的基准用例见 hillclimb.md调查研究只读问题的标准入口产出即 how 的五段式格式见 investigation.md完整的斜杠命令对照/how、/why、/teach等可查阅官方文档 docs/reference.md。总结how 技能值得借鉴的三点设计先分类再动手用复杂度评估避免大炮打蚊子简单问题单代理一次搞定读写分离explorer 只负责采集事实强调准确与彻底explainer 只负责成文强调结构与可读职责切分让两边都能做到极致诚实优先模板把承认不知道写成了明确的输出要求Open Questions 章节保证讲解的可信度如果你想在自己的项目中实践这套方法可以 clone 仓库后从 plugins/pstack/skills/how/SKILL.md 开始走读它是理解 pstack 整套工作流技能的最佳入口。【免费下载链接】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），仅供参考 pstack的how技能详解：走读子系统工作原理的完整方法
pstack的how技能详解走读子系统工作原理的完整方法【免费下载链接】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、Copilot、Pi 等智能体运行时的技能栈其中的how 技能专门回答某个子系统是怎么工作的这类问题。它把走读代码变成一套可复用的标准流程判断复杂度、按需派出并行探索代理explorer、再由讲解代理explainer合成一份让资深工程师快速建立心智模型的系统性说明。这篇文章带你完整看懂 how 技能的工作原理与产物结构。什么是 how 技能适合什么时候用how 技能的定义写在 SKILL.md 的元数据里它的适用场景非常明确代码走读在动手改代码之前先弄清X 是怎么工作的归属与分层问题这段逻辑应该放在哪里哪个包负责这件事这是正确的分层吗架构讲解面向新接触某个子系统的工程师解释其架构与运行时流程一句话概括how 技能产出的是资深工程师入职某个子系统时需要的架构级讲解——足以建立可用的心智模型但不会写成逐行源码注释。需要注意它与why技能的分工how 解释系统如何运转why 解释当初为什么这么设计。在 poteto-mode 的路由规则中不确定的架构决策或我们确认一下这类情况会直接路由到 how 技能见 poteto-mode/SKILL.md。第一步评估复杂度决定走哪条路径how 技能的第一步不是读代码而是判断问题复杂度问题类型典型例子处理路径简单问题单个模块、小型工具、函数 X 怎么工作2b单个讲解代理一次完成探索与解释复杂问题跨多个文件/服务的子系统、横切特性、整体架构概览2a先并行派出 2~4 个探索代理再交给讲解代理合成一个实用原则写在技能定义里拿不准时就走简单路径避免为小问题付出编排成本。简单问题单代理直讲直接生成一个general-purpose子代理readonly: true只读访问代码库用 explainer-prompt.md 模板去掉探索发现部分后构造提示词探索与解释一步到位随后进入呈现环节。复杂问题并行探索 集中合成这是 how 技能最核心的设计——分而治之分解视角把大问题拆成 2~4 个探索角度angle每个角度对应子系统的一个独立切面并行派出所有 explorer 在同一条消息中一次性启动每个都用 explorer-prompt.md 模板填入各自的角度合成讲解等所有 explorer 返回后启动一个 explainer 子代理把所有发现填入 explainer 模板整合成一份统一说明explainer 的提示词明确要求它调和各 explorer 之间重叠甚至矛盾的描述合并重复内容遇到冲突时自己查代码裁决把碎片拼成一张完整图景。探索代理的五步走读法explorer 提示词模板规定了一套严谨的探索方法论值得单独拿出来看找到入口点什么触发了这个行为用户操作、API 调用还是定时任务追踪流程从入口沿调用链走下去读每个函数弄清数据如何流转和变形梳理关键抽象哪些类型、接口、服务是核心读懂它们的定义与存在理由找出边界子系统与外部如何交互什么进、什么出留意不显而易见之处有历史遗留吗有什么新人容易误解的点吗模板里还有两条很有分量的纪律不要凭名字猜去读代码Dont guess from names. Read the code.查不到就明说——我无法确定 X 如何连接到 Y比编造答案好得多最终每个 explorer 返回结构化发现组件清单名称文件路径一句话职责、执行流程、读过的文件、边界、非显而易见的细节以及诚实列出的未解问题Open Questions。讲解产出固定的五段式输出how 技能的最终说明采用固定的章节结构不适用的部分可以省略章节作用Overview1~2 段这是什么、做什么、为什么存在。读完这段就能决定要不要继续读Key Concepts跟进后续内容所需的关键类型、服务、抽象的简要定义How It Works全文核心、篇幅最长触发条件、逐步流程、数据流向、决策点用散文而非伪代码涉及多组件协作时附 mermaid 或 ASCII 图Where Things Live文件/目录速查表只列上手工作真正需要的Gotchas反直觉的行为、历史背景、易踩的坑提示词对文风也有硬性要求用具体语言UserService 调用 AuthClient.refresh()而不是服务委托给客户端、复杂的东西要解释为什么复杂、简单的事物不要注水、有用的类比才用没有就别硬凑。模型与推理努力度配置how 技能的两个角色在 models.json 中都有默认值how exploreropushow explaineropus你可以在本地覆盖表pstack-models.md中按角色改配模型甚至指定推理努力度例如opus xhigh通过/setup-pstack技能即可完成配置。在 Claude Code 上带努力度后缀的角色会被调度到插件对应的pstack:effort-level或pstack:poteto-agent-level代理模型名不受影响。how 技能在整体工作流中的位置how 不是孤立技能它在 pstack 的多个剧本中反复出现Bug 修复用 how 对受影响子系统建立认知配合 why 查回归历史再开始二分定位见 bug-fix.md功能开发动手前第一步就是对受影响子系统运行 how见 feature.md性能调优先跑 how 确定真实负载维度再选可复现的基准用例见 hillclimb.md调查研究只读问题的标准入口产出即 how 的五段式格式见 investigation.md完整的斜杠命令对照/how、/why、/teach等可查阅官方文档 docs/reference.md。总结how 技能值得借鉴的三点设计先分类再动手用复杂度评估避免大炮打蚊子简单问题单代理一次搞定读写分离explorer 只负责采集事实强调准确与彻底explainer 只负责成文强调结构与可读职责切分让两边都能做到极致诚实优先模板把承认不知道写成了明确的输出要求Open Questions 章节保证讲解的可信度如果你想在自己的项目中实践这套方法可以 clone 仓库后从 plugins/pstack/skills/how/SKILL.md 开始走读它是理解 pstack 整套工作流技能的最佳入口。【免费下载链接】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），仅供参考