关于 zoom-out
zoom-out 是一项用于梳理陌生代码领域的技能:让多个探索者并行调查不同角度,再综合发现。适合刚接触陌生子系统或接手他人工作的场景。
主要功能
- 01按不同角度并行探索
- 02梳理代码结构与依赖
- 03调查文档和决策历史
- 04整理术语与领域概念
- 05综合生成方向图
适用场景
- 01熟悉陌生子系统
- 02接手他人的工作
- 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