lazygophers/cortex-memory
plugins/tools/cortex/skills/cortex-memory/SKILL.md
记忆生命周期管理 — 自动维护 (晋级候选扫 / forget 标记 / 弱条目补充 / weight bump / uri-index 整理) + URI 寻址 CRUD 子命令。无入参跑全量维护; 有 verb 走 CRUD。Triggers on "整理记忆", "维护记忆", "记忆体检", "memory maintain", "记忆写入", "memory write/read/update/delete", "forget", "遗忘".
$ install --global
skillsauthnpx skillsauth add lazygophers/ccplugin cortex-memoryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 7:30 AM186.4s4 files scanned
SKILL.md
- name:
- cortex-memory
- description:
- 记忆生命周期管理 — 自动维护 (晋级候选扫 / forget 标记 / 弱条目补充 / weight bump / uri-index 整理) + URI 寻址 CRUD 子命令。无入参跑全量维护; 有 verb 走 CRUD。Triggers on "整理记忆", "维护记忆", "记忆体检", "memory maintain", "记忆写入", "memory write/read/update/delete", "forget", "遗忘".
- disable-model-invocation:
- false
- allowed-tools:
- Bash Read Write Edit Glob mcp__obsidian__obsidian_get_file_contents mcp__obsidian__obsidian_list_files_in_dir mcp__obsidian__obsidian_append_content
cortex-memory
[AUTO_MODE persistent: 禁询问, 自决执行, 禁中止]
记忆生命周期管理 — 默认跑维护扫 (非破坏); 有显式 verb 才降级到 CRUD。可独立调用, 也由 cortex-digest 阶段 4 委派。
触发场景
- 用户显式 "整理记忆" / "维护记忆" / "记忆体检" / "memory maintain" /
/cortex:memory无参 → 跑维护 - 用户/AI 显式 CRUD: "记一条" / "memory write/read/update/delete" / "忘了 X" → 走 verb 子命令
cortex-digest阶段 4 委派 → 跑维护 (其内联 promote-candidates + forget-marker 子集)- daily cron
memory-promote/memory-forget//cortex:forget→ 等价于跑维护 (子集)
关键决策树
入参为空 / 仅 --vault → 维护扫 (默认)
入参含 verb=read|write|update|delete → CRUD (走 crud-operations.md)
维护扫 5 阶段 (默认)
- 整理 —
~/.cortex/scripts/ledger.sh uri_index_rebuild重建_meta/uri-index.json; 校验 frontmatter (level/uri/weight/last_recalled 完整 + URI 全局唯一) - 升级候选扫 — 扫
记忆/L3-短期/episodic/+记忆/L2-中期/semantic/:- L4 ledger freq ≥ 3 → 自动 L4→L3 (非候选, 直接晋)
- L3 freq ≥ 5 + timespan ≥ 3 天 → L3→L2 候选
- L2 freq ≥ 10 + timespan ≥ 30 天 → L2→L1 候选
- L1 freq ≥ X (策略文件定) → L1→L0 候选 (标
needs_user_approval: true) - 落
记忆/views/candidates.md(覆写整页), 不自动晋
- 补充 (enrich) — 弱条目 (weight < 0.3 或 examples=0) 找知识库交叉引用 + 用户最近 sessions 例证, append 到 frontmatter
examples/ body; 不删原内容 - 遗忘标记 (forget marker, 非破坏) — 扫 L2/L3:
- L3:
now - last_recalled > 90 天且recall_count < 3→ frontmatterarchive_pending: true - L2:
now - last_recalled > 365 天且recall_count < 5→ 同上 - 日志 append
记忆/views/alerts.md ## memory-forget <UTC ISO>列 uri 清单 - 不删不移
- L3:
- 评分双路调 — 召回次数 + wikilink 反向引用 →
importance ↑; 用户 "不对/错了" →confidence -= 1.0, "对的" →confidence += 0.5(scripts/cli/lib/evolution.py:update_doc_scores)
破坏性操作 (实际归档 / L4 gzip / 腐化删除) 不在维护扫内, 由独立 cron 跑:
memory-archive(月 1st 06:00) — archive_pending 落归档/forgotten/memory-compact(周日 04:00) — L4 ledger gzipmemory-warden(1st/15th 05:00) — 腐化检测
CRUD 子命令 (有 verb 时)
verb=read → 解析 URI → 读 frontmatter + brief (详见 crud-operations.md §read)
verb=write → policy 校验 (L0 拒 / L1 weight≥0.8 / L2 dedupe / L3/L4 自动) → 写 frontmatter + body
verb=update→ 解析 → 校验 immutable_after_confirm → 写回, created 不变
verb=delete→ L0 拒 / L1 force-user / L2-L4 archive_pending=true
URI 解析失败 / 路径越界 → 立即拒绝, 不写盘。
CRUD 输入 (仅 verb≠空 时)
- uri:
L<N>://<path>(e.g.L2://semantic/go/goroutine) - write/update 需: content (markdown body),
--level,--weight(0.0-1.0),--recall_when(string),--ref(知识库路径),--parents,--children - 可选:
--full(read 时返回完整 full 字段, 默认仅 brief)
输出
维护模式 (默认)
{
"mode": "maintain",
"indexed": <N>, "invalid_frontmatter": <N>, "duplicate_uri": <N>,
"promote_candidates_L3_to_L2": <N>, "promote_candidates_L2_to_L1": <N>, "promote_candidates_L1_to_L0": <N>,
"auto_promoted_L4_to_L3": <N>,
"enriched": <N>,
"forget_marked_L2": <N>, "forget_marked_L3": <N>,
"scores_updated": <N>
}
CRUD 模式
{"ok": true, "mode": "<verb>", "uri": "<u>", "data": {...}}
AUTO_MODE (wrapper / cron 传 auto 后缀触发)
- 跳 AskUserQuestion, 按 policy 默认值跳过用户决策处
- persistent: error 自决降级 / 重试, 禁询问, 禁中止
- 特殊拒绝:
- L0 write/delete → 一律拒, 输出候选清单, 提示
~/.cortex/scripts/memory.sh <verb> <uri> --interactive - L1 delete → 一律拒 (同上)
- L0 write/delete → 一律拒, 输出候选清单, 提示
References (按需加载)
| 文件 | 用途 |
|---|---|
| references/crud-operations.md | CRUD 4 verb 详细流程 + URI 解析 + frontmatter 自动填 + 错误处理 |
| references/forget.md | forget 标记子流程 (维护阶段 4 详细; daily cron / /cortex:forget 触发等价) |
| references/scoring.md | importance / confidence 2 评分字段强制 (lint rule 23) + 启发式 + 衰减规则 |
Related Skills
lazygophers/golang-db
development
VerifiedTrustedCommunity
Go 数据库规范——GORM Model 命名 ModelXxx、表名单数、枚举 uint8 + 常量、索引 idx_ 前缀 + deleted_at leading column、禁 time.Time 统一 int64 unix、禁指针/nullable 字段、TEXT/BLOB/JSON 禁 default、AutoMigrate 禁改主键。设计 DB model、写 GORM tag、建索引、做 migration 审查时触发。
4SKILL.mdUpdated Jun 5, 2026
lazygophers/golang-api
development
VerifiedTrustedCommunity
Go HTTP API 规范——响应始终 200 + body code 字段、路由 /api/* 全 POST 单段 <Action><Model>、中间件逐路由注册禁 Group(prefix,mw...)、handler 仅返回 (rsp,error)、认证走 header。设计 HTTP API、写路由/handler/中间件时触发。
4SKILL.mdUpdated Jun 5, 2026
lazygophers/golang-structure
development
VerifiedTrustedCommunity
Go 项目结构规范——三层架构（API → Impl → State）、全局状态模式、internal/ 私有包、cmd/ 仅 main.go、go.work 多模块、禁止 Repository 接口和 DI 容器、struct 公共字段开头全 omitempty、handler var rsp 顶声明、禁 legacy migration。设计项目骨架、新建目录、组织包、做架构评审时触发。
4SKILL.mdUpdated Apr 24, 2026
lazygophers/golang-naming
development
VerifiedTrustedCommunity
Go 命名规范——Id/Uid 字段（非 ID）、IsActive/HasMFA 布尔前缀、CreatedAt 时间字段、接收者统一用 p、包名全小写无下划线、泛型类型参数描述性命名、集合字段 xxx_list 禁 xxxs 复数、Enum 0 值 XxxNil 禁 Unknown、禁 Status 统一 State、Set/Update 语义区分。定义结构体字段、函数、变量、包、接收者名、泛型、枚举时触发。
4SKILL.mdUpdated Apr 24, 2026