ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

pstack的how与why如何配合:何时问怎么工作,何时问为何如此

pstack的how与why如何配合:何时问怎么工作,何时问为何如此 pstack的how与why如何配合何时问怎么工作何时问为何如此【免费下载链接】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、GitHub Copilot、Pi 等 AI 代理运行时的技能栈插件。它把严格代理工作流变成了可复用技能而 how 技能 与 why 技能 正是其中回答两类核心问题的搭档how 回答代码是怎么工作的why 回答代码为什么长成这样。知道何时问 which、何时问 why直接决定了你的 AI 代理是给你一个心智模型还是一份带引用的决策考古报告。 一分钟了解 pstack 的技能体系pstack 的入口是poteto-mode你告诉它目标它调用正确的工作流技能。其中 how 和 why 被官方文档明确定义为互补技能companion skillshow回答代码做什么、怎么运转why回答是什么力量塑造了它的形态。一句话区分问 how→ 得到运行机制mental model问 why→ 得到决策动机 证据引用rationale with citations 何时问 how建立它怎么工作的心智模型how技能适用于这些场景摘自 SKILL.md 的技能描述X 是怎么工作的how does X work修改某段代码前先走读一遍它归属与分层问题这段代码应该放在哪里、哪个包负责它、这是不是正确的层how 的运行流程步骤做法1. 评估复杂度单模块的小问题走简单路径跨文件子系统走复杂路径2. 并行探索复杂问题时拆成 2–4 个探索角度同时派生只读探索代理3. 综合解释由 explainer 代理把各角度发现合并成一份连贯解释4. 呈现输出 Overview / Key Concepts / How It Works / Where Things Live / Gotchas 五个部分它全程使用只读子代理产出的目标是让一位资深工程师读完就能上手这个子系统而不是逐行注释源码。提示词模板见 explainer-prompt.md。️ 何时问 why追溯为何如此的设计动机代码本身不携带动机。你能读到代码做什么却读不到它为什么存在——动机藏在提交记录、PR、工单、文档和聊天里而且往往不完整。这正是why技能要解决的问题。适用场景摘自 why 技能描述为什么 X 是这样实现的、为什么我们选了 Y设计取舍tradeoff复盘回归regression历史这个 bug 是什么时候、被什么改动引入的事故复盘postmortem需要数据支撑的阈值这个数字是哪来的why 的运行流程步骤做法1. 确定目标与问题目标是代码块、模式、特性或某个命名决策2. 建立代码锚点用git blame、git log --follow定位文件、符号、最近提交和 PR 号3. 并行调查按证据类别各派一名调查代理源码控制、工单、长文档、团队聊天、可观测性、错误追踪、产品分析共 7 类4. 综合synthesizer 代理把发现含空结果按置信度分层组织5. 呈现若这次追问是改代码的前奏还会额外输出Preserve / Change / Avoid / Risk约束集直接喂给后续变更规划每类证据的调查手册在 references/sources/总索引见 source-playbook.md。⭐ 五档置信度why 最独特的设计why 的输出严格遵循 epistemics.md 定义的置信度框架每条结论必须归入一档Direct直接——有明确的文字引用如 PR 描述里写了原因。可用因为…Supported有支撑——多个间接证据收敛需引用多来源Inferred推断——合理推断但无明确支撑必须用看起来、很可能等措辞Speculative推测——证据稀薄的假设放进竞争假设区Unknown未知——查过了但没有。诚实地写明搜了什么、没找到什么这套框架还内置了防坑机制避免近因偏差别假设最近一次提交就是权威原因、避免谄媚陷阱你带着假设来问它要把你的猜测当候选之一独立验证而不是顺着你说、避免合理化别给 messy history 硬套一个漂亮动机。 how 与 why 的三种典型配合方式1️⃣ teach 技能并行运行编织成一份讲解当你的需求是教教我这块代码时teach 技能 会同时跑 how 和 whyhow 负责怎么工作why 负责为何如此然后把两者发现编织成一份平实的讲解。注意它的一条硬规矩why的置信度措辞必须原样保留——那些对冲看起来、很可能是调查结果本身不是文风。2️⃣ 修 bughow 种子假设 why 追溯回归史在 bug-fix 剧本 的第 2 步二分定位根因中两个技能各领一摊how作用于受影响的子系统 → 帮你形成候选假设why负责回归历史 → 帮你找到是什么时候坏的、被哪次提交引入的原文要求Seed them withhowover the affected subsystem and thewhyskill for regression history.——用 how 播种机制层面的假设用 why 补上历史层面的证据然后逐一排除直到只剩一个。3️⃣ 开发新功能先 how后设计在 feature 剧本 里第一步就是对受影响的子系统跑how。先建立心智模型再让 architect 做并行设计探索可以大幅避免改完才发现放错层的返工。 30 秒决策清单你的问题用哪个这个功能运行时发生了什么how我要改这块先帮我摸清结构how这段逻辑该放在哪个模块how当年为什么用方案 A 不用 Bwhy这个 bug 是哪次提交引入的why这个超时值 3000ms 是怎么定的why给我完整讲讲这块how why 并行即 teach拿不准时先 how它只读、轻量且是 why 建立代码锚点的前置输入结语pstack 把问对问题工程化了how 给你地图why 给你历史档案。前者决定你改代码前懂不懂它后者决定你改完之后不踩当年的坑。两个技能都可用/setup-pstack配置角色模型默认均为opus见 models.json更多技能清单可查阅 docs/reference.md。【免费下载链接】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),仅供参考
返回列表