AGENT SKILL

speed-up-perf

调查或优化本插件性能时使用——每条用户消息的快照开销(win32 上 spawn pwsh/git 尤其贵)、串行队列吞吐、启动预热、gc 节拍、大工作区 diff/rollback、client 快照树渲染;用户说「让它更快」「这里好慢」时适用,把抱怨变成可复现的测量与小步、保行为的修复。

License 许可
MIT
最近更新
2026-11-06
Stars
★ 55
Forks
7

01 前言 Front Matter

name
speed-up-perf
description
调查或优化本插件性能时使用——每条用户消息的快照开销(win32 上 spawn pwsh/git 尤其贵)、串行队列吞吐、启动预热、gc 节拍、大工作区 diff/rollback、client 快照树渲染;用户说「让它更快」「这里好慢」时适用,把抱怨变成可复现的测量与小步、保行为的修复。

03 SKILL.md 正文

dsh-recall-plugin 性能优化

把宽泛的「让它更快」转成可复现的用户路径测量,和小步、有证据、保行为的修复。这是指导,不是配额也不是脚本。

本项目的性能面

优化前先确认这些事实未被推翻:

  • 每条用户消息一次快照:runShell spawn pwsh(win32)或 bash(POSIX)跑 add/write-tree/commit-tree/tag。进程创建是主成本,win32 的 spawn 代价比 ubuntu 高一个量级——两端分别测,ubuntu 的数字不能外推 Windows。
  • 串行队列:preview/execute/快照/gc 同一条队列,延迟优化不能以乱序为代价。
  • 启动预热与 ensureGit、store 心跳(M3)在会话开始时的固定开销。
  • gc 节拍(50 拍或 24h)与「立即 gc」的逐仓枚举,大 store 下的耗时。
  • 大工作区:add 全量扫盘、diff、rollback 随文件数/体积的缩放;排除表是已有的减负机制。
  • client:快照管理的版本家族树在快照多时的渲染与搜索。

先测量,再排序

  • 为每个候选写测量卡片:操作、负载、入口路径、时钟取法、判定指标、必须保住的行为。
  • 广泛调研用户路径(发消息快照、撤回全链、打开快照管理、启动预热),变化独立的成本驱动因素(文件数、快照数、工作区体积),按实测延迟/内存 × 频率 × 置信度排序。只凭「这段代码看起来慢」下结论的,拒绝。
  • 「实测」是承重词:测量结论写成 (实测:512 层 ≈ 0.15s) 这类带出处的边界,它在校准常量与注释里受保留规则保护(见 trim-cot-leakage 的「什么不是泄漏」)。

真实的合成基准

  • 固定生成输入:脚本化的 fixture 工作区(文件数/体积分级),不是随手找的目录。
  • 测构建产物 lib/ 里的行为,不是 src/——用户跑的是产物。
  • 阈值先校准再当门禁:在目标平台上量出基线分布,阈值留实测余量;拍脑袋的数字会让 CI 性能门禁变成 flake 发生器(其可靠性归 ci-test-reliability)。
  • 端到端延迟与驻留内存分开测、分开判定。

先证明回归,再移除工作

  • 改动前先在未优化的实现上跑出负载数字并留档——没有「之前的数字」的优化 PR 不可审查。
  • 把失败场景最小化,对可证伪的假设排序,一次只改一个因果因素。
  • 负面对照:收紧后的断言或新基准,在原实现上必须按预期失败。

保行为与所有权

性能证据不能取代功能证据。以下语义优先级高于速度,动了它们需要的不只是基准:

  • 快照正确性:add 的排除语义、write-tree 内容、tag 主键与索引可重建性;
  • 原子性:index.json/lineage.json 的 tmp+rename、损坏 fail-loud 隔离;
  • 顺序:串行队列、救援回滚(H1)、intent journal 的三针时序;
  • 可达性:任何缓存、并行化、跳过快照的优化,必须证明不让 blob 在 gc 下丢失(issue #18 的反面教材就在那里)。

解释不清为什么变快的优化,明确拒绝并留一行记录。

有界交付

  • 一次优化一个有界目标,数字按「负载 → 前后数值 → 内存语义 → 行为证据 → 负面对照 → 排除项」总结,写进计划记录或注释。
  • 验证按改动面跑 pre-push-checks 的矩阵;声称的性能结论必须附实际跑过的命令与平台。

04 同仓库更多 Skills

limbo947
limbo947/dsh-recall-plugin

trim-cot-leakage

审计或修复「读起来像泄漏推理转录」的散文时使用——死设计会话引用((decision 7)、审计项代码、未提交草稿的 §N)、变更叙述(「以前」「不再」「本版」)、栈/审阅视角(「本栈的后一个 PR」「评审中被拒」)、对审查者说理的辩护、控制流叙述与注释、JSDoc、文档、计划记录里的规划残留;用户说「清理 CoT 泄漏」「审计文档措辞」时适用。

★ 55
limbo947
limbo947/dsh-recall-plugin

tdd

测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。

★ 55
limbo947
limbo947/dsh-recall-plugin

research

对照高可信一手来源调研问题,并把发现保存为仓库中的 Markdown 文件。适用于用户想调研主题、收集文档或 API 事实,或把阅读工作委托给后台代理时。

★ 55
limbo947
limbo947/dsh-recall-plugin

prose-standard

撰写、审查、精简或审计本仓库的文字时使用——Markdown 文档与 README、注释与 JSDoc、配置说明、诊断文案、client UI 字符串;用户说「润色文档」「审查 README」「这段文案行不行」时适用。拥有文档结构、行文规则与文档质量判据。

★ 55
limbo947
limbo947/dsh-recall-plugin

pre-push-checks

git push、打 tag、发 npm 包或声称「检查通过」之前使用——按外发 diff 的改动面选最小检查集而非条件反射跑全量;test:probe 与 verify:host 不进 CI,发布前必须在本地跑过。

★ 55
limbo947
limbo947/dsh-recall-plugin

grilling

围绕计划、decision 或 idea 持续追问用户。适用于用户想对自己的思路做压力测试,或使用任何 “grill” 触发措辞时。

★ 55