improve 模式 · 结构优化

一句话钩子："建议加强"不是改进——"把 X 文件第 3 节的 Y 删掉换成 Z"才是改进。

对已有方案、已完成的交付物或现有流程进行分析，提出按杠杆率排序的改进清单。本模式只审查不修改——输出改进清单后让用户决定是否采纳。

核心定位

7 类常见改进点（按杠杆率排序，最多 7 个）：

详见 references/seven-leverage-points.md。

工作流

步骤 1：识别当前方案中的问题

按 7 类清单逐项扫描：

• 瓶颈：哪里卡住？
• 冗余：哪里重复 / 可合并？
• 不一致：哪里互相矛盾？
• 缺失：哪里应该有但没有？

步骤 2：按杠杆率排序改进点

改进清单 ≤ 7 个，按影响最大的先说。

步骤 3：给出具体改进动作

每条动作必须满足 SMART（详见 references/smart-criteria.md）：

• Specific：不说"加强文档"，说"在 SKILL.md 第 3 节加触发场景"
• Measurable：不说"优化一下"，说"字数从 500 减到 300"
• Achievable：不说"完美化"，说"完成 80% 覆盖率"
• Relevant：每个动作必须对应一个具体问题
• Time-bound：说"今天做"或"本周内做"

步骤 4：标注成本与风险

每个改进动作要标：

• 实施成本：X 天 / Y 小时
• 预期收益：高 / 中 / 低
• 风险：可能引入什么问题

输出"改进清单"模板

【改进清单】按杠杆率排序

🔴 P0（必须改）：
1. [问题] → [具体动作] → [成本] → [风险]
2. ...

🟡 P1（应该改）：
1. [问题] → [具体动作] → [成本] → [风险]
2. ...

🟢 P2（建议改）：
1. [问题] → [具体动作] → [成本] → [风险]
2. ...

❌ 暂不改（成本高于收益）：
- [问题 X]：改造成本 Y > 收益 Z

【成本/收益对比】
| 改进点 | 实施成本 | 预期收益 | 优先级 |
|--------|----------|----------|--------|
| 1 | X 天 | 高 | P0 |
| 2 | Y 小时 | 中 | P1 |
| ... |

7 类改进点速查

1. 信息缺口（最高频）

• 没说清目标
• 没定义受众
• 没标注边界
• 没说验收标准
• 改：补目标 / 补受众 / 补边界 / 补验收

2. 流程冗余

• 重复步骤（同一件事做了 2-3 次）
• 不必要的中间环节
• 可合并的小步骤散落各处
• 改：合并同类 / 删装饰 / 重排顺序

3. 触发条件模糊

• 不知道什么时候该用
• 不知道什么时候不该用
• 触发词列表不全或有歧义
• 改：补强触发词 / 补"不触发"边界 / 加 example

4. 输出不可验证

• 没说"做完了长什么样"
• 没有验收标准
• 没有 before/after 对比
• 改：加验收标准 / 加输出模板 / 加 before/after

5. 错误处理缺失

• 出错时不知道怎么办
• 没有 fallback 方案
• 没有"重试 / 跳过 / 终止"决策点
• 改：写明兜底 / 加决策点 / 加 Gotchas 黑名单

6. 维护成本高

• 依赖外部资源（API、平台、账号）
• 依赖容易过时的信息
• 结构混乱，找不到东西
• 改：减外部依赖 / 拆 references/ / 用相对路径

7. 风险点无兜底（最关键）

• 不可逆动作（删除、对外发布、花钱）
• 没有"先确认再执行"机制
• 没有 dry-run / preview
• 改：加"执行前确认" / 加 dry-run / 加"先小范围测试"

Gotchas

❌ 假改进（详见 examples/fake-improve.md）

1. 只说"建议加强"不给动作："建议加强文档的可读性"——用户不知道做什么
2. 改进点超过 7 个：8 个、10 个、20 个改进点 = 你没在排序，在罗列
3. 不标成本/风险："应该用 Redis 替代 MySQL"——没说迁移成本、数据风险
4. 改进点无关核心目标：挑了 7 个"完美主义"改进，但核心目标没解决
5. 直接动手改：improve 模式只审查不修改——不要顺手把方案改了

✅ 完成度判断

输出前问：

"用户拿这份改进清单能直接开干吗？"

• 能 → 完成
• 不能 → 哪一步还缺？回去补
• 拿不准 → 标注"需用户确认 XX 后再开干"

何时读取 references

• 7 类改进点详解（每个改进点的检测动作 + 改进行动）→ references/seven-leverage-points.md
• SMART 原则 + 反例对照 → references/smart-criteria.md
• 常见假改进反例（5 个典型反模式 + 修正）→ references/red-flags.md

字数

• SKILL.md 本体：≤ 250 行（当前 ~180 行，达标）
• references/ 拆 3 个文件，按需加载