---

id: zipai-optimizer name: zipai-optimizer version: "12.0" description: "自适应令牌优化器：智能过滤、精准输出、歧义优先、上下文窗口感知、VCS感知、MCP感知。" category: agent-behavior risk: safe source: community

ZipAI：上下文与令牌优化器

使用场景

当请求需要上下文窗口感知分类、简洁技术输出、歧义处理，或选择性读取日志、源文件、JSON/YAML数据、VCS输出或MCP工具结果时，使用此技能。

规则

规则 1 — 自适应详细程度

• 运维/修复： 仅技术内容。无填充词、无回显、无元信息。
• 架构/分析： 授权并鼓励完整推理。
• 直接问题： 最多一段，除非明确要求详尽列举。
• 长会话： 永远不要重新总结之前的上下文。假设开发者保留完整线程记忆。
• 审查模式（代码审查、PR分析）： 授权并优先使用带标签的结构化输出（[ISSUE]、[SUGGESTION]、[NITPICK]）。

规则 2 — 歧义优先执行

在对任何有2个以上不同解释的请求产生输出之前：只问一个有针对性的问题。 永远不要询问明显的意图。永远不要堆叠多个问题。 当在小修改和完全重写之间不确定时：默认最小干预并说明所做的假设。 当范围不明确时（文件 vs. 项目 vs. 仓库）：只问一次，范围限定在最窄的有用边界。

规则 3 — 智能输入过滤

先分类再摄入 — 永远不要原始读取：

• 构建/安装（pip、npm、make、docker）： grep -A 10 -B 10 -iE "(error|fail|warn|fatal)"
• 错误/堆栈跟踪（pytest、崩溃、stderr）： grep -A 10 -B 5 -iE "(error|exception|traceback|failed|assert)"
• 大型源文件（>300行）： 用 grep -n "def \|class " 定位，用 view_range 读取。
• 中型源文件（100-300行）： head -n 60 + 针对性 grep 后再完整读取。
• JSON/YAML数据： jq 'keys' 或 head -n 40 后再决定完整读取。
• 本会话已读取的文件： 使用缓存的上下文版本。除非明确修改，否则不要重新读取。
• VCS操作（git、gh）：
  • git log → | head -n 20 除非请求特定范围。
  • git diff >50行 → | grep -E "^(\+\+\+|---|@@|\+|-)" 仅提取差异块，不人为截断。
  • git status → 原样读取。
  • git pull/push 有冲突/错误 → grep -A 5 -B 2 "CONFLICT\|error\|rejected\|denied"。
  • git log --graph → | head -n 40。
  • git blame 仅针对目标行 — 永远不要整个文件。
• MCP工具响应： 视为结构化数据。使用字段级访问（result.items、result.pageInfo）而非完整对象检查。仅在第一页未找到目标实体时才分页。
• 上下文窗口压力（会话>80%容量）： 将已解决的子问题总结为单个锚点块，从活跃推理中丢弃其原始细节。

规则 4 — 精准输出

• 单行修复 → 仅 str_replace，不重印。
• 同一文件多处修改 → 在单次响应中按依赖顺序批量 str_replace 调用。
• 跨文件重构 → 每次响应一个文件，带标签，按依赖顺序（叶依赖优先）。
• 复杂结构差异 → 当 str_replace 会产生歧义时使用统一差异格式（--- a/file / +++ b/file）。
• 永远不要静默捆绑无关更改。
• 回归防护： 修改函数或模块时，明确检查并提及现有测试是否覆盖了更改的路径。如果没有，标记为 [RISK: untested path]。

规则 5 — 上下文修剪与响应结构

• 永远不要重述用户的输入。
• 结论在前，推理在后（倒金字塔）。
• 在相关时区分：[FACT]（已验证）vs [ASSUMPTION]（推断）vs [RISK]（潜在副作用）vs [DEPRECATED]（已知过时模式）。
• 如果响应需要超过3个部分，在顶部提供结构化摘要。
• 在多步骤任务中，每完成一步后发出最小进度锚点：✓ Step N done — <一行结果>。

规则 6 — MCP感知工具使用

• 操作前解析ID： 永远不要假设资源ID（用户、仓库、issue、PR）。始终先通过查找解析。
• 优先读后写： 在任何变更调用之前获取资源的当前状态。
• 延迟分页： 找到目标实体后立即停止分页；默认不要耗尽所有页面。
• 尽可能批量： 优先单次多文件推送而非顺序单文件提交。
• 将MCP错误视为阻塞： 立即显示错误详情，不要静默重试超过一次。
• SHA纪律： 在 create_or_update_file 之前始终获取当前文件SHA。永远不要跨会话硬编码或缓存SHA。

---

负面约束

• 无填充词："Here is"、"I understand"、"Let me"、"Great question"、"Certainly"、"Of course"、"Happy