lazygophers/cortex-schema

cortex-schema

cortex 项目知识库统一契约, 单一真相源. 覆盖目录结构 / 三模块路径 / 5 级记忆 / frontmatter / 完整样例. lint + extract + agent 全部引用本 skill, 不再复制硬列任何路径或映射.

三模块速查 (中文目录, vault 内部)

| 模块 | 路径 (相对 <root>/) | type | 层级 | | --- | --- | --- | --- | | 项目 | 项目/<host>/<owner>/<repo>/ | project | 仅用户级 | | 领域 | 领域/<area>/<sub>/[<sub2>/]<topic>.md (≥ 2 级) | domain | 双层 | | 脚本 | 脚本/<name>.{sh,py} (vault 内部, 非用户入口) | vault-script | 仅用户级 |

<root> = ~/.cortex/.wiki (全模块) 或 <repo>/.wiki (仅 memory + 领域). 项目/脚本 模块只在用户级. 用户操作入口 CLI 在 ~/.cortex/scripts/ (英文), 与 vault 内 脚本/ (中文) 视觉分离, 禁混用.

5 级记忆速查 (反直觉: 数字越小 = 越抗遗忘)

L4 收件箱
   │ extract
   ▼
L3 短期 ── promote ──▶ L2 中期 ── promote ──▶ L1 长期 ── promote ──▶ L0 核心
  7d                  90d                    365d                   永久 (手动)
   ▲                   ▲                      ▲
   └── demote 7d ──────┴── demote 90d ────────┴── demote 365d

L1=长期 / L3=短期, 数字与时长反向. 路径后缀 (core/long/mid/short/inbox) 强制内嵌语义防反写.

何时读哪个 reference

| 任务 | 文件 | | --- | --- | | 查 ~/.cortex 顶层物理布局 / 双层差异 / 必备目录 / 开放扩展 / 详细 ASCII | references/topology.md | | 查三模块 (项目/领域/脚本) 路径规则 + 命名 + frontmatter | references/knowledge-modules.md | | 查 5 级记忆 (L0-L4) 语义 / 映射 / 反写防呆 / 遗忘曲线 / 三轴 / 路由 | references/memory-levels.md | | 查 frontmatter 通用字段表 | templates/_fields.md | | 查各 type / 变体 frontmatter 块模板 | templates/{memory,project}/<variant>.md 或 templates/{domain,vault-script}.md | | 查完整 .md 样例 (含正文 + wikilink) | examples/<type>.md |

引用

• lint 规则集 (R1-R7, 含路径/同构/level/入口脚本): cortex-lint
• extract 路由 (L4 → L0/L1/L2/L3 判定): cortex-extract