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/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