Reorganize workspace and archive skill artifacts

README.md

@@ -1,21 +1,33 @@
-# Explore Skill Family
+# github-learn
 
-一组 Claude Code 学习型技能，帮助开发者系统性地理解和学习代码仓库或知识仓库。
+个人知识学习与 agent workflow 实验仓库。
 
-## 技能
+## 当前核心内容
 
-| 技能 | 用途 | 触发 |
-|---|---|---|
-| `/explore` | 项目级理解与上手路径 | 第一次接触项目，需要全貌认知 |
-| `/essence` | 核心设计深潜与迁移 | 抓住最值得学的设计，拆解到可迁移 |
-| `/follow` | 基于报告的引导式学习 | 已有分析结果，想边做边学 |
+| 路径 | 作用 |
+| --- | --- |
+| `knowledge/entries/knowledge_YYYYMMDD_*/` | 知识条目源文件与渲染 HTML |
+| `knowledge-index.html` | 知识索引页面，由 `scripts/update-knowledge-index.sh` 生成 |
+| `scripts/` | 本仓库维护脚本 |
+| `openspec/` | 当前 OpenSpec 变更工作区与归档 |
+| `devflow/` | 人类可读项目档案、glossary、复合知识 |
+| `.agents/skills/` | Codex/agent 使用的本地运行时 skills，当前重点是 `sm-flow` |
+| `.claude/skills/` | Claude 版本 skills 与 OpenSpec skills |
+| `skill-workbench/` | skill 创建、设计文档、历史文档与验证沙箱 |
 
-## 使用
+## 上下文入口
 
-将 `skills/` 目录安装到 Claude Code 的 skills 目录下即可使用。
+- 领域词汇表真理源：`devflow/glossary/CONTEXT.md`
+- 根目录 `CONTEXT.md` 仅保留兼容性重定向。
 
-工作流：`/explore` → 拿到线索 → `/essence` 深挖设计 → `/follow` 跟学。
+## 历史内容
 
-## 版本
-
-v0.5.0 — 详细变更见 [changelog/](changelog/)
+- `skill-workbench/generated-skills/sm-flow/`：本仓库新增的 `sm-flow` skill 源产物，只放可安装 skill 本体。
+- `skill-workbench/generated-skills/skills/`：早期 Explore Skill Family，只放 skill 本体。
+- `skill-workbench/docs/sm-flow/workflow.md`：`sm-flow` 的设计演进文档。
+- `skill-workbench/docs/explore-essence-follow/latest-design.md`：`explore`、`essence`、`follow` 三个学习型 skill 的最新设计总结。
+- `.agents/skills/sm-flow/`：`sm-flow` 的运行时安装副本，用于当前 Codex 会话加载。
+- `skill-workbench/history/changelog/`：早期 skill family 变更记录。
+- `skill-workbench/history/docs/`：早期设计、OpenSpec 与 agent 文档。
+- `skill-workbench/validation/project/`、`skill-workbench/validation/tmp2/`：验证 skill 时使用的第三方源码和临时报告。
+- `skill-workbench/validation/skills-lock.json`：验证安装 mattpocock skills 时生成的锁文件。