how

使用方法

以粗体或反引号标出的技能名称，或以 /<name> 形式运行的技能，指的是此技能目录旁边的 ../<name>/SKILL.md 文件；不带前缀的原则名称指的是 ../principle-<name>/SKILL.md。阅读该文件并遵循其中的说明。大多数 pstack 技能仅供用户使用，因此你的技能工具无法加载它们。每次 delegate_task 调用都遵循 ../poteto-mode/SKILL.md 中 Subagents 部分的默认设置。

探索代码库，回答“X 是如何工作的？”这类问题。提供面向资深工程师、帮助其熟悉子系统的架构说明，内容应足以建立可用的整体认知模型，但不要详尽到像带注释的源代码一样。

下面每个 spawn 都是一个 mode: "async" 的 delegate_task 子任务。探索者的标题为 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 option id 是该模型在 orchestrator_capabilities 中列出的值。如果值为 auto 或 inherit-parent，或文件或对应行不存在，则省略 target，让子任务使用父线程的模型。如果文件不存在，说明这一点并建议使用 /setup-pstack。如果 delegate_task 拒绝某个条目，则使用 orchestrator_capabilities 列出的同一提供方最接近的模型，并说明这一点。根据 poteto-mode 技能的 Subagents 部分，为每个子任务选择推理级别和快速或标准速度。子任务只能收到任务说明，因此说明中须包含已填好的提示词模板，并注明只读：仅检查，不写入，不运行 git 命令。生成子任务后结束本轮，让完成通知唤醒你。

1. 评估复杂度

如果范围不明确，请说明你的理解并进行探索。用户可以纠正方向。

• 简单（单个模块、小型工具，或“函数 X 是如何工作的？”这类范围明确的问题）：不启动探索者。启动一个讲解者，让其一次性完成探索和讲解；根据 references/explainer-prompt.md 编写，但不包含 explorer-findings 部分。转到第 4 步。
• 复杂（涉及多个文件或服务的子系统、跨领域功能，或完整的架构概述）：转到第 2 步。

如有疑问，选择简单路径。

2. 探索（仅限复杂情况）

将问题分解为 2 到 4 个角度，每个角度覆盖子系统中不同的部分。在同一轮中启动所有探索者，并为每个探索者提供填入对应角度的 references/explorer-prompt.md。

3. 综合（仅限复杂情况）

所有探索者都返回后，启动一个讲解者，并将每位探索者的发现填入 references/explainer-prompt.md。

4. 呈现

呈现讲解者的输出。可以为清晰度或结合对话背景做少量编辑，但不要大幅改写。

输出格式

讲解应采用 references/explainer-prompt.md 中定义的章节；不适用的章节可省略：概述、关键概念、工作原理、代码位置、注意事项。