lazygophers/plugins/tools/cortex/skills/cortex-install
plugins/tools/cortex/skills/cortex-install/SKILL.md
--- name: cortex-install description: 初始化 vault — 双 namespace (知识库 + 记忆 L0-L4) + 仪表盘 + 归档 + 9 cron 注册。lang 询问 (zh-CN/en/ja)。触发: "init vault" / "安装 cortex" / "初始化 vault" / "cortex 装机"。 disable-model-invocation: true allowed-tools: Bash Read Write Edit Glob AskUserQuestion mcp__obsidian__obsidian_list_files_in_vault mcp__obsidian__obsidian_list_files_in_dir mcp__obsidian__obsidian_get_file_contents mcp__obsidian__obsidian_append_content --- # cortex-install 把一个 (新或既有) Obsidian vault 初始化为 cortex
$ install --global
skillsauthnpx skillsauth add lazygophers/ccplugin plugins/tools/cortex/skills/cortex-installInstall 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 23, 2026, 8:46 AM174.2s1 file scanned
SKILL.md
- name:
- cortex-install
- description:
- 初始化 vault — 双 namespace (知识库 + 记忆 L0-L4) + 仪表盘 + 归档 + 9 cron 注册。lang 询问 (zh-CN/en/ja)。触发: "init vault" / "安装 cortex" / "初始化 vault" / "cortex 装机"。
- disable-model-invocation:
- true
- allowed-tools:
- Bash Read Write Edit Glob AskUserQuestion mcp__obsidian__obsidian_list_files_in_vault mcp__obsidian__obsidian_list_files_in_dir mcp__obsidian__obsidian_get_file_contents mcp__obsidian__obsidian_append_content
cortex-install
把一个 (新或既有) Obsidian vault 初始化为 cortex 标准布局 — 双 namespace (知识库 + 记忆 L0-L4) + 仪表盘 + 归档 + HTML 片段库 + 可选 9 cron jobs。
触发场景
- 用户初次安装 cortex, 把空 vault 起骨架
- 已有 vault 需补
_meta//_templates// 新结构
关键决策树
- 解析 vault — 跑
<PLUGIN_ROOT>/scripts/hooks/_lib/resolve_vault.sh; 失败则提示配置OBSIDIAN_VAULTenv 或~/.cortex/config.json - 询问 lang —
AskUserQuestion: 默认zh-CN, 可选en/ja; 写_meta/version.json:.lang - 写共享根 + 业务结构 —
_meta/元数据 +_templates/(36 模板) +index.md/hot.md+ 双 namespace 子目录 + 44 seed_files +.cortex/骨架 (state + config); 详见 references/install-flow.md - git auto-sync 询问 (vault 是 git repo 时) —
AskUserQuestion三选: 关 / 仅 commit / commit+push, 写_meta/version.json:auto_commit,auto_push - 9 cron 询问 —
AskUserQuestion多选要注册的 job + 平台 (launchd/cron/GHA/不启用), 详见 references/cron-setup.md - wrapper 安装 — 跑
scripts/install_wrappers.sh生成 24 个~/.cortex/scripts/*.sh; 详见 references/update-config.md - 回报 — 列已创建/已存在/跳过的文件, 提示跑
/cortex:doctor验证
AUTO_MODE (wrapper / cron 传 auto 后缀)
- 不调 AskUserQuestion (wrapper allowed-tools 已禁); 强行调用必失败
- 默认决策:
lang=zh-CN,git auto-sync=off,cron=off(用户后续手动跑~/.cortex/scripts/install_cron.sh) - persistent: 任何 IO error 自决降级 / 重试 / 换工具, 禁询问禁中止
- 写盘前不需二次确认 (AUTO_MODE 隐含已授权)
- 单文件已存在 → skipped, 继续下一项
写入策略
- 不覆盖已有文件 — 用
Glob或mcp__obsidian__obsidian_get_file_contents检查, 存在则(skipped) - 优先
mcp__obsidian__obsidian_append_content(vault 索引一致); MCP 不可用回退Write - 模板
{{TITLE}}/{{CREATED}}/{{UPDATED}}占位不替换 — 留给 cortex-save / memory skill - 单文件失败不中断, 末尾汇总
References
| 文件 | 内容 | |---|---| | references/install-flow.md | 顶层结构 / 知识库 4 子目录 / 记忆 L0-L4 / 36 模板 / 44 seed_files 完整清单 | | references/cron-setup.md | 9 cron job 调度表 + 3 平台后端 (launchd/cron/GHA) + PLUGIN_ROOT 解析 | | references/update-config.md | 27 wrapper 分组 + 卸载提示 + 输出格式样本 + 错误处理 |
错误处理
- 单文件 IO/权限错: 标 ❌, 继续, 末尾汇总
- vault 路径解析失败: 立即退出, 提示配置方式
- 模板源缺失 (插件文件丢): 退出, 提示重装 cortex
_meta/memory-policy.yaml源缺失: 警告跳过, 提示手动复制
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