mcpField
Z
zoom-out

zoom-out

github.com/haowjyAgent 工作流549389 次安装1 天前更新
代码仓库

关于 zoom-out

zoom-out 是一项用于梳理陌生代码领域的技能:让多个探索者并行调查不同角度,再综合发现。适合刚接触陌生子系统或接手他人工作的场景。

主要功能

  1. 01按不同角度并行探索
  2. 02梳理代码结构与依赖
  3. 03调查文档和决策历史
  4. 04整理术语与领域概念
  5. 05综合生成方向图

适用场景

  1. 01熟悉陌生子系统
  2. 02接手他人的工作
  3. 03回应梳理某领域的请求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/haowjy/creative-writing-skills --skill zoom-out

安装后在 Claude Code 中输入/zoom-out确认已加载。

详细介绍

拉远视角

如果尚未加载,请加载 /creative-writing-skills:qi-layer。

通过并行派出多个探索者,让每位探索者从不同角度考察,再将他们的报告综合成一张方向图,帮助你熟悉陌生领域。单个探索者只能看到一部分;拉远视角能同时覆盖结构、知识和历史,避免视角偏差。

适用于初次接触陌生子系统、接手他人的工作,或用户说“带我了解一下”/“这里的整体情况是怎样的”时。

分头探索

根据该领域的实际内容,并行派出不同角度的探索者,每位只负责一个角度,并聚焦一个问题。

  • 结构(@explorer):该领域各部分如何连接、行为逻辑位于何处;在代码中,关注调用方、依赖项、模块边界和入口点。
  • 文档知识(基于知识库的 @explorer):该领域有哪些文档,包括架构说明、指南和综合研究。
  • 决策历史(@session-miner):该领域为何形成现在的样子,包括以往选择、被否决的替代方案和发现的限制。
  • 领域概念(@explorer):该领域使用的术语(知识库词汇页面、.context/CONTEXT.md、AGENTS.md)。

为每位探索者指定一个角度,并限定具体路径或主题:独立考察才有价值。

综合整理

阅读报告,整理成一张方向图,而不是把报告拼接在一起:

  • 这是什么:用两三句话说明该领域的用途和边界。
  • 结构:说明重要的部分和接口,以及它们如何连接(如果结构具有空间关系,可用 mermaid 图)。
  • 为何如此:说明影响当前形态的决策和限制。
  • 术语:列出准确讨论该领域所需的术语。
  • 待解决事项:总结探索者发现的空白、技术债务或未解决问题。

当报告相互矛盾时,不要并列罗列,而要根据各来源负责的内容作出判断:事物本身(代码、数据、手稿)反映当前状态,已确定的决策则体现设计意图。描述与当前状态不符的文档已过时(请注明);当前状态与已确定的意图之间的差异则应作为偏离报告。精简方向图:目标是让读者能够开始探索该领域,而不是获得一份详尽的逐字记录。

评论

支持 Markdown