lazygophers/plugins/tools/cortex/skills/cortex-save
plugins/tools/cortex/skills/cortex-save/SKILL.md
--- name: cortex-save description: 落档非平凡发现到 vault — 选目录 (项目/领域/日记/收件箱), 套模板, 塞 frontmatter (4 评分字段), 注 block-id, 反向 wikilink 回填, 同步 index/hot。触发: "save this" / "归档" / "落档" / "save 笔记"。 allowed-tools: Bash Read Write Edit Glob mcp__obsidian__obsidian_get_file_contents mcp__obsidian__obsidian_append_content mcp__obsidian__obsidian_patch_content mcp__obsidian__obsidian_simple_search --- # cortex-save 把"值得留下的东西"写进 Obsidian vault, 让未来会话能搜到。 ## 调用优先级 (P1) 1. **优先 CLI**: `bash ~/.cortex/scripts/sav
$ install --global
skillsauthnpx skillsauth add lazygophers/ccplugin plugins/tools/cortex/skills/cortex-saveInstall 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:29 AM145.2s4 files scanned
SKILL.md
- name:
- cortex-save
- description:
- 落档非平凡发现到 vault — 选目录 (项目/领域/日记/收件箱), 套模板, 塞 frontmatter (4 评分字段), 注 block-id, 反向 wikilink 回填, 同步 index/hot。触发: "save this" / "归档" / "落档" / "save 笔记"。
- allowed-tools:
- Bash Read Write Edit Glob mcp__obsidian__obsidian_get_file_contents mcp__obsidian__obsidian_append_content mcp__obsidian__obsidian_patch_content mcp__obsidian__obsidian_simple_search
cortex-save
把"值得留下的东西"写进 Obsidian vault, 让未来会话能搜到。
调用优先级 (P1)
- 优先 CLI:
bash ~/.cortex/scripts/save.sh --kind <k> --title <t> --body <b> [--tags ...] [--source-url ...]— 自动跑 masking + frontmatter + block-id + flock + hot/index patch, 结构化返{path, block_ids, hits}(stdout JSON) - 回退: L1 obsidian CLI / L2 mcp__obsidian / L3 Write — CLI 不可达时
触发场景
- 用户显式 "save this" / "落档" / "归档" /
/cortex:save - Stop / SubagentStop hook 启发式触发后回到主线让 skill 完成精修
- 当前讨论沉淀出 1-2 个明确概念 / 决策 / 实体 / 资源, 主 agent 主动调
关键决策树
- 解析 vault →
<PLUGIN_ROOT>/scripts/hooks/_lib/resolve_vault.sh; 失败提示配置后退出 - 判 type: 用户给
--topic→concept;--from-session或无参 →log; 项目内事 →domain - 选目录 — 按 type 路由表 (concept/entity/project/source/reflection/journal/...) + 文件名 lang 对齐 (rule 20 path-lang-mismatch); 详见 references/path-routing.md
- 套模板 + 填 frontmatter —
<vault>/_templates/<type>.md或 plugin presets fallback; 替换{{TITLE}}/{{CREATED}}/{{UPDATED}}; 强制 4 评分字段 (score/confidence/source_credibility/maturity), 详见 references/scoring-frontmatter.md - block-id 注入 — H2/H3 段末追
^cortex-<sha8>; sha8 = sha256(rel-path::UTC-iso::section-index::heading)[:8] - 写入 — P0 masking 前置 → L1 mcp__obsidian (优先) → L2 obsidian CLI → L3 Write 兜底; 详见 references/save-flow.md
- 更新索引 + backlink — index.md type 章节 / hot.md 顶部 / log/_index.md (log 类) + 跑
backlink_sync.py反向回填 - 输出 — 绝对路径 + 相对路径 +
obsidian://URI + backlinks 命中数 + 待补 wikilink 数
AUTO_MODE (wrapper / cron 传 auto 后缀)
- 不调 AskUserQuestion (wrapper allowed-tools 已禁)
- body 经 masking 后直接写盘, 不询问
- 默认
kind=log(未提供时), 默认 6 域路由走领域/未分类/ - persistent: save 失败 → 重试 / 换 save.sh 参数 / 写 cache 兜底, 禁询问禁中止
- 写盘不需二次确认
References
| 文件 | 内容 | |---|---| | references/path-routing.md | type → 目录路由表 + 6 域自决 + 文件名 lang 对齐 + path_lang_exempt | | references/save-flow.md | P0 masking + L1/L2/L3 写入策略 + obsidian-git 协调 + save_session.py 快捷调用 | | references/scoring-frontmatter.md | 4 评分字段 (知识库) + 2 评分字段 (记忆) + frontmatter schema + CLI override |
不做
- 不
git commit/git push(与 OGit 冲突) - 不删 / 改用户已有内容 (仅追加章节)
- 不解析 canvas (.canvas) / bases (.base)
错误处理
| 失败 | 行为 | |---|---| | vault 未解析 | 立即退出, 给配置示例 | | 模板缺失 | 退出, 提示重装 cortex | | MCP 不可用 | 回退 Write | | save_session.py 退出码 1 | stderr 输出后退出 (AUTO_MODE) / AskUserQuestion (Interactive) | | 反向 wikilink 失败 | 仅警告, 主文件保留 |
Related Skills
lazygophers/design-uiux
tools
VerifiedTrustedCommunity
UI/UX 与布局设计——做界面布局/结构/导航/组件/交互的设计决策。触发：做UI/UX/布局/排版/导航/组件/交互/栅格/响应式/图表选型/字体配对。按媒介路由 HTML/Web、原生 App(iOS/Android/桌面)、CLI、TUI。需后端动态系统不适用；配色/主题/色板走姊妹 skill design-color。
4SKILL.mdUpdated Jul 22, 2026
lazygophers/design-color
tools
VerifiedTrustedCommunity
主题与配色设计——做颜色搭配/调色板/主题/品牌色阶/暗模式的设计决策。触发：选配色/调色/主题/色板/品牌色/暗模式/对比度/色盲/UI风格。按媒介路由 HTML/Web(CSS变量)、原生App(平台token)、CLI(ANSI)、TUI(真彩/256/16降级)。保证可访问性（对比度/色盲安全）。需后端动态系统不适用；UI/UX 布局/组件/交互走姊妹 skill design-uiux。
4SKILL.mdUpdated Jul 22, 2026
lazygophers/optimize-any
tools
VerifiedTrustedCommunity
跨任意组件（plugin/skill/agent/command）的验证驱动优化循环纪律 skill。当用户要优化某个已有组件却无明确方向、或要防止改了反而更差（自评乐观偏差 / 多维同改归因失效 / 为凑分加废话膨胀）、或要把一套通用「评分→单变量改→改后验证严格更好才留否则回滚→触顶停」的纪律套到任意组件上时使用。管优化过程本身的纪律（validation gate / ratchet / 独立验证 / 触顶停），不评单组件深度（交 skill-dev），不查插件接线（交 plugin-dev）。仅手动 /optimize-any 触发。
4SKILL.mdUpdated Jul 18, 2026
lazygophers/skein-spec
data-ai
VerifiedTrustedCommunity
两层规则记忆 (基于 .skein/spec)。planning 时 recall 召回相关规则、task finish 后 sediment 沉淀学习 + prune 自动精简过期/重复/断链规则。core 常驻硬规 + recall 按需召回, 经判定门自动写盘 (不逐次问用户)。产出 .skein/spec 下 core/recall 规则文件 + index。另支持空仓 bootstrap 播种规则基线、记忆大面积失效 (大重构/换栈) 时 reconstruct 可逆归档后按项目类型分型重建、maintain 手动体检 (超预算/stale/断链/重复/废弃, --apply 自动修复)、auto-fix (Stop hook 写 .pending-fix 标记 → main 派 skein-specer bg 跑 maintain --apply 全自动修, 断链只报告)。
4SKILL.mdUpdated Jul 18, 2026