v3.2.1: Phase 0.5.1 强化案例复用(踩坑记录内化为约束+编码时逐条回查),经验法则#11重写

This commit is contained in:
白夜
2026-04-19 17:41:44 +08:00
parent 59e52c5490
commit a568c7de86
+16 -9
View File
@@ -221,16 +221,22 @@ AI 输出格式(必须以此结构复述并填空):
#### 0.5.1 命中某个 case 的行为
```
readFile("cases/<命中的 case>.md") # 读取方案方向 + 踩坑记录
readFile("cases/<命中的 case>.md") # 读取方案方向 + 踩坑记录 + 站点风格
案例提供每个 Phase 的加速指引,不替代 Phase:
Phase 1: 仍然执行侦察,用 scripts(action='save') 保存 SDK 脚本到本地 config/
Phase 2: 仍然执行源码分析
Phase 3: 仍然执行动态验证(确认需要补哪些环境项后再写补丁)
Phase 4: 参考案例踩坑记录编码,环境补丁逐项添加逐项验证
Phase 5: 验证
案例的价值是踩坑记录和站点风格,不是可直接运行的代码。
站点会迭代改版,案例代码可能已过期,但踩坑记录不会轻易过期。
⚠️ 命中案例 = 知道终点在哪,不等于跳过路上的步骤
命中案例后的执行要求:
1. 精读案例的「踩坑记录」和「关键经验总结」,内化为本次的约束条件
2. Phase 1-5 仍然正常走,用当前环境的实际数据驱动实现
3. Phase 4 编码时,每个实现决策回查案例踩坑记录,确认是否有对应的坑要避开
4. Phase 5 结束后,将本次新发现的踩坑点追加到案例
反模式:
❌ 读了案例 → 只提取方案方向 → 关掉案例 → 自己从零实现 → 踩坑记录里的坑全部重踩
✅ 读了案例 → 踩坑记录内化为约束 → 每步实现时回查 → 遇到问题先查案例再调试
⚠️ 命中案例 = 知道前人踩过哪些坑,不等于有现成可用的代码,也不等于跳过分析流程
```
#### 0.5.2 未命中任何 case 的行为
@@ -309,7 +315,7 @@ search_code(keyword="acw_sc__v2") # Aliyun WAF
8. **case 中的"可验证事实清单"是经验资产**:在 case 文件列出最小可验证事实,下次同站升级时逐条手动核对找出"哪些变了"
9. **verify_signer_offline 是协议代码的 unit test**:用 N 个真实样本离线验证,字符级定位首偏差点;每次改完代码先跑一次,别请真服务端猜
10. **想放弃时先回查 cases/ 和 common-pitfalls.md**:绝大多数"想放弃"的场景,是踩了已知反模式或漏读了相似 case
11. **命中案例不等于跳过分析流程**:案例提供方案方向和踩坑经验,Phase 1-5 仍然正常走,SDK 脚本仍要保存到本地,环境补丁仍要逐项验证后再添加
11. **命中案例后必须精读踩坑记录并内化为约束**:案例的核心价值是踩坑记录和站点风格,不是代码。Phase 1-5 仍然正常走,但 Phase 4 编码时每个实现决策必须回查案例踩坑记录。禁止只提取方案方向就关掉案例自己写
---
@@ -397,6 +403,7 @@ search_code(keyword="acw_sc__v2") # Aliyun WAF
| 版本 | 日期 | 要点 |
|------|------|------|
| v3.2.1 | 2026-04-19 | Phase 0.5.1 强化案例复用策略(精读踩坑记录内化为约束,编码时逐条回查);经验法则第 11 条重写(明确命中案例不等于有代码) |
| v3.2.0 | 2026-04-18 | 移除 MCP session 依赖:Checklist 从五项压缩到三项,删除 domain-session-guide.md,cases/ 成为唯一经验库,verify_signer_offline 替代 verify_against_session |
| v3.1.0 | 2026-04-18 | SKILL.md 瘦身,references/ 拆分 5 个新子文档;工具引用对齐 MCP 合并 API |
| v3.0.0 | 2026-04-18 | 硬约束 Checklist + 红线四条 + 经验法则压缩 46→30 + common-pitfalls.md |