Skills v0.5.0 整合修复记录
日期： 2026-04-30
来源： grill-me 逐项审查，基于 v0.5.0 changelog 和 design doc 对比实际实现发现的不一致
一句话摘要
在前次 v0.5.0 slim architecture 改造的基础上，逐文件对比 design doc、proposal、plan、实际实现，修复了 /essence 遗漏项、/follow 旧引用残留、/explore 阶段冗余、references 死文件、docs 目录垃圾等问题。
已完成的改动
1. /essence — 补齐 v0.5.0 改造（之前遗漏）
| 位置 |
修改内容 |
| 版本号 |
0.3.0 → 0.5.0 |
| 透镜定义 |
删除 (borrowed from /explore)，声明为 /essence 自有 |
| 透镜相关 Phase 2/3/4/5 表格 |
从独立 3 列表格瘦身为内联 bullet point |
| HTML Card |
## Phase 6: Output (Optional HTML Card) → ## Optional: HTML Card；去 "production-critical" 条件，改为 Only when the user explicitly requests it |
| HTML Card 死链接 |
删除 Same as /explore. 两处，改为自包含内容 |
| Mode Selection 上下文感知 |
新增检测逻辑：来自 /explore → 默认 User-directed；独立启动 → 默认 Auto-detect |
| Auto-detect 信号 |
Most imported file → Cross-module contract（后端项目更准确） |
2. /follow — 消除旧引用和设计偏差
| 位置 |
修改内容 |
| Mode Selection |
新增前置报告感知：来自 /explore + 代码仓库 → Runnable；来自 /explore + 非代码 → Reader；来自 /essence → Reader |
| Runnable Check |
删除重新扫描逻辑，改为从前置报告读取结论；运行时信号改为后端导向（go.mod, pyproject.toml, Cargo.toml, Makefile 等） |
| Reader Mode Flow |
从文件级 "Walk one core file" 提升为设计级 "Frame the learning goal around a core design" |
| 教学规则 |
do not use "go read the code" as the default instruction without context → never say "go read the code" as a standalone instruction；引用代码必须先交代设计上下文 |
3. /explore — 合并冗余阶段
| 位置 |
修改内容 |
| Phase 1+2 |
Phase 1: Positioning + Phase 2: Structure 合并为 Phase 1: Positioning & Structure |
| 阶段总数 |
5 Phase → 4 Phase |
| Project Type Detection |
信号列表同步（package.json 不再为首例）；阶段跳过的编号更新 |
| Outcome 模板 |
5/5 → 4/4 |
4. References 清理
| 文件 |
操作 |
skills/explore/references/deep-fission.md |
删除 — 描述已移除的 Deep Fission 功能，引用不存在的 /fission 技能 |
skills/essence/references/essence-signals.md |
Most imported file → Cross-module contract，与 SKILL.md 同步 |
5. docs 存档清理
| 文件 |
操作 |
原因 |
docs/superpowers/proposal.md |
删除 |
原始 4-skill 提案，已过时 |
docs/superpowers/plan.md |
删除 |
实施模板与实际实现不一致 |
docs/superpowers/plans/ |
删除 |
456 行 task-by-task 计划，含 /map 引用 |
docs/superpowers/README.md |
删除 |
superpowers/README.md 的副本，不属于历史存档 |
docs 存档最终结构
当前 skill 状态
| 技能 |
版本 |
Phase/Mode |
备注 |
/explore |
v0.5.0 |
4 Phase |
支持代码/非代码仓库；合并 Positioning+Structure |
/essence |
v0.5.0 |
5 Phase + Optional HTML |
透镜自有；上下文感知 Mode Selection |
/follow |
v0.5.0 |
Runnable / Reader |
来源感知；不再重新扫描项目 |
实践验证结果
日期： 2026-04-30
测试目标仓库：
- 非代码仓库：explore-skill-family（自身）
- 代码仓库：SuperBizAgent-java（Spring Boot + AI Agent）
| # |
验证路径 |
目标 |
结果 |
| 1 |
/follow 拒绝无前置报告 |
直接模拟 |
✅ |
| 2 |
/explore 非代码仓库 |
自身 skill family |
✅ — 正确识别 skill-docs，跳过 Flow/Start |
| 3 |
/essence 深挖 |
"硬边界"设计 |
✅ — 结论-证据-解释，可迁移 |
| 4 |
/explore → /follow |
自身 |
✅ — Reader 分流，引用报告内容 |
| 5 |
/essence → /follow |
自身 |
✅ — design-focused，未重扫 |
| 6 |
三技能职责边界 |
综合矩阵检查 |
✅ — 核心问题/深度/前置依赖/产出均无重叠 |
| 7 |
/explore 代码仓库 |
SuperBizAgent-java |
✅ — 4 Phase 全流程，后端信号检测正常 |
验证发现的额外修复
验证过程中对 SKILL.md 的追加修改（已在代码中反映）：
/essence Phase 6 → Optional: HTML Card/essence Mode Selection 上下文感知/essence Most imported file → Cross-module contract/follow Mode Selection 来源感知/follow Runnable Check 不再重扫，引用前置报告/follow Reader Mode Flow 提升到设计层/follow Teaching Interaction Rules 收紧/explore Phase 1+2 合并，5→4 Phase/explore Project Type Detection 信号改为后端导向- 删除
skills/explore/references/deep-fission.md
handoff 10 条检查清单逐项结论
| # |
问题 |
结论 |
| 1 |
/explore 对代码/非代码给出不同输出？ |
✅ Phase 2/3 对非代码跳过 |
| 2 |
/explore 保持在项目级理解？ |
✅ Phase 4 概览深度 |
| 3 |
/essence 稳定找最高价值设计？ |
✅ "硬边界"提取到 pattern 层 |
| 4 |
/follow 无前置报告明确拒绝？ |
✅ 拒绝并引导 |
| 5 |
/follow 基于 /explore 或 /essence 结果？ |
✅ 两次测试均基于前置报告 |
| 6 |
/follow 避免重新扫描？ |
✅ 三次验证均未重扫 |
| 7 |
/follow 真正引导式教学？ |
✅ 先问后讲 |
| 8 |
三技能职责重叠/模糊？ |
✅ 边界清晰 |
| 9 |
README 与实际行为一致？ |
✅ 三技能描述与 SKILL.md 一致 |
| 10 |
references 与 v0.5.0 一致？ |
✅ deep-fission 已删，signals 已同步 |
总体验收结论：通过。 文档、边界、行为三者一致。
zhuyongxin
785216c0bb