Reorganize workspace and archive skill artifacts

devflow/glossary/CONTEXT.md

@@ -0,0 +1,41 @@
+# CONTEXT.md — github-learn
+
+本文件是 github-learn 项目的领域词汇表（glossary only）。不含实现细节、不含规格说明。
+
+## 核心术语
+
+### 知识条目 (Knowledge Entry)
+一个知识条目是 `/knowledge-absorber` 技能的单次输出结果，以 `knowledge_YYYYMMDD_Title/` 命名目录，放置于 `knowledge/entries/`。每个条目内含一对同名的 `.md`（Markdown 源码）和 `.html`（渲染后页面）文件。
+
+### 索引面板 (Index Panel)
+`knowledge-index.html`——项目根目录下的纯静态 HTML 文件。由 `scripts/update-knowledge-index.sh` 生成。负责汇总所有知识条目并提供搜索和标签导航。
+
+### 知识吸收器 (Knowledge Absorber)
+全局 skill，位于 `~/.claude/skills/knowledge-absorber/`。接收 URL 或文档，输出知识条目。
+
+### 真理源 (Source of Truth)
+- **日期**和**短标识符 (slug)**：由目录名 `knowledge_YYYYMMDD_Slug/` 提取。
+- **显示标题**、**tags**、**author**：由 YAML frontmatter 提取。
+详见 [ADR-001](./adr/0001-directory-name-as-truth-source.md)。
+
+### 短标识符 (Slug)
+目录名中 `YYYYMMDD_` 之后的部分。用于脚本定位目录和构建文件路径。不用于显示（显示标题来自 YAML frontmatter 的 `title` 字段）。
+### 年份筛选 (Year Filter)
+索引面板中的全局过滤器。年份来自知识条目的 `date` 字段前四位，即目录名 `knowledge/entries/knowledge_YYYYMMDD_Slug/` 中的 `YYYY`。年份筛选与搜索、标签筛选取交集；选择“全部年份”表示不启用年份过滤。
+
+## 目录约定
+
+```
+github-learn/
+├── knowledge/
+│   └── entries/
+│       └── knowledge_YYYYMMDD_Title/ # 知识条目（0-N 个）
+│           ├── knowledge_YYYYMMDD_Title.md
+│           └── knowledge_YYYYMMDD_Title.html
+├── knowledge-index.html          # 索引面板（由脚本生成）
+├── scripts/
+│   └── update-knowledge-index.sh # 索引重建脚本
+├── openspec/                     # OpenSpec 当前变更和归档
+├── devflow/                      # 人类可读工作流档案
+└── skill-workbench/              # skill 生成、历史文档和验证沙箱
+