用途
how 是一个用于理解代码库的技能，主要面向三类需求：回答“X 是如何工作的”；在修改某段代码之前做通读式讲解；以及处理放置、归属和分层类问题，例如“这段逻辑应该放在哪里”“哪个部分负责这件事”。其定位是帮助资深工程师在接手某个子系统时建立可用的心智模型，输出详略程度以能形成整体理解为准，而不是像带注释的源码那样逐行罗列。
主要能力
该技能通过子代理协作完成代码讲解：
- 复杂度评估：若范围含糊，先说明自己的理解再展开探索，用户可以随时纠正方向。
- 简单场景（单个模块、小型工具、范围很窄的问题，例如“函数 X 是怎么工作的”）：不派探索者，仅派出一名讲解者，在一次流程中同时完成探索与讲解，提示词基于 references/explainer-prompt.md，但不含探索者发现部分。
- 复杂场景（跨多个文件或服务的子系统、横切特性、完整架构概览）：先进入探索阶段，再综合讲解。拿不准时走简单路径。
- 探索（仅复杂场景）：把问题拆成 2 至 4 个角度，每个角度是子系统的一个独立切面，在同一轮中派出全部探索者，各自使用 references/explainer-prompt.md 并填入自己的角度。
- 综合（仅复杂场景）：等待全部探索者返回后，派出一名讲解者，使用 references/explainer-prompt.md 并填入所有探索者的发现。
- 呈现：展示讲解者的输出，可以为清晰或补充会话上下文做轻微编辑，但不做大幅改写。
使用方式
每个子代理都是一次 delegate_task 子任务，模式为 async。探索者命名为 how explorer: <angle>，模型取自 ~/.config/pstack/pstack-models.md 中的 how explorer 行；讲解者命名为 how explainer: <question>，模型取自 how explainer 行。模型条目 <providerInstanceId>/<model> (<effort>) 会转换为 target: {"providerInstanceId": ..., "model": ..., "options": {"<effort option id>": "<effort>"}}，其中 effort 选项 id 由 orchestrator_capabilities 为该模型列出。当取值为 auto 或 inherit-parent，或该文件／该行缺失时省略 target，让子代理沿用父线程模型。若没有该配置文件，需要说明并建议运行 /setup-pstack。若 delegate_task 拒绝某个条目，则改用同一提供商下 orchestrator_capabilities 列出的最接近模型，并说明这一变化。每个子代理的推理级别与速度按 poteto-mode 技能的 Subagents 部分选择。子代理只接收自己的任务简报，因此简报中要包含填好的提示词模板，并说明为只读：仅做检查，不写入，不执行 git 命令。派发完成后结束当前回合并等待完成通知唤醒。
被加粗或用反引号标注的技能名，或通过 /<name> 运行的技能，对应本技能目录旁的 ../<name>/SKILL.md；不带前缀的原则名对应 ../principle-<name>/SKILL.md，读取并遵循该文件。多数 pstack 技能为 user-only，因此普通 skill 工具无法加载它们。每次 delegate_task 调用都遵循 ../poteto-mode/SKILL.md 中 Subagents 部分的默认设置。
适用场景
- 想快速理解某个子系统或特性的整体架构与工作机制。
- 准备改动某段代码前，先通读相关实现以降低风险。
- 判断某段逻辑应该放在哪个模块、由谁负责，涉及分层与归属决策。
限制
- 输出以架构级讲解为主，不以逐行源码注释为目标。
- 探索子代理为只读，不写入文件，不执行 git 命令。
- 多数 pstack 技能为 user-only，普通 skill 工具可能无法加载。
- 若缺少 pstack-models.md 配置文件，需先运行 /setup-pstack；具体模型可用性与能力由 orchestrator_capabilities 决定。
- 官方文档与具体收费、平台支持等信息暂未提供。