ai-efficiency

AI Efficiency · 高效执行 & 省 Token 清单

使用本 skill 的场景：

• 任务规模 ≥ 3 个文件 / ≥ 50 行改动
• 多轮对话已经在 6 轮以上还没完成
• 用户/团队明确关心 token 成本

与 assets/spec/AI_EFFICIENCY.md 是「契约 / 执行」对应关系——契约写规则，本 skill 是把规则翻译成当下就能照做的清单。

---

Phase 0 · 入场 30 秒自检

1. 是不是 3 步以内的小事？是 → 直接做，不要拉 skill 链。
2. 是不是已经有 plan？没有 → 先 writing-plans 出最小计划，再动手。
3. 是不是跨 ≥ 3 文件 / 跨模块？是 → 委派 subagent。
4. 是不是已经发生过 ≥ 6 轮往返且没收敛？是 → 中止，回到 §6 模式切换。

---

Phase 1 · 检索（找到正确的几个位置）

1.1 工具优先级

Grep "确切字符串" > Glob "src/path/**/*.ts" > SemanticSearch "意图问句" > Read 全文

1.2 一次问对，少问多次

反模式	正确做法
Grep "user" （命中数百）	Grep "class UserService " --type ts
在 monorepo 找东西	Grep ... --path packages/api/src
不知道命中多少	先用 output_mode: "count" 看一次

1.3 并行批发

独立的 3 个 Grep / Read，一次性发出去：

batch:
  Grep "patternA"
  Grep "patternB"
  Glob "src/**/types.ts"

---

Phase 2 · 阅读（用最少 token 拿到上下文）

2.1 切片不全读

小文件 < 200 行：直接 Read
中文件 200-800 行：Read offset/limit，分 2-3 段
大文件 > 800 行：先 Grep 定位，再 Read offset/limit

2.2 不重复粘贴

如果 L0（spec / rule）/ L1（项目配置）已经被加载过，不要在回复里复制其中段落。指向资源 URI 即可。

2.3 摘要替代原文

读完后用 1-2 句给主会话摘要，不要把原文塞回。

---

Phase 3 · 修改（让改动安全 & 可被 cache）

3.1 StrReplace 优先于重写

• 改 ≤ 3 处 → 用 StrReplace
• 改 ≥ 整个函数 / 重大重构 → 用 Write 重写单个文件
• 跨文件大改 → 拆成 N 次 StrReplace，每次原子

3.2 一次改一个语义单元

反模式：一个 StrReplace 把 Class A 拆成 A + B + C 三个文件
正确  ：先 StrReplace 抽出 A 的接口；再 Write 新增 B；再 StrReplace 让 C 引用

每步都让代码处于可编译态，便于回退。

3.3 改完立刻验证

StrReplace → ReadLints → npm test --run （仅本文件相关测试） → 下一步

不要堆 10 个改动一起 commit，回滚成本巨大。

---

Phase 4 · 验证（最少跑测试拿到 PASS 证据）

4.1 跑被影响的子集

反模式	正确做法
每次都 npm test 全量	npm test -- --runRelatedTests src/foo.ts
Java 跑全模块	mvn -pl module-x test
Python pytest 全	pytest tests/test_foo.py -q

4.2 只在最后做 harness check --strict --run-tests

任务收尾时一次全局门禁，不要每改一行跑一次。

4.3 失败 → root cause first

测试红了优先用 systematic-debugging skill 找根因，而不是「让我再调一下看看」式打补丁。