skills: v0.5.0 slim architecture — 3-skill family with validation

/explore (4 Phase), /essence (lens-driven deep dive), /follow (report-dependent guided learning). Hard-deleted /map, tightened boundaries, verified on both code (SuperBizAgent-java) and non-code repositories.
2026-04-30 11:29:12 +08:00
commit 785216c0bb
10 changed files with 1167 additions and 0 deletions
@@ -0,0 +1,136 @@
+# 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 存档最终结构
+
+```
+docs/superpowers/
+├── specs/
+│   ├── issue.md                                    # 原始需求
+│   ├── 2026-04-21-skills-v0.5.0-slim-architecture-design.md
+│   └── 2026-04-21-skills-v0.5.0-changelog-design.md
+└── changelog/
+    ├── 2026-04-21-skills-v0.5.0-slim-architecture.md   # 第一次改造 changelog
+    ├── 2026-04-21-skills-v0.5.0-validation-handoff.txt # 交接指令
+    └── 2026-04-30-skills-v0.5.0-consolidation.md       # 本次整合（本文件）
+```
+
+---
+
+## 当前 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 已同步 |
+
+**总体验收结论：通过。** 文档、边界、行为三者一致。