mcpField
Z
zoom-out

zoom-out

github.com/akillness开发52275 次安装今天更新
代码仓库

关于 zoom-out

Zoom Out 是供编码 Agent 使用的指导技能，用于梳理陌生代码区域的整体结构。它呈现相关模块、调用与依赖关系，并在实施修改前应用领域术语。

主要功能

  1. 01梳理相关模块
  2. 02展示调用关系
  3. 03识别关键依赖
  4. 04应用 CONTEXT.md 中的领域术语

适用场景

  1. 01理解陌生代码如何融入系统
  2. 02修改前评估影响范围
  3. 03实施前绘制模块图

安装

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

$npx skills add https://github.com/akillness/jeo-skills --skill zoom-out

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

详细介绍

放大视角

从更高层次了解不熟悉代码部分的架构视角。

上游状态

已从 mattpocock/skills 上游移除（实际未使用）。在此保留，作为架构放大视角的入口。

何时使用此技能

  • 浏览不熟悉的代码，并需要了解它与更大系统的关联时
  • 修改代码前，了解影响范围时
  • 深入实现细节前，需要模块地图时

何时不使用此技能

  • 查找特定符号或模式 → 使用 codebase-search
  • 寻找架构改进机会 → 使用 improve-codebase-architecture
  • 调试特定故障 → 使用 debugging

放大视角会生成什么

结构图，展示：

  • 相关区域内的所有模块
  • 调用关系（谁调用谁）
  • 关键依赖关系（什么依赖什么）
  • 应用于模块名称的 CONTEXT.md 领域词汇

使用方法

遇到不熟悉的代码时，先请求放大视角，再深入查看：

“放大视角，概述 [module/component] 在系统中的整体作用。”

响应会使用项目的领域术语表来绘制相关模块地图，而非使用内部实现名称。

输出格式

[Module A] → calls → [Module B], [Module C]
[Module B] ← called by → [Module A], [Module D]

Key seams:
- [Interface X] separates [Domain Concept 1] from [Domain Concept 2]
- [Interface Y] is where [Domain Concept 3] behavior can be swapped

Domain terms in use here:
- "Order" = [what it means in this context]
- "Customer" = [what it means in this context]

调用说明

此技能设置了 disable-model-invocation: true — 它是一套指示 Agent 如何响应的指导框架，而非独立的处理单元。探索代码时，应将其作为行为指令调用。

指令

  1. 确定任务触发条件和预期输出。
  2. 从上到下遵循此技能中的工作流步骤。
  3. 在进入下一步前验证输出。
  4. 如果任何步骤失败，记录阻碍因素和备用方案。

示例

  • 示例：先将此技能应用于小范围，验证通过后再扩展到完整范围。

最佳实践

  • 保持输出确定且可审计。
  • 优先进行小规模、可逆的修改，避免大范围高风险编辑。
  • 明确记录假设。

参考资料

  • 项目标准：.agent-skills/skill-standardization/SKILL.md
  • 验证器脚本：.agent-skills/skill-standardization/scripts/validate_skill.sh

评论

支持 Markdown