plugins/tools/cortex/skills/cortex-lint/SKILL.md
lint / 校验 / 体检 / audit / 死链 / 孤儿 / 规范化 / frontmatter — cortex 知识库与记忆树的合规检查与可逆 autofix。覆盖 wikilink 死链、frontmatter 缺字段、命名违规、目录同构、孤儿页、等级语义反写、脚本目录用途混淆等 7 类规则。默认 --fix 落盘修复;--check opt-in 仅预览。
npx skillsauth add lazygophers/ccplugin cortex-lintInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
cortex vault 的 7 类合规检查与可逆 autofix。默认 --fix 落盘修复;--check opt-in 仅预览。
破坏性提示:默认
--fix会改 vault (autofix R2/R4 等可修项);只想看违规不落盘时显式传--check。
本段由 context: fork 派 cortex-lint-worker 后台跑:默认 --fix 跑 7 规则扫描 + autofix 落盘,产出修复报告。
plugins/tools/cortex/scripts/lint.sh [--rules R1,R2,...] [--target <dir>]
默认 --fix + 全规则;--target 默认 $HOME/.cortex;退出 0=全部 error 已修/无 error,非 0=fix 失败。worker 默认直接落盘 autofix (R2/R4 可修项),把修复/残留清单 (规则 ID / 文件 / 级别 error|warn / 是否已修) 作为报告返回主会话。
仅预览 (不落盘) 时显式传 --check:
plugins/tools/cortex/scripts/lint.sh --check [--rules R1,R2,...] [--target <dir>]
| ID | 规则 | 级别 | autofix | | --- | --- | --- | --- | | R1 | wikilink 死链 | warn | 否 | | R2 | frontmatter 必备字段 | error | 是 (按路径推断) | | R3 | 命名 (领域 ≥2 级, 脚本 kebab) | warn | 否 | | R4 | 同构 (memory L0-L4 + 三模块齐全) | error | 是 (mkdir) | | R5 | 孤儿页 (无反链 + mtime>30d) | warn | 否 | | R6 | 等级语义一致 (路径↔level) | error | 否 | | R7 | 脚本目录用途分离 | warn | 否 |
error 命中即非零退出且机器可修;warn 仅打印。
| 任务 | 文件 |
| --- | --- |
| 查 7 规则具体定义 / 检测策略 | references/rules.md |
| 查 R2 推断 / R4 mkdir / lint.sh + _lint/ 实现 | references/fixers.md |
| 查 stdout/stderr 格式 + fixture + 验证命令 | references/output.md |
cortex-schema (顶层 + 三模块 + 5 级)cortex-schemacortex-schemacortex-extracttools
UI/UX 与布局设计——做界面布局/结构/导航/组件/交互的设计决策。触发:做UI/UX/布局/排版/导航/组件/交互/栅格/响应式/图表选型/字体配对。按媒介路由 HTML/Web、原生 App(iOS/Android/桌面)、CLI、TUI。需后端动态系统不适用;配色/主题/色板走姊妹 skill design-color。
tools
主题与配色设计——做颜色搭配/调色板/主题/品牌色阶/暗模式的设计决策。触发:选配色/调色/主题/色板/品牌色/暗模式/对比度/色盲/UI风格。按媒介路由 HTML/Web(CSS变量)、原生App(平台token)、CLI(ANSI)、TUI(真彩/256/16降级)。保证可访问性(对比度/色盲安全)。需后端动态系统不适用;UI/UX 布局/组件/交互走姊妹 skill design-uiux。
tools
跨任意组件(plugin/skill/agent/command)的验证驱动优化循环纪律 skill。当用户要优化某个已有组件却无明确方向、或要防止改了反而更差(自评乐观偏差 / 多维同改归因失效 / 为凑分加废话膨胀)、或要把一套通用「评分→单变量改→改后验证严格更好才留否则回滚→触顶停」的纪律套到任意组件上时使用。管优化过程本身的纪律(validation gate / ratchet / 独立验证 / 触顶停),不评单组件深度(交 skill-dev),不查插件接线(交 plugin-dev)。仅手动 /optimize-any 触发。
data-ai
两层规则记忆 (基于 .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 全自动修, 断链只报告)。