其他
在回答「X 是怎么工作的」、改动前做代码走读…
需要解释子系统架构、运行时流程或代码归属/分层时,先判断问题复杂度,再选择单代理直解或并行探索后综合,输出架构级说明而非逐行注解。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 48/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 57/100 ×0.15
适用场景
在回答「X 是怎么工作的」、改动前做代码通用
解决思路
- 评估复杂度:如果范围含糊,先说明你对问题的理解再开始探索,用户可以纠正你的方向。
- 简单情况(单个模块、小型工具、窄问题如「函数 X 怎么工作」):不使用 explorer,由一个 explainer 在一次过程中同时完成探索和解释,进入 Step 2b。
- 复杂情况(跨多个文件或服务的子系统、横切特性、整体架构概览):先并行 spawn explorer,再交给 explainer,进入 Step 2a。
- 拿不准时走简单路径。
- Step 2a 探索(仅复杂问题):把问题拆解为 2 到 4 个探索角度,每个角度是子系统的一个不同切片。
- 在同一条消息里 spawn 所有 explorer,参数为:subagent_type 设为 generalPurpose,model 设为你配置的 how-explorer 模型(默认 grok-4.7-xhigh-fast),readonly 设为 true。
- 每个 explorer 使用 references/explorer-prompt.md 中的提示词,并填入它负责的角度;然后进入 Step 3。
- Step 2b 直接解释(简单问题):spawn 一个 Task subagent,在一次过程中完成探索和解释。
- 该 subagent 参数为:subagent_type 设为 generalPurpose,model 设为你配置的 how-explainer 模型(默认 claude-opus-5-5-max),readonly 设为 true。
- 用 references/explainer-prompt.md 构建它的 prompt,但不包含 explorer-findings 部分;然后进入 Step 4。
- Step 3 综合(仅复杂问题):等所有 explorer 返回后,spawn 一个 Task subagent 把它们的发现综合成一份解释。
- 该综合 subagent 参数为:subagent_type 设为 generalPurpose,model 设为你配置的 how-explainer 模型(默认 claude-opus-5-5-max),readonly 设为 true。
- 用 references/explainer-prompt.md 构建它的 prompt,并把每个 explorer 的发现全部填入。
- Step 4 呈现:把 explainer 的输出呈现给用户;为了清晰或补充对话中的上下文,可以做轻微编辑。
- 不要大幅重写 explainer 的输出。
- 输出格式:使用 references/explainer-prompt.md 中定义的章节,不适用的章节直接去掉,包括 Overview、Key Concepts、How It Works、Where Things Live、Gotchas。
适用边界 · 注意事项
- 问题是「为什么要这样设计」这类动机/缘由问题时,应使用 why 技能而非本技能。
- 单一模块、小型工具这类窄问题不要拆成多个并行 explorer,走简单路径即可。
- 不要把解释写得细到像带注释的源码,目标是能建立可用的心智模型,而非逐行复述代码。