关于 how
how 是一项 Claude Code 技能,用于探索代码库并解释功能或子系统的工作方式。它根据问题范围安排单个或多个角度的探索,并生成面向工程师上手的架构说明。
主要功能
- 01按问题范围安排代码探索
- 02复杂系统采用并行探索
- 03提供子 Agent 模型选择指引
- 04生成结构化架构说明
适用场景
- 01理解不熟悉的模块
- 02追踪跨服务功能
- 03准备子系统上手说明
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cursor/ plugins --skill how安装后在 Claude Code 中输入/how确认已加载。
附带文件references/explainer-prompt.mdreferences/explorer-prompt.md
详细介绍
如何运作
在 Claude Code 中,每个会话开始时都要先阅读一次Claude Code 适配器,再遵循此技能。它会将 pstack 技能中的 Cursor 名称映射到 Claude Code。
探索代码库,回答“X 是如何运作的?”这类问题。提供架构层面的说明,深度要足以让刚加入子系统的资深工程师建立可用的心智模型,但不要详细到像是带注释的源代码。
每次派生的都是一个 Task 子 Agent,subagent_type: generalPurpose 且 readonly: true。探索器使用 pstack-models.mdc 规则中的 how explorer 行(默认值为 grok-4.7-xhigh-fast),每个讲解器使用 how explainer 行(默认值为 claude-opus-5-5-xhigh)。将 model 设为该行的值;如果规则或该行不存在,则使用默认值。如果值为 auto 或 inherit-parent,则不设置 model。如果 Task 工具拒绝某个模型标识符,则使用默认值并说明这一点。如果它拒绝默认值,则使用错误消息中同一系列最接近的有效标识符。根据任务需要,按照 poteto-mode 技能的 Subagents 部分为每个子 Agent 选择推理级别和快速或标准速度。
1. 评估复杂度
如果范围不明确,请说明你的理解并进行探索。用户可以纠正。
- 简单(单个模块、小型实用工具、范围有限的问题,例如“函数 X 是如何运作的”):不使用探索器。派生一个讲解器,让它基于
references/explainer-prompt.md一次性完成探索和讲解,但不包含探索器发现部分。转到第 4 步。 - 复杂(跨多个文件或服务的子系统、横向功能、完整的架构概览):转到第 2 步。
如有疑问,选择简单路径。
2. 探索(仅限复杂情况)
将问题拆分为 2 到 4 个角度,每个角度对应子系统中一个不同的部分。使用 references/explorer-prompt.md,填入各自的角度,然后在一条消息中派生所有探索器。
3. 综合(仅限复杂情况)
所有探索器返回结果后,使用 references/explainer-prompt.md,并填入每个探索器的发现,然后派生一个讲解器。
4. 呈现
呈现讲解器的输出。可以稍作润色,以提升清晰度或补充对话上下文。不要大幅改写。
输出格式
讲解内容使用 references/explainer-prompt.md 中定义的章节;不适用的章节可省略:概览、关键概念、工作原理、文件位置、注意事项。