前置审计 aliez656/pre-optimization-audit

pre-optimization-audit

让 AI 把任务做得更深入，而不是更广。

一个通用的 Agent Skill：用户要求「深入优化」时，先做四道前置审计，再动手改。
不是 DSH 专属——任何支持 SKILL.md 约定的 agent 都能用（DSH / Claude Code / Cursor / Codex …）。

🌐 English

它解决什么问题

大多数「优化一下」的请求，模型会直接改写——把话说得更漂亮、结构排得更整齐。但真正值钱的优化通常不在措辞层，而在：

- 这个题目本身该不该这么做
- 用户给的是一手材料还是三手转述
- 改完凭什么说它变好了（不是"看起来更好"）

这个 skill 强制在动手前回答四个问题，把优化从「改写」拉回「判断」。

四道审计

| 代号 | 问题 | 产物 |
| A | 专家会做哪些用户没要求的事？ | 指出该质疑的前提、反常/矛盾/负结果、是否是"换材料做的模仿性研究" |
| B | 原始素材是第几手？ | 判定一手/二手/三手；列出一手素材应是什么；指出转述中最可能丢失的三类信息 |
| C | 用哪些相互独立的方法验证？ | 至少两种，不能是"再读一遍""再想一次" |
| D | 除了用户和 agent，什么能证明正确？ | 至少一个落在对话之外、不受双方偏好影响的证据源；找不到就标注"只能视为提案" |

然后才是 Phase 1：优化——方向必须由审计结论驱动，产出要附证据锚点；如果审计结论和用户的修改建议冲突，先指出冲突并给选项，不静默服从。

安装

通用位置（推荐，多数 agent 都读）

git clone https://github.com/aliez656/pre-optimization-audit.git \
~/.agents/skills/pre-optimization-audit

~/.agents/skills/ 是 Agent Skills 的通用用户级目录。DSH 原生读它；Claude Code / Cursor 等项目级也可以放到各自目录。

DSH

用户级（所有工作区可见）
git clone https://github.com/aliez656/pre-optimization-audit.git
"$env:USERPROFILE\.agents\skills\pre-optimization-audit"

或工作区级：<你的项目>\.dsh\skills\pre-optimization-audit\

DSH 是热加载——放进去即生效，不用重启。

Claude Code

git clone https://github.com/aliez656/pre-optimization-audit.git \
~/.claude/skills/pre-optimization-audit

其他宿主

把整个目录放到该宿主的 skills 根下，目录名保持 pre-optimization-audit，其中必须有 SKILL.md。

用法

满足触发条件时自动生效（宿主的 description 匹配机制决定），也可以直接点名：

用 pre-optimization-audit 审一下这段，然后深入优化

触发的说法（必须带方向限定）

| 说法 | 触发 |
| 「深入优化」 | ✅ |
| 「在这个方向优化」 | ✅ |
| 「深入改进 / 再改一版」 | ✅ |
| 「按这个方向重做」 | ✅ |
| 「优化一下」 | ❌ 直接改 |
| 「改进一下」「提升一下」 | ❌ 直接改 |

设计如此：只有带方向限定的优化才值得花审计成本。泛泛的「优化一下」直接改，不打扰。

输出格式

AUDIT
A. …（3–5 句） B. …（3–5 句） C. …（3–5 句） D. …（3–5 句）

REVISION
…（优化后的正文）证据锚点：<这一版哪个判断来自哪条审计结论>

如果审计发现题目本身要重写，只输出 REWRITE PROPOSAL，不出 REVISION。

设计取舍（诚实说明）

它不保证效果。这个 skill 的价值在于强制暴露判断过程，不是保证审计结论一定正确。

已知局限：

- 四道题的回答质量取决于模型自身的领域知识——它不知道的领域，A 题会答得很空
- 「独立验证方法」在纯文本任务里很难真正独立（C 题最容易流于形式）
- D 题的"外部证据源"在纯写作/纯分析任务里经常找不到——这时它会如实标注"只能视为提案"，而不是编一个
- 审计会增加 30–60% 的 token 开销，所以触发条件刻意收窄了

不适合：从零生成新内容、纯格式调整、用户已明确指定改哪一句的场景。

文件结构

pre-optimization-audit/
├── SKILL.md # 技能本体（agent 读这个） ├── README.md # 人读这个 └── LICENSE # MIT

License

MIT — 见 LICENSE。