# github-learn

个人知识学习与 agent workflow 实验仓库。

## 当前核心内容

| 路径 | 作用 |
| --- | --- |
| `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 创建、设计文档、历史文档与验证沙箱 |

## 上下文入口

- 领域词汇表真理源：`devflow/glossary/CONTEXT.md`
- 根目录 `CONTEXT.md` 仅保留兼容性重定向。

## 历史内容

- `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 时生成的锁文件。